Intent Check

触发 Intent 检查流程，是 intent-validate 和 intent-sync agents 的用户友好入口。

功能 格式验证 (intent-validate) - 检查 Intent 文件是否符合 IDD 规范 代码同步 (intent-sync) - 检查代码实现与 Intent 的一致性 综合报告 - 汇总两项检查结果 工作流程 /intent-check [options] ↓ ┌───────────────────────────────────┐ │ 确定检查范围 │ │ - 指定路径 or 当前目录 │ │ - 单模块 or 全项目 │ └─────────────┬─────────────────────┘ ↓ ┌───────────────────────────────────┐ │ 调用 intent-validate agent │ │ → 格式合规报告 │ └─────────────┬─────────────────────┘ ↓ ┌───────────────────────────────────┐ │ 调用 intent-sync agent │ │ → 代码一致性报告 │ └─────────────┬─────────────────────┘ ↓ ┌───────────────────────────────────┐ │ 汇总报告 │ │ - 问题列表 │ │ - 修复建议 │ │ - 行动项 │ └───────────────────────────────────┘

使用方法 完整检查 /intent-check

检查当前目录的 Intent，包括格式验证和代码同步。

指定路径 /intent-check src/core/

检查指定模块。

仅格式验证 /intent-check --validate

只运行 intent-validate，检查 Intent 文件格式。

仅代码同步 /intent-check --sync

只运行 intent-sync，检查代码与 Intent 一致性。

全项目检查 /intent-check --all

扫描并检查项目中所有 Intent 文件。

Git 差异检查 /intent-check --git-diff origin/main

只检查相对于基准分支有变更的模块。

输出示例

Intent Check Report

检查时间: 2026-01-19 14:30 检查范围: src/core/

概览

| 检查项 | 状态 | 问题数 |

|--------|------|--------|

| 格式验证 | ⚠️ | 3 |

| 代码同步 | ❌ | 5 |

格式问题 (intent-validate)

⚠️ 警告

1. src/core/intent/INTENT.md:45

2. 缺少 ASCII 结构图

3. src/core/intent/INTENT.md:78

4. API 定义缺少返回值说明

❌ 错误

1. src/core/intent/INTENT.md:12
2. Section 标记语法错误: ::: lock → ::: locked

同步问题 (intent-sync)

新增未记录

| API | 文件 | 建议 |

|-----|------|------|

| getChamberStats() | chamber.js:89 | 添加到 Intent |

签名不一致

```diff

deleteChamber

• Intent: deleteChamber(app, name)
• Code: deleteChamber(app, name, options)

边界违规 规则 位置 说明 禁止直接拼接路径 routes/apps.js:45 应使用 chamber.getPath() 行动建议 立即修复 (P0) 修复 Section 标记语法错误 修复边界违规 建议修复 (P1) 更新 Intent: 添加 getChamberStats() API 更新 Intent: deleteChamber 添加 options 参数 可选改进 (P2) 添加 ASCII 结构图 补充 API 返回值说明

退出码

可用于 CI/CD 集成：

```bash /intent-check || exit 1

与其他命令配合 /intent-init # 初始化 ↓ /intent-interview # 创建 Intent ↓ /intent-review # 审批 ↓ [开发实现] ↓ /intent-check # ← 检查（本命令） ↓ 修复问题 or 更新 Intent ↓ /intent-check # 再次检查直到通过