intent-review

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Intent Review

交互式 Section 级别的 Intent 审批工具。

Interactive section-level Intent approval tool.

核心概念

Core Concepts

Intent 文档按 Section 粒度审批，三种状态：

状态	标记	含义	Agent 行为
LOCKED	`::: locked`	核心架构，修改需 human 明确同意	暂停，请求确认
REVIEWED	`::: reviewed`	已审阅，可修改但需通知	允许，事后通知
DRAFT	`::: draft`	草稿，可自由迭代	自由修改

Intent documents are approved at the Section granularity, with three statuses:

Status	Marker	Meaning	Agent Behavior
LOCKED	`::: locked`	Core architecture, requires explicit human approval for modifications	Pauses, requests confirmation
REVIEWED	`::: reviewed`	Reviewed, modifications allowed but require notification	Allows, notifies afterwards
DRAFT	`::: draft`	Draft, free iteration allowed	Free modification

工作流程

Workflow

/intent-review [path]
        ↓
┌───────────────────┐
│  解析 Intent 文件  │
│  识别所有 Section  │
└─────────┬─────────┘
          ↓
┌───────────────────┐
│  展示状态概览      │
│  N locked         │
│  M reviewed       │
│  K draft/unmarked │
└─────────┬─────────┘
          ↓
┌───────────────────────────────────────┐
│  逐个未标记 Section 询问              │
│                                       │
│  AskUserQuestion:                     │
│  "Section: [标题]"                    │
│  选项:                                │
│  - Lock (核心架构)                    │
│  - Review (确认接受)                  │
│  - Skip (保持 draft)                  │
└─────────┬─────────────────────────────┘
          ↓
┌───────────────────┐
│  更新文件          │
│  添加标记和属性    │
└───────────────────┘

/intent-review [path]
        ↓
┌───────────────────┐
│  解析 Intent 文件  │
│  识别所有 Section  │
└─────────┬─────────┘
          ↓
┌───────────────────┐
│  展示状态概览      │
│  N locked         │
│  M reviewed       │
│  K draft/unmarked │
└─────────┬─────────┘
          ↓
┌───────────────────────────────────────┐
│  逐个未标记 Section 询问              │
│                                       │
│  AskUserQuestion:                     │
│  "Section: [标题]"                    │
│  选项:                                │
│  - Lock (核心架构)                    │
│  - Review (确认接受)                  │
│  - Skip (保持 draft)                  │
└─────────┬─────────────────────────────┘
          ↓
┌───────────────────┐
│  更新文件          │
│  添加标记和属性    │
└───────────────────┘

使用方法

Usage Methods

审批指定文件

Approve a Specific File

/intent-review src/core/intent/INTENT.md

/intent-review src/core/intent/INTENT.md

审批当前模块

Approve Current Module

cd src/chambers/terminal
/intent-review

自动查找

intent/INTENT.md

cd src/chambers/terminal
/intent-review

Automatically finds

intent/INTENT.md

批量审批

Batch Approval

/intent-review --all

扫描项目所有 intent 文件

/intent-review --all

Scans all intent files in the project

执行步骤

Execution Steps

1. 定位 Intent 文件

1. Locate Intent File

javascript

// 优先级：
// 1. 用户指定路径
// 2. 当前目录下 intent/INTENT.md
// 3. 当前目录下 INTENT.md

javascript

// 优先级：
// 1. 用户指定路径
// 2. 当前目录下 intent/INTENT.md
// 3. 当前目录下 INTENT.md

2. 解析 Section

2. Parse Sections

识别两种 Section：

已标记的：

markdown

::: locked

Identifies two types of Sections:

Marked:

markdown

::: locked

模块边界

... :::


**未标记的**（普通 markdown heading）：
```markdown

... :::


**Unmarked** (regular markdown heading):
```markdown

API 设计

...

undefined

...

undefined

3. 展示概览

3. Display Overview

Intent Review: src/core/intent/INTENT.md

状态概览：
├── 🔒 LOCKED: 2 sections
│   ├── 模块边界规则
│   └── 数据结构
├── ✓ REVIEWED: 3 sections
│   ├── API 签名 (by robert, 2026-01-19)
│   ├── 配置格式
│   └── 错误处理
└── 📝 UNMARKED: 4 sections
    ├── 实现建议
    ├── 性能考虑
    ├── 示例代码
    └── 变更记录

是否开始审批未标记的 sections？

Intent Review: src/core/intent/INTENT.md

状态概览：
├── 🔒 LOCKED: 2 sections
│   ├── 模块边界规则
│   └── 数据结构
├── ✓ REVIEWED: 3 sections
│   ├── API 签名 (by robert, 2026-01-19)
│   ├── 配置格式
│   └── 错误处理
└── 📝 UNMARKED: 4 sections
    ├── 实现建议
    ├── 性能考虑
    ├── 示例代码
    └── 变更记录

是否开始审批未标记的 sections？

4. 逐个审批

4. Approve One by One

对每个未标记 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: "暂不审批，保持草稿状态"

Use AskUserQuestion for each unmarked Section:

使用 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. 更新文件

5. Update File

根据用户选择，在 markdown 中添加标记：

Lock 选择：

markdown

::: locked {reason="核心架构"}

Add markers to markdown based on user selection:

Lock selection:

markdown

::: locked {reason="核心架构"}

API 签名

... :::


**Review 选择**：
```markdown
::: reviewed {by=<username> date=<today>}

... :::


**Review selection**:
```markdown
::: reviewed {by=<username> date=<today>}

API 签名

... :::


**Skip 选择**：
不修改，或添加：
```markdown
::: draft

... :::


**Skip selection**:
No modification, or add:
```markdown
::: draft

实现建议

... :::

undefined

... :::

undefined

特殊场景

Special Scenarios

检测 LOCKED Section 被修改

Detect Modifications to LOCKED Sections

当文件有未提交的修改时：

⚠️ 检测到 LOCKED section 被修改：
- Section: 模块边界规则
- 修改内容: [diff preview]

此修改需要 human 明确同意。是否接受？

When there are uncommitted changes to the file:

⚠️ 检测到 LOCKED section 被修改：
- Section: 模块边界规则
- 修改内容: [diff preview]

此修改需要 human 明确同意。是否接受？

查看审批历史

View Approval History

/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-review --history src/core/intent/INTENT.md

Output:

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

与其他工具配合

Integration with Other Tools

intent-interview → 创建 Intent (默认全是 draft)
        ↓
/intent-review → 审批关键 sections
        ↓
aine-dev-flow → 开发实现 (遵守 locked/reviewed 规则)
        ↓
intent-sync → 检查一致性

intent-interview → 创建 Intent (默认全是 draft)
        ↓
/intent-review → 审批关键 sections
        ↓
aine-dev-flow → 开发实现 (遵守 locked/reviewed 规则)
        ↓
intent-sync → 检查一致性

配置

Configuration

可在

~/.claude/settings.json

中配置默认 reviewer：

json

{
  "idd": {
    "reviewer": "robert",
    "autoLockPatterns": ["模块边界", "数据结构", "安全约束"]
  }
}

You can configure the default reviewer in

~/.claude/settings.json

json

{
  "idd": {
    "reviewer": "robert",
    "autoLockPatterns": ["模块边界", "数据结构", "安全约束"]
  }
}