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