Agent skill

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.

View SKILL.md on GitHub Repository
Stars 11
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/ArcBlock/idd/tree/main/skills/intent-assess

SKILL.md

Intent Assess

评估项目是否适合 IDD，并教育 IDD 方法论。

两个模式

1. 评估模式 (Assessment)

/intent-assess

分析当前项目，评估是否适合采用 IDD。

2. 学习模式 (Learning)

/intent-assess --learn

教育 IDD 方法论，解释核心概念。

评估模式

工作流程

/intent-assess
        ↓
┌───────────────────────────────────┐
│  Phase 1: 项目分析                │
│  - 项目类型识别                   │
│  - 代码库规模                     │
│  - 现有文档情况                   │
│  - 团队协作模式                   │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 2: 适配度评估              │
│  - 计算匹配分数                   │
│  - 识别优势和挑战                 │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 3: 建议                    │
│  - 是否推荐 IDD                   │
│  - 如何开始                       │
│  - 替代方案（如不适合）           │
└───────────────────────────────────┘

评估维度

维度 有利于 IDD 不利于 IDD
项目类型 系统软件、框架、库 简单脚本、一次性项目
代码规模 中大型 (>5k LOC) 小型 (<1k LOC)
团队协作 多人协作、AI 辅助 单人独立开发
架构复杂度 多模块、需要边界 单模块、简单结构
迭代方式 持续迭代、长期维护 一次性交付
AI 工具使用 使用 Claude/Copilot 纯人工开发

评估报告示例

markdown
# IDD Assessment Report

> Project: ainecore
> Date: 2026-01-19

## 适配度评分: 85/100 ⭐⭐⭐⭐

## 项目特征

| 特征 | 当前状态 | IDD 契合度 |
|------|---------|-----------|
| 项目类型 | 框架/平台 | ✅ 高 |
| 代码规模 | ~15k LOC | ✅ 高 |
| 模块数量 | 12 个 | ✅ 高 |
| 团队规模 | 3 人 + AI | ✅ 高 |
| 现有文档 | 部分 | 🟡 中 |

## 优势

- ✅ 多模块架构，需要清晰边界定义
- ✅ 使用 AI 辅助开发，Intent 可指导 AI
- ✅ 长期维护项目，文档价值高
- ✅ 已有部分设计文档，可迁移

## 挑战

- ⚠️ 需要建立 Intent 编写习惯
- ⚠️ 现有代码需要补充 Intent
- ⚠️ 团队需要学习 IDD 方法

## 建议

### 推荐: 采用 IDD ✅

该项目非常适合 IDD：
1. 多模块架构需要清晰的边界和契约
2. AI 辅助开发可以直接使用 Intent 作为上下文
3. 长期维护价值高

### 启动建议

1. **从核心模块开始**
   - 先为 `src/core/` 编写 Intent
   - 建立 Intent 模板和规范

2. **渐进式推广**
   - 新功能必须先写 Intent
   - 老代码逐步补充

3. **工具配套**
   - 安装 IDD plugin
   - 配置 CI/CD 集成

### 预期收益

- 🎯 AI 编码效率提升 ~30%
- 🎯 架构边界更清晰
- 🎯 新成员 onboard 更快
- 🎯 减少 "文档过时" 问题

学习模式

交互式教学

/intent-assess --learn

通过问答方式教授 IDD：

┌───────────────────────────────────┐
│  欢迎学习 IDD！                   │
│                                   │
│  我将介绍：                        │
│  1. 什么是 IDD                    │
│  2. IDD vs TDD vs SDD             │
│  3. Intent 文件结构               │
│  4. 实际案例                       │
│                                   │
│  你想从哪个话题开始？              │
└───────────────────────────────────┘

核心概念讲解

1. 什么是 IDD

开发方法论演进：

Traditional:  Code → Test → Docs
              (文档经常过时)

SDD:          Spec → Code → Test
              (Spec 分散，难以维护)

TDD:          Test → Code → Docs
              (测试不能捕捉设计理由)

IDD:          Intent → Test → Code → Sync
              (Intent 作为唯一真相来源)

2. Intent 三层结构

┌─────────────────────────────────────┐
│  Layer 1: 结构图 (Structure)        │
│  - 目录结构、数据结构、模块关系      │
│  - ASCII 图优先                     │
├─────────────────────────────────────┤
│  Layer 2: 约束规则 (Constraints)    │
│  - 依赖方向、边界规则、不变式        │
│  - 可转化为测试断言                  │
├─────────────────────────────────────┤
│  Layer 3: 行为示例 (Examples)       │
│  - 输入 → 输出 示例                 │
│  - 边界情况                         │
└─────────────────────────────────────┘

3. IDD vs SDD 对比

markdown
| 维度 | SDD | IDD |
|------|-----|-----|
| 组织方式 | 按类型 (功能/UX/技术) | 按模块 |
| 核心载体 | 文字描述 | 结构图 |
| 粒度 | 细分 User Story | 完整 Pattern |
| Task 管理 | 独立 Task 文件 | AI 自主分解 |
| LLM 友好度 | 需要拼装上下文 | 一次理解完整 |

4. 实际案例

展示一个真实的 Intent 文件，解释各部分作用。

快速参考

/intent-assess --learn --topic <topic>

可选 topic：

  • what - 什么是 IDD
  • vs-sdd - IDD vs SDD 对比
  • vs-tdd - IDD vs TDD 对比
  • structure - Intent 文件结构
  • workflow - IDD 工作流程
  • approval - Section 审批机制
  • best-practices - 最佳实践

与其他命令配合

/intent-assess                # 评估项目
    ↓ (如果适合)
/intent-assess --learn        # 学习 IDD
    ↓
/intent-init                  # 初始化 IDD
    ↓
/intent-interview             # 创建 Intent

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.

11 4
Explore
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.

11 4
Explore
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.

11 4
Explore
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.

11 4
Explore
ArcBlock/idd

intent-interview

11 4
Explore
ArcBlock/idd

intent-sync

After implementation is complete and tests pass, sync confirmed details back to Intent. Captures finalized interfaces, data structures, naming conventions, and architecture decisions. Use after development is done and user confirms the implementation.

11 4
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results