Agent skill
intent-check
Run Intent validation and sync checks. Triggers intent-validate and intent-sync agents. Use /intent-check for full check, or /intent-check --validate/--sync for specific checks.
Install this agent skill to your Project
npx add-skill https://github.com/ArcBlock/idd/tree/main/skills/intent-check
SKILL.md
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`
- 缺少 ASCII 结构图
2. `src/core/intent/INTENT.md:78`
- API 定义缺少返回值说明
### ❌ 错误
1. `src/core/intent/INTENT.md:12`
- 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 返回值说明
## 退出码
| 码 | 含义 |
|----|------|
| 0 | 全部通过 |
| 1 | 有警告 |
| 2 | 有错误 |
可用于 CI/CD 集成：
```bash
/intent-check || exit 1
与其他命令配合
/intent-init # 初始化
↓
/intent-interview # 创建 Intent
↓
/intent-review # 审批
↓
[开发实现]
↓
/intent-check # ← 检查（本命令）
↓
修复问题 or 更新 Intent
↓
/intent-check # 再次检查直到通过
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ArcBlock/idd
intent-build-now
Start implementation from Intent. Validates Intent completeness, then either delegates to TaskSwarm (if available) or executes TDD phases directly. Use when you have an Intent ready and want to start building.
ArcBlock/idd
intent-story
Share your IDD adoption story. Through structured interviewing, create blog posts about Intent-Driven Development experiences, lessons learned, and best practices. Supports multiple languages and formats.
ArcBlock/idd
intent-critique
Critical review of Intent design quality. Checks for over-engineering, YAGNI violations, premature abstraction, and simplification opportunities. Uses interactive discussion to refine design decisions.
ArcBlock/idd
intent-changes
Manage structured change proposals for design documents with PR-like review experience. Use /intent-changes start <file> to begin, /intent-changes propose to suggest changes, /intent-changes accept/reject to decide, /intent-changes finalize to apply.
ArcBlock/idd
intent-assess
Assess if IDD fits your project and learn about Intent-Driven Development. Use /intent-assess to evaluate project suitability or /intent-assess --learn for IDD education.
ArcBlock/idd
intent-interview
Didn't find tool you were looking for?