Skill Forge

AI Skill 工程化设计框架 — 将 SKILL.md 编写从"凭感觉写 prompt"提升为可重复、可验证的工程实践。

是什么

Skill Forge 是一个用于设计和优化 AI Agent Skill（SKILL.md）的框架。它提供：

• 6 大设计原则 — 从 fast-edit 提炼的实战经验
• 6 Phase 生命周期 — 意图采集 → 起草 → 测试 → 评估迭代 → 打包发布 → 自我进化
• 质量门控 — MUST/NICE 分级检查清单 + 3 星评级
• 自我进化机制 — 经验日志 + 晋升/淘汰生命周期

快速开始

安装

# 1. Clone 到本地
git clone git@github.com:includewudi/skill-forge.git ~/.config/opencode/skills/skill-forge

# 2. 或者用软链（如果源码在别的位置）
ln -s /path/to/skill-forge ~/.config/opencode/skills/skill-forge

使用

Skill Forge 本身是一个 OpenCode/Claude Code Skill。安装后，当你在对话中提到以下内容时会自动触发：

• "create a skill" / "写技能" / "技能设计"
• "improve a skill" / "优化技能"
• "skill architecture" / "skill patterns"
• "why isn't my skill triggering"

文件结构

skill-forge/
├── SKILL.md                        # 主文档（决策树 + 核心规则）
├── README.md                       # 本文件
├── LICENSE                         # MIT
├── references/
│   ├── design-patterns.md          # 6 大原则详细案例
│   ├── quality-checklist.md        # 发布前检查清单
│   ├── publishing.md               # 打包发布规范
│   └── evolution-log.md            # 进化日志
├── agents/
│   └── skill-reviewer.md           # Skill 审查 Agent 指令
└── trigger_eval.json               # 触发评估测试用例

设计原则概览

#	原则	一句话
1	决策树路由	用户打开 Skill 5 秒内知道该做什么
2	渐进式披露	信息量与需求成正比，不需要时不出现
3	CLI 工具委托	确定性逻辑交给脚本，AI 只管意图
4	验证闭环	每个动作都有验证步骤
5	Token 压缩	表格代替段落，决策树代替列表
6	边界情况表格化	危险模式用查找表，不用散文

相关项目

• Claude Code Skills 官方文档 — Skills 开发规范和 YAML frontmatter 参考
• skill-creator (Anthropic 官方) — 官方 Skill 评估基础设施（触发率、质量评分、方差分析）
• fast-edit — 大文件编辑工具（设计原则的灵感来源）

License

MIT