技能锻造机（Skill-Forge）

§0 快速开始

用户: "我每天要人工对三张报表，检查差异很烦"
锻造机: 五要素拆解 → scaffold → 填充 SKILL.md → safety 扫描 → validate → 交付草稿

§1 核心工作流

1.1 需求结构化（五要素拆解）

用户输入一句话痛点后，Agent 按五要素框架追问补全：

如果用户一次性描述足够清晰，跳过追问直接拆解。

1.2 生成 SKILL.md

Agent 按五要素组织内容，遵循标准模板骨架：

---
name: {slug}
version: 1.0
category: {category}
triggers: [{triggers}]
platforms: [windows, mac, linux]
---

## §0 快速开始
（一句话触发 + 一句话输出）

## §1 核心工作流
（按步骤写，每步有明确输入/输出）

## §2 输入规范
（参数格式、约束）

## §3 输出规范
（格式模板、示例）

## §A 异常处理
（常见错误及处理方式）

## §F 版本
v1.0（日期）· 首次发布

写入文件前使用脚本创建目录和模板：

python skill_forge.py scaffold --name "报表对账" --output-dir <dir> \
  --trigger-1 "对账" --trigger-2 "报表差异" --trigger-3 "检查差异" \
  --category "办公效率"

然后用 Agent 填充模板中所有 [占位符]。

1.3 安全扫描

填充完成后执行：

python skill_forge.py safety --path <SKILL.md 路径>

内置 40+ 条危险模式（rm -rf、format、curl | sh、chmod 777、删除注册表等）。命中时输出行号 + 风险等级，引导用户确认是否为示例用途。

1.4 格式校验

python skill_forge.py validate --path <SKILL.md 路径> [--max-size 5120]

检查项：文件大小 / YAML frontmatter / 必需字段（name, version, category, triggers）/ 必需章节（§0, §1, §A, §F）/ 触发词数量。

1.5 交付

校验全部通过后，向用户呈现最终 SKILL.md 并告知：
- 文件路径
- 审阅建议（"请确认触发词是否覆盖你的使用场景"）
- 下一步（"确认后可手动注册到 SkillHub"）

§2 分类自动判定

§3 自举说明

锻造机自己就是一个用本流程生成的 Skill。它的五要素：

• 触发条件：用户说「造个 skill」「写个技能」等
• 输入：一句话痛点描述
• 核心协议：五要素拆解 → scaffold → 填充 → safety → validate → 交付
• 输出：SKILL.md 草稿文件
• 示例：见 EXTEND.md §S

§A 错误码

§F 版本

v1.0（2026-07-27）· 首次发布 · 自举验证通过
（内容由AI生成，仅供参考）