68 lines
4.0 KiB
Markdown
68 lines
4.0 KiB
Markdown
# 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](https://github.com/mattpocock/skills) | Phase 2 深度访谈：design tree / frontier 轮次 / 推荐答案 | Skill 工具按名调用，或 Read 其原始 SKILL.md 遵循原义；记调用账本 |
|
||
| think | [tw93/Waza](https://github.com/tw93/Waza) | Phase 3 方案分析：单一推荐、Simplicity Gate、premise collapse | 同上 |
|
||
| openspec CLI + skills | [Fission-AI/OpenSpec](https://github.com/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](references/dependencies.md)。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
# 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](SKILL.md) 与 [references/](references/)。
|
||
|
||
## 安全边界
|
||
|
||
- 未经用户明确批准不进入实现（Phase 7 回合终止硬停点）。
|
||
- required 依赖缺失 → 停止并给安装命令，不以模拟调用冒充。
|
||
- 不编造业务规则/验收标准；AI 推荐方案标 [建议]，不冒充已批准。
|
||
|
||
## 已知限制
|
||
|
||
见 [reports/test-report.md](reports/test-report.md)（测试 A-I 执行记录与未验证项）。
|