Skillforge

SkillForge

> 一句话：给我一个意图，还你一个完整 Skill > 七步元认知：搜→分→叠→展→衡→验→成 > 中文版：原理→PRINCIPLES.md，配方→RECIPES.md > English: Principles→PRINCIPLESen.md, Recipes→RECIPESen.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分钟版） | | PRINCIPLESen.md | Seven Meta-Cognitive Operations（English） | | RECIPESen.md | Five Entry Points（English） |

---

七、生成质量验收（强制执行）

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

验收标准（10项，每项10分，满分100）

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

总分合格线：80/100 **致命项（=80 else '✗ 不通过'} 达标项：{≥8分的项} 需修复：{5-7分的项} 不合格：{<5分的项} 致命项：{0分的项}

### 常见不合格模式（快速自检）

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

---

## 八、版本历史

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

---

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [boshen99](https://github.com/boshen99)
- **Source:** [boshen99/skillforge](https://github.com/boshen99/skillforge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.