maxoreric/skill-lifecycle

Skill 生命周期

创建和持续优化 Skill 的完整流程。

流程概览

clarify → research → create → evaluate → iterate(循环) → version

详细步骤

1. clarify（澄清）

目的：理解用户想要什么

执行：调用 clarify-skill

输出：workspace/goal.md

完成标志：用户确认目标

2. research（调研）

目的：了解最佳实践

执行：调用 research-skill

输入：workspace/goal.md

输出：workspace/research.md

完成标志：调研报告完成

可选：如果领域简单或已有经验，可跳过

3. create（创建）

目的：生成 Skill 文件

执行：调用 create-skill

输入：workspace/goal.md、workspace/research.md

输出：

• SKILL.md
• criteria.md

完成标志：两个文件都存在且格式正确

4. evaluate（评价）

目的：评价 Skill 执行效果

前置：先执行一次 Skill，获得产出

执行：调用 evaluate-skill

输入：criteria.md、执行产出

输出：

• .meta/evaluation.json
• workspace/evaluation.md

完成标志：评价结果存在

5. iterate（迭代）- 循环

目的：根据评价改进 Skill

触发条件：evaluation.json.pass == false 或 needs_iteration == true

执行：调用 iterate-skill

输入：evaluation.json、evaluation.md、SKILL.md

输出：

• 更新的 SKILL.md
• versions/SKILL.v{n}.md（旧版本备份）

循环：回到 step 4（evaluate）

退出条件：

• evaluation.json.pass == true 且 needs_iteration == false
• 或达到 max_iterations

6. version（版本管理）- 可选

目的：A/B test 或版本切换

执行：调用 version-skill

场景：

• 有多个版本需要对比
• 需要回滚到之前版本
• 确认某个版本为正式版

状态管理

status.json

{
  "current_step": "evaluate",
  "completed_steps": ["clarify", "research", "create"],
  "iteration": 2,
  "max_iterations": 5,
  "skill_name": "weekly-report"
}

状态流转

clarify → research → create → evaluate
                                 ↓
                         pass? ──→ done
                           ↓ no
                        iterate
                           ↓
                    (back to evaluate)

目录结构

.sop-engine/skills/<skill-name>/
├── SKILL.md              # Skill 本身
├── criteria.md           # 评价标准
├── versions/             # 历史版本
│   ├── SKILL.v1.md
│   └── SKILL.v2.md
├── .meta/                # 元数据（Hook 读取）
│   ├── status.json
│   └── evaluation.json
└── workspace/            # 工作空间（自由）
    ├── goal.md
    ├── research.md
    └── evaluation.md

原则

• 每个步骤完成后更新 status.json
• 循环有上限，防止无限迭代
• 保留历史版本，支持回滚
• workspace 内容自由，.meta 格式严格