skill-manager

# Skill Manager — 技能系统总管 ## 核心原则 你是技能系统的唯一决策入口。遇到任何能力问题，先来这里。不要自己瞎试，先看清全局再行动。复合任务先拆成独立子能力，每个子能力单独匹配 skill。 ## 第一步：看清全局 ```bash python ~/.claude/skills/skill-manager/scripts/list_skills.py ~/.claude/skills 2>/dev/null ``` > `~/.claude/skills/` 是唯一的全局技能源；`~/.codex/skills` 与 > `~/.agents/skills` 只作为指向它的兼容入口。项目专属技能放在项目的 > `.claude/skills/`，并按需从 `.agents/skills/` 建立项目内软链接。 有匹配的 skill → **路径 A**。没有 → **路径 B**。 --- ## 路径 A：调用现有 skill 读取对应 SKILL.md，按指引执行。完成后走路径 C。 ## 路径 B：获取新能力 这是一条统一的流程，不管"知不知道怎么做"，都从调研开始。调研结果决定用哪个工具。 ### B1. 调研（必做，不要跳过） ``` 搜索："[任务关键词] skill" 或 "[任务] automation tool" 搜索："[平台名] API" 或 "如何自动化 [任务]" ``` 目标：搞清楚有没有现成的东西能用，以及具体怎么做。 ### B2. 根据调研结果选择路径 | 调研发现 | 行动 | 用哪个子系统 | |---------|------|-------------| | skills.sh 商城有现成 skill | 在本 skill 内评估并安装 | Skills CLI | | GitHub 上有个项目能做这件事 | 研究后创建适配版本 | `skill-creator` | | 找到了教程/方法，但没有现成工具 | 基于调研结果从零创建 | `skill-creator` | | 什么都没找到 | 用自己的知识从零创建 | `skill-creator` | **B2a. 商城安装（最便宜）** ```bash npx skills find <关键词> npx skills add <owner/repo@skill> -g -y ``` 安装前必须检查： - 与现有能力是否重复 - 来源、维护活跃度和许可证 - 是否引用未随安装提供的其他 skill、脚本或 MCP - description 是否过宽，会不会常驻占用上下文或误触发 一次给出不超过 3 个候选，说明差异后再选择。安装完成后继续执行原任务。 **B2b. 从 GitHub 或方法创建** 调用 `skill-creator` skill，将调研到的流程写成 SKILL.md： - 具体步骤（URL、按钮、等待元素） - 前置依赖（Playwright MCP？登录？API Key？） - 已知限制和坑 - 上游来源与许可证 - 本地适配点及验证方式 ### B3. 验证 ```bash ls ~/.claude/skills/<技能名>/SKILL.md 2>/dev/null || ls ~/.agents/skills/<技能名>/SKILL.md 2>/dev/null ``` ### B4. 用新 skill 执行原任务 不要停下来汇报安装情况，直接继续干活。完成后走路径 C。 ## 路径 C：进化（任务完成后自动执行） 按 `skill-creator` 的 evolution 流程将本次经验写回 skill。只记有价值的踩坑、用户偏好和优化策略；没有新经验则跳过。 ## 路径 D：更新过时 skill ```bash python ~/.claude/skills/skill-manager/scripts/scan_and_check.py ~/.claude/skills ``` 1. `python scripts/update_helper.py <skill_path>` 备份 2. 拉取新版本 3. 用 `skill-creator/scripts/smart_stitch.py <skill_path>` 恢复经验 ## 子系统索引 | 子系统 | Skill 名 | 何时调用 | |--------|----------|---------| | 商城搜索与安装 | Skills CLI | B2a | | 创建与适配 | `skill-creator` | B2b | | 经验进化 | `skill-creator` | 路径 C | | 环境修复 | `mcp-installer` | 工具缺失错误 | | 深度调研 | `deep-research` | B1（复杂主题时） | | 自愈诊断 | `self-diagnose` | Daemon 执行失败自动触发；手机 `/doctor` 手动触发 | ## Frontmatter 字段规范 扫描/升级 skill 时，确保 frontmatter 包含： - `needs_browser: true` — 需要 Playwright 浏览器自动化的 skill 必须声明此字段，否则手机端会跳过 Playwright 加载（省 ~20s） ## 约束 - 单次最多安装 2 个新技能 - 优先可信且许可清晰的来源 - 已有能力能覆盖时不新增同类 skill - 依赖 MCP 的技能先走 `mcp-installer` 自愈协议 - 商城：https://skills.sh/ - 删除：`python scripts/delete_skill.py <name> ~/.claude/skills`