Le SPEC
智能需求分析与 SPEC 生成总控：把模糊、零散、矛盾的想法，经真实集成的 Grill 深度访谈、Think 方案挑战、OpenSpec 规格工程，转化为可执行、可测试的正式 SPEC。VibeCoding / AI Coding 工作流的需求工程入口。
状态：rigorous 档 ｜ 正式名称 Le SPEC，技术标识 le-spec ｜ 优先适配 Codex，兼容 ZCode / Claude Code
它解决什么问题
你有一堆没想清楚的想法（甚至互相矛盾），直接丢给 Coding Agent 会得到一堆它自行猜测的「需求」。Le SPEC 在编码之前接管：先访谈把该想清楚的想清楚，再挑战不合理方案，最后产出结构化的 OpenSpec 规格（产品需求 / 技术设计 / 开发任务三分离），让 Coding Agent 不用猜。
架构：真实集成，不是借鉴
| 引擎 | 来源 | 在 Le SPEC 中的职责 | 调用方式 |
|---|---|---|---|
| grilling (+ domain-modeling) | mattpocock/skills | Phase 2 深度访谈：design tree / frontier 轮次 / 推荐答案 | Skill 工具按名调用，或 Read 其原始 SKILL.md 遵循原义；记调用账本 |
| think | tw93/Waza | Phase 3 方案分析：单一推荐、Simplicity Gate、premise collapse | 同上 |
| openspec CLI + skills | Fission-AI/OpenSpec | Phase 5 规格生成（proposal/specs/design/tasks）、validate、变更与归档 | openspec CLI 真实执行（new change / instructions / validate） |
「真实调用」的证据是调用账本（项目内 openspec/le-spec/ledger.jsonl）：每次依赖交互记录 dep/kind/method/cmd/exit。审查与交付阶段核对账本，无账本条目视为未发生。协议细节见 references/dependencies.md。
安装
# 1. 依赖（一次性；skills.sh 落 ~/.agents/skills，软链各 runtime）
npx skills@latest add mattpocock/skills --skill grilling grill-me grill-with-docs domain-modeling -g -a claude-code codex
npx skills@latest add tw93/Waza --skill think -g -a claude-code codex
npx skills@latest add Fission-AI/OpenSpec --skill openspec-propose openspec-new-change openspec-update-change openspec-verify-change openspec-archive-change openspec-apply-change openspec-explore -g -a claude-code codex
npm install -g @fission-ai/openspec@latest
# 2. 本 skill（MetaSkill 仓库真源 + 软链）
ln -sfn <本仓库路径>/skills/le-spec ~/.agents/skills/le-spec
# 3. 验证
python3 ~/.agents/skills/le-spec/scripts/deps_check.py # required 全绿 exit 0
目标项目无需预装 OpenSpec：Phase 5 检测到无根时会征求用户意见再 openspec init。
使用
自然语言直接开始，例如：
- 「帮我把这个想法整理成 spec：我想做一个……」（零散长文也行，直接贴）
- 「先 grill 我一下，把这个功能想透」
- 「需求变了，更新之前那个 spec」
中断随时可恢复：状态存 <项目>/openspec/le-spec/state.md，新会话说「继续上次的 le-spec 分析」即可。产出批准后：实现交给 Coding Agent（openspec-apply-change 工作流），需求变更走 openspec-update-change，完成归档 openspec-archive-change。
工作流（逻辑七阶段，按复杂度自适应压缩）
0 识别分级 → 1 需求结构化(十类分拣) → 2 Grill 访谈(动态轮次·每4轮检查点·收敛即停)
→ 3 Think 挑战(有分歧才进) → 4 反向验收(独立工程师视角找"还得猜什么")
→ 5 OpenSpec 生成(validate 通过) → 6 四视角独立审查 → 7 用户批准(硬停点)
详见 SKILL.md 与 references/。
安全边界
- 未经用户明确批准不进入实现（Phase 7 回合终止硬停点）。
- required 依赖缺失 → 停止并给安装命令，不以模拟调用冒充。
- 不编造业务规则/验收标准；AI 推荐方案标 [建议]，不冒充已批准。
已知限制
见 reports/test-report.md（测试 A-I 执行记录与未验证项）。