skill-forge

skill-forge

技能中的技能，为技能而生。创建新技能、改进现有技能，并从聊天记录中挖掘下一步该构建什么。

何时调用

有三种模式。根据用户的表述选择。

模式	触发语句	功能
forge	“skill-forge 一个能做 X 的东西”、“forge 一个能……的技能”、“给我构建一个用于……的技能”	提出 2-3 个澄清问题，根据模板搭建 ~/.claude/skills/<name>/SKILL.md，并向 mphinance/alpha-skills 发起 PR。
audit	“skill-forge audit”、“skill audit”、“/skill-forge”、“我应该构建哪些技能”	在 ~/.claude/projects/**/*.jsonl 上运行挖掘器，展示 reports/latest.md，询问要创建或改进哪些候选项。
refine	“改进我的技能”、“skill-forge refine ”、“改进 技能”	提出仅增补的更改（新的触发语句、新示例、新章节），应用于现有技能。通过带差异的 PR 提交。

流程

forge 模式

1. 最多向用户提 2-3 个问题：技能名称（kebab-case）、一句话用途、主要触发语句。不要过度询问。
2. 运行脚手架。

   python scripts/forge_new.py --name <name> --brief "<one-sentence purpose>"
   

   脚手架读取 templates/SKILL.md.tmpl，并替换 {{name}}、{{description}}、{{title}}、{{when_to_invoke}}、{{flow}}、{{hard_rules}}。
3. 打开刚写入的 ~/.claude/skills/<name>/SKILL.md，与用户一起审阅。必要时精简文案。
4. 发布。

   python scripts/publish.py <name>
   

   如果 mphinance/alpha-skills 不存在于 ~/.cache/skill-forge/alpha-skills，此操作会将其克隆到该目录，然后创建分支 skill-forge/<name>-<short-ts>、提交、推送并发起 PR，最后打印 PR URL。**到此为止。**由用户审阅并合并。

audit 模式

1. 运行挖掘器。

   python scripts/mine_chats.py --days 30
   

2. 大声读出 reports/latest.md（Markdown 报告）和 reports/latest.json（结构化候选项）。
3. 展示三个部分：新技能候选项、改进候选项、痛点。询问要处理哪些内容。
4. 对每个选定的新技能候选项，使用 publish.py --from-audit 进入 forge 模式，以便 PR 正文引用挖掘到的证据。
5. 对每个选定的改进候选项，进入 refine 模式。

refine 模式

1. 完整阅读目标技能现有的 SKILL.md。不得删除或重构任何内容。
2. 只提出增补内容：frontmatter 描述中的新触发语句、新示例、新的“何时不要使用”条目、新流程步骤。
3. 先将拟议更改写入 proposals/<skill-name>/CHANGES.diff。与用户确认。
4. 将增补编辑应用到 ~/.claude/skills/<skill-name>/SKILL.md。
5. 发布。

   python scripts/publish.py <skill-name>
   

   提交信息以 “Refine skill: ” 开头。PR 正文说明增补内容，并链接挖掘到的证据。

硬性规则

• 绝不自动合并 PR。publish.py 负责发起 PR，由用户合并。绝不运行 gh pr merge。
• **refine 模式下绝不重构现有技能。**只能增补。如果技能需要重写，就创建新的 forge，而不是 refine。
• **改进只能增补。**除纯空白之外，不得删除任何行。publish.py 会在 refine 模式下强制执行此规则。
• **绝不在 skill-forge 自身的会话上递归挖掘。**挖掘器已过滤自引用。不要禁用此过滤。
• **跳过 SSH 转录记录。**项目路径以 ssh- 开头或 cwd 位于 /home/ 下的内容属于远程工作，不予挖掘。
• **不使用 em dash。**使用两侧带空格的 en dash 或逗号。创建的技能中不得使用 emoji。
• **仅使用标准库。**创建的技能和 skill-forge 脚本仅使用 Python 标准库，不安装 pip 包。
• **始终通过 PR 提交。**绝不直接编辑 ~/.cache/skill-forge/alpha-skills/skills/ 中的文件。

调度

审查是适合放进 cron 的部分。有两种选择：

• 首选 – 使用 /schedule 技能。

  /schedule weekly /skill-forge audit
  

  每周运行审查，写入 reports/latest.md，并在下次会话中通知你。

• 仅针对采集器的免费套餐替代方案。 配置 Windows Task Scheduler，在每周触发时运行 python C:\Users\mphan\.claude\skills\skill-forge\scripts\mine_chats.py --days 7。不消耗任何令牌。你想看的时候再阅读 reports/latest.md，然后交互式地调用 skill-forge audit，处理候选项。

Forge 和 refine 模式本质上是交互式的。不要安排它们定时运行。

范围之外

• 自动合并 PR。始终由用户合并。
• 在 refine 模式期间就地编辑 ~/.claude/skills/ 中的技能。始终通过针对 mphinance/alpha-skills 的 PR 进行。
• 从本机以外的设备挖掘对话记录。
• 创建非 Markdown 技能（二进制插件、MCP 服务，以及任何不是由 SKILL.md 和可选脚本组成的内容）。
• 重写或重构现有技能。改进只能以增补方式进行。