skill-pm

skill-pm 是一个多端 AI 技能包管理 CLI，用于把 Git 仓库中的 skills/*/SKILL.md 技能包解析、按全链路能力分类，并通过软链接安装到 GitHub Copilot、Cursor、Claude Code、OpenAI Codex 等工具的约定目录。

面向超级个体，核心是三件事：装好并结构化 → 按意图发现 → 校正与个性化。

特性

• 从 Git 仓库安装技能包
• 自动解析 skills/ 目录下的 SKILL.md
• 按「产品洞察 → 上线运维」全链路中文分类自动打标
• 场景包聚合多分类（如「上线」= 交付 + 安全 + 运维 + 文档）
• find 按关键词或场景检索已安装技能
• 本地可自定义分类体系、场景包与单技能归属
• 支持多目标平台批量安装；默认软链接，卸载可回滚

安装

npm install -g @yan_jun/skill-pm

破坏性变更（0.3.0）： 配置目录与环境变量前缀改为 skill-pm / SKILL_PM_*；旧配置目录与旧软链不再读取，需重新安装技能。

本地开发：

npm install
npm run build   # 编译到 dist/，CLI 入口为 dist/index.js
npm link        # 必须：把 skill-pm 链到全局 PATH，否则会报 command not found
skill-pm --help

未执行 npm link 时，可用下面任一方式代替 skill-pm ...：

npm start -- categories init
node ./dist/index.js categories init
npm run dev -- categories init

常用脚本：

npm run build   # 编译 TypeScript 到 dist/
npm run start   # 运行编译后的 CLI：node ./dist/index.js
npm run dev     # 用 tsx 直接运行源码（无需先 build）
npm run check   # 编译并验证 --help

三条使用场景

1. 装好并结构化

skill-pm add https://github.com/addyosmani/agent-skills.git --yes

安装时会按内置 taxonomy 自动分类，并写入本地索引。

2. 按意图发现

skill-pm find 头脑风暴    # 精确 skill 置顶；若命中场景别名，其余同场景结果跟后
skill-pm find 上线        # 无精确命中时：提示后展示场景【上线】相关
skill-pm list --category review --details
skill-pm list --scene ship --details

find 规则摘要：

1. 精确匹配：slug/name 相等或包含关键词，或 description 前 120 字包含；命中场景时，场景 id/名称/别名也参与精确匹配
2. 同场景相关：仅当关键词直接命中场景 id/名称/别名时展开；已出现在精确区的不重复
3. 两侧皆空则提示未找到

3. 自己写技能

skill-pm new my-skill --scope project   # ./skills/my-skill/SKILL.md
skill-pm new my-skill --scope global    # ~/.config/skill-pm/workspace/skills/...
skill-pm new                            # 交互选择 slug 与落点
skill-pm add ./skills/my-skill --yes    # 单 skill 目录（含 SKILL.md）
skill-pm add ./my-pack --yes            # 含 skills/ 的包根

new 只生成模板，不安装。编辑 SKILL.md 后，用 skill-pm add <本地路径> 或 Git URL 安装到各平台（软链与索引流程相同）。

4. 校正与个性化

skill-pm categories init              # 导出可编辑 taxonomy.json
skill-pm categories set my-cat --name 我的分类 --keywords foo,bar
skill-pm scenes set launch --name 发布夜 --aliases 发版 --categories delivery,ops,docs
skill-pm categorize package/slug --set review,testing
skill-pm categorize package/slug --clear
skill-pm reclassify                   # 改规则后刷新已安装索引

命令

创建技能脚手架

skill-pm new my-skill --scope project
skill-pm new my-skill --scope global
skill-pm new                                    # 交互选择 slug 与落点
skill-pm new my-skill --name "My Skill" --force

new 只生成 skills/<slug>/SKILL.md 模板，不写入安装索引、不创建软链。编辑完成后，通过 skill-pm add <本地路径> 或 <git-url> 安装。

安装技能包

skill-pm add https://github.com/addyosmani/agent-skills.git
skill-pm add https://github.com/addyosmani/agent-skills.git --yes
skill-pm add https://github.com/addyosmani/agent-skills.git \
  --targets cursor,claude-code,codex \
  --skills tdd,performance
skill-pm add ./skills/my-skill --yes    # 本地单 skill 目录
skill-pm add ./my-pack --yes            # 本地包根（含 skills/）

查看 / 检索

skill-pm list
skill-pm list --details
skill-pm list --target cursor
skill-pm list --category 代码审查 --details
skill-pm list --scene 上线 --details
skill-pm find 头脑风暴

更新 / 卸载

skill-pm update
skill-pm update addyosmani-agent-skills
skill-pm update --all
skill-pm remove addyosmani-agent-skills --yes

分类与场景管理

skill-pm categories
skill-pm categories init
skill-pm categories set review --keywords review,pr,代码审查
skill-pm categories remove my-cat
skill-pm scenes
skill-pm scenes set ship --aliases 上线,发布 --categories delivery,security,ops,docs
skill-pm scenes remove my-scene
skill-pm categorize my-pkg/tdd --set testing
skill-pm reclassify

能力分类（内置）

| id | 名称 | | --- | --- | | discovery | 产品洞察与需求 | | planning | 规划与协作 | | design | 设计与体验 | | architecture | 架构与系统设计 | | implementation | 编码实现 | | review | 代码审查 | | testing | 测试与质量 | | debugging | 调试与诊断 | | performance | 性能优化 | | security | 安全与合规 | | docs | 文档与知识 | | vcs | 版本协作 | | delivery | 交付与发布 | | ops | 运维与稳定性 | | meta | Agent 与元技能 | | general | 通用能力（兜底） |

场景包（内置）

| id | 别名示例 | 聚合分类 | | --- | --- | --- | | ideate | 想清楚、头脑风暴 | discovery, planning, design | | build | 动手做、开发 | architecture, implementation, vcs | | quality | 保质量、审查 | review, testing, security | | ship | 上线、发布 | delivery, security, ops, docs | | firefight | 救火、线上问题 | debugging, ops, performance |

配置位置

默认目录：~/.config/skill-pm/（可用环境变量 SKILL_PM_CONFIG_DIR 覆盖）

• config.json：已安装包索引、软链记录、categoryOverrides
• taxonomy.json：自定义分类与场景（categories init 导出）

支持平台

| key | 名称 | 默认目录 | | --- | --- | --- | | copilot-vscode | GitHub Copilot for VS Code | ~/Library/Application Support/Code/User/prompts/skill-pm | | copilot-cli | GitHub Copilot CLI | ~/.config/github-copilot/skills | | cursor | Cursor | ~/.cursor/rules/skill-pm | | claude-code | Claude Code | ~/.claude/skills | | codex | OpenAI Codex | ~/.agents/skills |

可通过环境变量覆盖默认目录：

• SKILL_PM_COPILOT_VSCODE_DIR
• SKILL_PM_COPILOT_CLI_DIR
• SKILL_PM_CURSOR_DIR
• SKILL_PM_CLAUDE_CODE_DIR
• SKILL_PM_CODEX_DIR

技能仓库规范

仓库需要包含：

skills/
  my-skill/
    SKILL.md

推荐 SKILL.md 使用 frontmatter：

---
name: My Skill
description: Helps with focused code review.
tags: [review, quality]
---

可选的 skill-manifest.json：

{
  "supportedPlatforms": ["cursor", "claude-code", "codex"]
}

开发状态

当前版本为 0.4.0，npm 包为 @yan_jun/skill-pm。使用 TypeScript 编写，已实现安装闭环与场景发现（find / 分类 / 场景 / 归属覆盖 / reclassify）。