agentleFS
boshen99boshen99/skillforge/SKILL.md

skillforge

Skill4 starsChanged 3 months agoMITView on GitHub

Skill生成工厂 — 从任意意图,通过七步元认知(搜/分/叠/展/衡/验/成),推导出完整 Skill 架构。

9 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

SkillForge

一句话:给我一个意图,还你一个完整 Skill 七步元认知:搜→分→叠→展→衡→验→成 中文版:原理→PRINCIPLES.md,配方→RECIPES.md English: Principles→PRINCIPLES_en.md, Recipes→RECIPES_en.md


触发条件

当说出以下类型的意图时,进入七步推导:
  "我想做一个xxx"
  "能不能加一个xxx功能"
  "xxx应该怎么做"

Step 0(第零步)永远先走:
  搜"[你的意图] + Claude Skill" / "xxx workflow" / "xxx AI automation"
  搜到了 → 学习它的工具/流程/异常/阈值,再推导
  没搜到 → 确认空白,从零推导

七步推导总览

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
步骤   操作   问什么问题           输出什么
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
0      搜     网上有没有类似的?   学习工具/流程/异常/阈值
1      分     AI最容易做什么过头?  阴阳(做/不做)
2      叠     需要什么家伙?       四力(工具/任务/判断/门控)
3      展     这个Skill在哪?      八卦(输入/输出/边界/流向等)
4      衡     传导链断了吗?       五行(金→木→火→水→土)
5      验     有没有断点?         回头补(补到不断为止)
6      成     推导完成了吗?        完整Skill ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

快速推导(5分钟版)

第零步:搜(1分钟)
  搜"_____ Claude skill" / "_____ workflow" / "_____ AI automation"
  搜到了?→ 学它的工具/流程/异常/阈值
  没搜到?→ 确认空白,从零推导

第一步:分阴阳(1分钟)
  AI最容易在___上做过头 → ✗ 禁止1
  ___属于上游/下游范围  → ✗ 禁止2
  ___必须留给人类判断   → ✗ 禁止3
  阳面:这个Skill要___   → 做1/做2/做3

第二步:叠四力(1分钟)
  太阳(工具):___(工具)___(工具)___(工具)
  少阳(任务):Step1 → Step2 → Step3
  少阴(判断):判断1:___?  判断2:___?
  太阴(门控):□ 完成标准1  □ 完成标准2

第三步:展八卦(1分钟,最少3个)
  乾(输入):___     坤(输出):___
  艮(边界):___     巽(流向):___

第四步:衡五行(30秒)
  金→木→火→水→土 哪一环断了?→ 回头补

第五步:验(30秒)
  木(方向):扩展预设是否已定义?
  火(判断):判断依据是否充分?判断是否过度僵化/松散?
  土(沉淀):产出是否有冗余?
  金(结构):边界是否过度僵化/松散?
  水(流动):流动是否阻塞/过度发散?

第六步:成 ✓
  分✓ 叠✓ 展✓ 衡✓ 验✓ 成✓

质量检查(收口用)

□ 搜:搜过现有 Skill(搜了/没搜到/确认空白)
□ 分:禁止 >= 3 条
□ 叠:工具有 3-10 个,任务有序,判断有量化阈值
□ 展:至少填了乾(输入)+ 坤(输出)+ 艮(边界)
□ 衡:金→木→火→水→土 传导链不断
□ 验:木/火/土/金/水 五力各问过了,没有明显失衡
□ 成:分✓ 叠✓ 展✓ 衡✓ 验✓ 成✓
□ 扩展预设:扩展方向 + 扩展规则 + 扩展门控都有

配套文件

文件用途
PRINCIPLES.md七步元认知详解 + 推导规则 + 完整实例
RECIPES.md五种快捷入口(5分钟版)
PRINCIPLES_en.mdSeven Meta-Cognitive Operations(English)
RECIPES_en.mdFive Entry Points(English)

七、生成质量验收(强制执行)

skillforge 生成的 SKILL.md 必须通过以下质量验收,否则必须返工。

验收标准(10项,每项10分,满分100)

#维度评审问题合格线
1技能边界是否明确写了「做什么」和「不做什么」?禁止行为是否具体可执行?≥8
2术语定义所有专业词汇是否在前3节定义?是否有歧义词?≥8
3输入输出JSON格式/数据路径/数据类型是否明确给出?≥8
4Pipeline 可执行性步骤是否有编号?阈值是否量化(非"适当""合理")?≥8
5质量门控告警触发条件是否明确?是否区分致命/严重/警告?≥8
6Skill 关系上下游 Skill 是否标注?调用关系是否写明?≥7
7禁止行为是否覆盖 AI 最容易越界的场景(如改上游原始输入、替下游填结论)?≥8
8JSON 输出格式是否给出具体 JSON 结构示例(非伪代码)?≥7
9版本历史是否有版本变更记录?格式是否规范?≥6
10可读性是否无空洞形容词("赋能""抓手"等)?是否无歧义表达?≥7

总分合格线:80/100 致命项(<5分的项):必须修复 任何一项为0分:该 SKILL.md 不合格,禁止交付

验收执行流程

生成 SKILL.md 后,自动执行以下验收:

Step 1: 逐项打分
  对照10项标准,每项给出0-10分
  标记<5分的项为"必须修复"
  标记0分的项为"致命不合格"

Step 2: 计算总分
  总分 = 10项得分之和
  总分 < 80 → 不合格,返工
  总分 ≥ 80 → 合格,进入 Step 3

Step 3: 输出验收报告
  格式:
  [skillforge 验收]
  {skill_name} — {总分}/100 {'✓ 通过' if总分>=80 else '✗ 不通过'}
    达标项:{≥8分的项}
    需修复:{5-7分的项}
    不合格:{<5分的项}
    致命项:{0分的项}

常见不合格模式(快速自检)

✗ 致命:缺少禁止行为清单
✗ 致命:输入输出用"按规范输出"代替具体格式
✗ 致命:阈值写"适当""合理"而非具体数值
✗ 严重:技能边界写"负责X相关工作"(太模糊)
✗ 严重:与其他 Skill 关系写"调用相关 Skill"(未指明是哪个)
✗ 严重:版本历史只写"更新"无具体变更内容

八、版本历史

版本日期变更
v5.52026-04-22新增第七步:生成质量验收(10项标准、验收流程、不合格模式清单),确保生成即合规
v5.42026-04-09快速推导:验步骤改为五行标签格式;SKILL.md 自相矛盾(步骤数)统一为七步;成步骤"够了吗?"改为"推导完成了吗?"
v5.32026-04-08PRINCIPLES_en.md 英文版完整重写对齐 v5.3(七步+Step0);SKILL.md 自相矛盾修复
v5.22026-04-08新增扩展预设:推导时预设扩展方向+扩展规则+扩展门控
v5.12026-04-08新增第零步:搜,推导前先联网调研现有 Skills

本文档由 skillforge 提供 — 给你元认知,不给你规则库

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.