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.From its SKILL.md

Install

npx -y skills add ArcBlock/idd --skill intent-check

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

15 stars15 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.4 KB, as published. Nobody here has run it

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             # 再次检查直到通过