intent-assess

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	纯人工开发

评估报告示例

# 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 对比

| 维度 | 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