intent-check

Original：🇨🇳 Chinese

Translated

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.

1installs

Sourcearcblock/idd

Added on2026-02-04

NPX Install

npx skill4agent add arcblock/idd intent-check

SKILL.md Content (Chinese)

View Translation Comparison →

Intent Check

Trigger the Intent check process, a user-friendly entry point for intent-validate and intent-sync agents.

Features

Format Validation (intent-validate) - Check if Intent files comply with IDD specifications
Code Sync (intent-sync) - Verify consistency between code implementation and Intent
Comprehensive Report - Aggregate results from both checks

Workflow

/intent-check [options]
        ↓
┌───────────────────────────────────┐
│  Determine check scope             │
│  - Specify path or current directory│
│  - Single module or entire project │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Call intent-validate agent        │
│  → Format compliance report        │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Call intent-sync agent            │
│  → Code consistency report         │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Aggregate report                  │
│  - Issue list                      │
│  - Fix suggestions                 │
│  - Action items                    │
└───────────────────────────────────┘

Usage

Full Check

/intent-check

Check Intents in the current directory, including format validation and code sync.

Specify Path

/intent-check src/core/

Check the specified module.

Format Validation Only

/intent-check --validate

Only run intent-validate to check Intent file formats.

Code Sync Only

/intent-check --sync

Only run intent-sync to verify code consistency with Intents.

Full Project Check

/intent-check --all

Scan and check all Intent files in the project.

Git Diff Check

/intent-check --git-diff origin/main

Only check modules that have changes relative to the base branch.

Output Example

markdown

# Intent Check Report

> Check Time: 2026-01-19 14:30
> Check Scope: src/core/

## Overview

| Check Item | Status | Number of Issues |
|--------|------|--------|
| Format Validation | ⚠️ | 3 |
| Code Sync | ❌ | 5 |

## Format Issues (intent-validate)

### ⚠️ Warnings

1. `src/core/intent/INTENT.md:45`
   - Missing ASCII structure diagram

2. `src/core/intent/INTENT.md:78`
   - API definition lacks return value description

### ❌ Errors

1. `src/core/intent/INTENT.md:12`
   - Section tag syntax error: `::: lock` → `::: locked`

## Sync Issues (intent-sync)

### Newly Added Not Documented

| API | File | Suggestion |
|-----|------|------|
| `getChamberStats()` | chamber.js:89 | Add to Intent |

### Signature Mismatch

```diff
# deleteChamber
- Intent: deleteChamber(app, name)
+ Code:   deleteChamber(app, name, options)

Boundary Violation

Rule	Location	Description
Direct path concatenation prohibited	routes/apps.js:45	Should use chamber.getPath()

Action Suggestions

Immediate Fix (P0)

Fix section tag syntax error
Fix boundary violation

Recommended Fix (P1)

Update Intent: Add
```
getChamberStats()
```
API
Update Intent: Add options parameter to
```
deleteChamber
```

Optional Improvements (P2)

Add ASCII structure diagram
Supplement API return value descriptions


## Exit Codes

| Code | Meaning |
|----|------|
| 0 | All passed |
| 1 | Has warnings |
| 2 | Has errors |

Can be used for CI/CD integration:

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

Integration with Other Commands

/intent-init              # Initialize
    ↓
/intent-interview         # Create Intent
    ↓
/intent-review            # Approve
    ↓
[Development Implementation]
    ↓
/intent-check             # ← Check (this command)
    ↓
Fix issues or update Intent
    ↓
/intent-check             # Recheck until passed