--- name: skill-lens description: 专门用于扫描、分析和学习其他 Agent Skill 设计模式的深度分析透镜。它可以透视技术栈原理、思维框架、工作流逻辑,并生成结构化的洞察报告。 --- # Skill Lens (技能透镜) ## 概述 Skill Lens 是一个面向开发者的深度分析工具。它通过“静态扫描 + 智能推理”的双引擎模式,像透镜一样聚焦于任何 Skill 的核心,帮助你不仅看懂代码,更能掌握其背后的**技术原理**和**思维框架**。 ## 核心能力 ### 1. 架构级技术分析 超越文件列表,深入解析 `scripts/`: - **技术栈指纹**:自动识别 Python/JS/TS 等语言的核心依赖与运行环境。 - **工作流溯源**:还原代码逻辑流程,并生成 Mermaid 可视化流程图。 - **性能与安全审计**:评估脚本的复杂度及资源占用风险。 ### 2. 知识与内容建模 提炼 Skill 的“领域灵魂”: - **实体提取**:识别领域核心术语与操作对象。 - **思维模式识别**:破解隐藏在 Prompt 中的思考算法(如 CoT, 第一性原理)。 - **知识资产化**:将复杂的文档转化为结构化的知识图谱。 ### 3. 深度报告模板要求 (必须严格遵守) 报告必须采用以下格式: # [技能名称] 洞察报告 ## 1. 深度洞察摘要 (Executive Summary) [用简练的语言总结该技能的核心价值与应用场景] ## 2. 文件清单 (File Manifest) 使用树状结构展示技能组成: ```plaintext |-- [skill-name] |-- SKILL.md <简要介绍> |-- references/ |-- reference1.md <简要介绍> |-- scripts/ |-- script1.py <脚本用途与核心逻辑> |-- ... ``` ## 3. 技术栈与工作流分析 (Technical & Workflow) - **技术栈**:核心依赖与运行环境。 - **工作流可视化**:使用 Mermaid 流程图展示 Agent 决策链或脚本逻辑。 ## 4. 要点解析 (Key Points) 针对**重要文件**进行逐一深度解析: - **脚本类 (`.py`, `.js` 等)**:解析技术实现细节、算法逻辑及核心函数。 - **文档类 (`.md`)**:洞察其设计思路、思维框架、知识资产,并**必须引用原句作为证据**。 ## 5. 总结 (Conclusion) - **5.1 亮点**:该技能最精妙的设计点。 - **5.2 边界约束**:明确其不适用的场景与硬性限制。 - **5.3 改进建议 (可选)**:针对规范性或性能的优化建议。 --- [说明如何开始使用这个技能] 【开始使用】 可以说:“[具体调用示例]”来使用这个技能 ## 使用工作流 1. **初始化**:指定目标 Skill 路径。 2. **底层扫描**:调用 `scripts/inspect_skill.py` 获取文件结构、依赖项及代码片段等原始数据。 3. **深度推理**:Agent 结合扫描数据,**强制参考** `references/best_practices.md` 中的标准,对代码进行架构分析,对内容进行知识建模。 4. **可视化增强**:针对核心逻辑生成 Mermaid 流程图。 5. **生成深度报告**:输出符合规范的 Markdown 报告。 ## 资源 ### scripts/ - `inspect_skill.py`: 轻量化多语言特征提取脚本。 ### references/ - `best_practices.md`: 定义了深度解析的“黄金标准”。