skill-lens

SKILL.md

Skill Lens (技能透镜)

概述

Skill Lens 是一个面向开发者的深度分析工具。它通过“静态扫描 + 智能推理”的双引擎模式,像透镜一样聚焦于任何 Skill 的核心,帮助你不仅看懂代码,更能掌握其背后的技术原理思维框架

核心能力

1. 架构级技术分析

超越文件列表,深入解析 scripts/

  • 技术栈指纹:自动识别 Python/JS/TS 等语言的核心依赖与运行环境。
  • 工作流溯源:还原代码逻辑流程,并生成 Mermaid 可视化流程图。
  • 性能与安全审计:评估脚本的复杂度及资源占用风险。

2. 知识与内容建模

提炼 Skill 的“领域灵魂”:

  • 实体提取:识别领域核心术语与操作对象。
  • 思维模式识别:破解隐藏在 Prompt 中的思考算法(如 CoT, 第一性原理)。
  • 知识资产化:将复杂的文档转化为结构化的知识图谱。

3. 深度报告模板要求 (必须严格遵守)

报告必须采用以下格式:

[技能名称] 洞察报告

1. 深度洞察摘要 (Executive Summary)

[用简练的语言总结该技能的核心价值与应用场景]

2. 文件清单 (File Manifest)

使用树状结构展示技能组成:

|-- [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: 定义了深度解析的“黄金标准”。
Weekly Installs
5
First Seen
Jan 24, 2026
Installed on
gemini-cli5
cursor5
claude-code4
opencode4
qoder3
github-copilot3