Intent Review
交互式 Section 级别的 Intent 审批工具。
核心概念
Intent 文档按 Section 粒度审批，三种状态：
| 状态 | 标记 | 含义 | Agent 行为 |
|---|---|---|---|
| LOCKED | ::: locked | 核心架构，修改需 human 明确同意 | 暂停，请求确认 |
| REVIEWED | ::: reviewed | 已审阅，可修改但需通知 | 允许，事后通知 |
| DRAFT | ::: draft | 草稿，可自由迭代 | 自由修改 |
工作流程
/intent-review [path]
↓
┌───────────────────┐
│ 解析 Intent 文件 │
│ 识别所有 Section │
└─────────┬─────────┘
↓
┌───────────────────┐
│ 展示状态概览 │
│ N locked │
│ M reviewed │
│ K draft/unmarked │
└─────────┬─────────┘
↓
┌───────────────────────────────────────┐
│ 逐个未标记 Section 询问 │
│ │
│ AskUserQuestion: │
│ "Section: [标题]" │
│ 选项: │
│ - Lock (核心架构) │
│ - Review (确认接受) │
│ - Skip (保持 draft) │
└─────────┬─────────────────────────────┘
↓
┌───────────────────┐
│ 更新文件 │
│ 添加标记和属性 │
└───────────────────┘使用方法
审批指定文件
/intent-review src/core/intent/INTENT.md审批当前模块
cd src/chambers/terminal
/intent-review自动查找 intent/INTENT.md
批量审批
/intent-review --all扫描项目所有 intent 文件
执行步骤
1. 定位 Intent 文件
// 优先级：
// 1. 用户指定路径
// 2. 当前目录下 intent/INTENT.md
// 3. 当前目录下 INTENT.md2. 解析 Section
识别两种 Section：
已标记的：
::: locked
## 模块边界
...
:::未标记的（普通 markdown heading）：
## API 设计
...3. 展示概览
Intent Review: src/core/intent/INTENT.md
状态概览：
├── 🔒 LOCKED: 2 sections
│ ├── 模块边界规则
│ └── 数据结构
├── ✓ REVIEWED: 3 sections
│ ├── API 签名 (by robert, 2026-01-19)
│ ├── 配置格式
│ └── 错误处理
└── 📝 UNMARKED: 4 sections
├── 实现建议
├── 性能考虑
├── 示例代码
└── 变更记录
是否开始审批未标记的 sections？4. 逐个审批
对每个未标记 Section 使用 AskUserQuestion：
使用 AskUserQuestion:
- question: "Section: API 签名\n\n内容预览：定义了 create(), delete(), list() 三个函数..."
- header: "审批状态"
- options:
- label: "Lock (核心架构)"
description: "锁定此 section，修改需要 human 明确同意"
- label: "Review (确认接受)"
description: "标记为已审阅，Agent 可修改但需通知"
- label: "Skip (保持 draft)"
description: "暂不审批，保持草稿状态"5. 更新文件
根据用户选择，在 markdown 中添加标记：
Lock 选择：
::: locked {reason="核心架构"}
## API 签名
...
:::Review 选择：
::: reviewed {by=<username> date=<today>}
## API 签名
...
:::Skip 选择： 不修改，或添加：
::: draft
## 实现建议
...
:::特殊场景
检测 LOCKED Section 被修改
当文件有未提交的修改时：
⚠️ 检测到 LOCKED section 被修改：
- Section: 模块边界规则
- 修改内容: [diff preview]
此修改需要 human 明确同意。是否接受？查看审批历史
/intent-review --history src/core/intent/INTENT.md输出：
Section: API 签名
├── 2026-01-19 robert: reviewed
├── 2026-01-15 robert: draft → reviewed
└── 2026-01-10 created
Section: 模块边界
├── 2026-01-18 robert: locked (reason: 核心架构)
└── 2026-01-12 created与其他工具配合
intent-interview → 创建 Intent (默认全是 draft)
↓
/intent-review → 审批关键 sections
↓
aine-dev-flow → 开发实现 (遵守 locked/reviewed 规则)
↓
intent-sync → 检查一致性配置
可在 ~/.claude/settings.json 中配置默认 reviewer：
{
"idd": {
"reviewer": "robert",
"autoLockPatterns": ["模块边界", "数据结构", "安全约束"]
}
}