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 执行记录与未验证项）。

4.0 KiB Raw Permalink Blame History Unescape Escape