Back to Details

intent-assess

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Intent Assess

Intent Assess

评估项目是否适合 IDD，并教育 IDD 方法论。
Assess if your project is suitable for IDD and educate on the IDD methodology.

两个模式

Two Modes

1. 评估模式 (Assessment)

1. Assessment Mode

/intent-assess
分析当前项目，评估是否适合采用 IDD。
/intent-assess
Analyze the current project and assess its suitability for adopting IDD.

2. 学习模式 (Learning)

2. Learning Mode

/intent-assess --learn
教育 IDD 方法论，解释核心概念。
/intent-assess --learn
Educate on the IDD methodology and explain core concepts.

评估模式

Assessment Mode

工作流程

Workflow

/intent-assess
        ↓
┌───────────────────────────────────┐
│  Phase 1: 项目分析                │
│  - 项目类型识别                   │
│  - 代码库规模                     │
│  - 现有文档情况                   │
│  - 团队协作模式                   │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 2: 适配度评估              │
│  - 计算匹配分数                   │
│  - 识别优势和挑战                 │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 3: 建议                    │
│  - 是否推荐 IDD                   │
│  - 如何开始                       │
│  - 替代方案（如不适合）           │
└───────────────────────────────────┘
/intent-assess
        ↓
┌───────────────────────────────────┐
│  Phase 1: Project Analysis        │
│  - Project Type Identification    │
│  - Codebase Scale                 │
│  - Existing Documentation Status  │
│  - Team Collaboration Model       │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 2: Suitability Assessment  │
│  - Calculate Matching Score       │
│  - Identify Strengths and Challenges │
└─────────────┬─────────────────────┘
              ↓
┌───────────────────────────────────┐
│  Phase 3: Recommendations         │
│  - Recommend IDD or Not           │
│  - How to Get Started             │
│  - Alternatives (if Not Suitable) │
└───────────────────────────────────┘

评估维度

Assessment Dimensions

维度有利于 IDD不利于 IDD
项目类型系统软件、框架、库简单脚本、一次性项目
代码规模中大型 (>5k LOC)小型 (<1k LOC)
团队协作多人协作、AI 辅助单人独立开发
架构复杂度多模块、需要边界单模块、简单结构
迭代方式持续迭代、长期维护一次性交付
AI 工具使用使用 Claude/Copilot纯人工开发
DimensionFavorable for IDDUnfavorable for IDD
Project TypeSystem software, frameworks, librariesSimple scripts, one-off projects
Code ScaleMedium to large (>5k LOC)Small (<1k LOC)
Team CollaborationMulti-person collaboration, AI-assistedIndividual independent development
Architecture ComplexityMulti-module, requires boundariesSingle-module, simple structure
Iteration ApproachContinuous iteration, long-term maintenanceOne-time delivery
AI Tool UsageUsing Claude/CopilotManual-only development

评估报告示例

Assessment Report Example

markdown
undefined
markdown
undefined

IDD Assessment Report

IDD Assessment Report

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

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

Suitability Score: 85/100 ⭐⭐⭐⭐

项目特征

Project Characteristics

特征当前状态IDD 契合度
项目类型框架/平台✅ 高
代码规模~15k LOC✅ 高
模块数量12 个✅ 高
团队规模3 人 + AI✅ 高
现有文档部分🟡 中
CharacteristicCurrent StatusIDD Alignment
Project TypeFramework/Platform✅ High
Code Scale~15k LOC✅ High
Number of Modules12✅ High
Team Size3 people + AI✅ High
Existing DocumentationPartial🟡 Medium

优势

Strengths

  • ✅ 多模块架构，需要清晰边界定义
  • ✅ 使用 AI 辅助开发，Intent 可指导 AI
  • ✅ 长期维护项目，文档价值高
  • ✅ 已有部分设计文档，可迁移
  • ✅ Multi-module architecture requires clear boundaries and contracts
  • ✅ AI-assisted development can directly use Intent as context
  • ✅ Long-term maintenance project, high documentation value
  • ✅ Partial design documentation exists, which can be migrated

挑战

Challenges

  • ⚠️ 需要建立 Intent 编写习惯
  • ⚠️ 现有代码需要补充 Intent
  • ⚠️ 团队需要学习 IDD 方法
  • ⚠️ Need to establish Intent writing habits
  • ⚠️ Existing code needs Intent supplementation
  • ⚠️ Team needs to learn IDD methods

建议

Recommendations

推荐: 采用 IDD ✅

Recommendation: Adopt IDD ✅

该项目非常适合 IDD：
  1. 多模块架构需要清晰的边界和契约
  2. AI 辅助开发可以直接使用 Intent 作为上下文
  3. 长期维护价值高
This project is highly suitable for IDD:
  1. Multi-module architecture requires clear boundaries and contracts
  2. AI-assisted development can directly use Intent as context
  3. High long-term maintenance value

启动建议

Onboarding Recommendations

  1. 从核心模块开始
    • 先为 
      src/core/
      编写 Intent
    • 建立 Intent 模板和规范
  2. 渐进式推广
    • 新功能必须先写 Intent
    • 老代码逐步补充
  3. 工具配套
    • 安装 IDD plugin
    • 配置 CI/CD 集成
  1. Start with core modules
    • Write Intent for 
      src/core/
      first
    • Establish Intent templates and specifications
  2. Gradual promotion
    • New features must have Intent written first
    • Gradually supplement Intent for old code
  3. Tool support
    • Install IDD plugin
    • Configure CI/CD integration

预期收益

Expected Benefits

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

---
  • 🎯 ~30% improvement in AI coding efficiency
  • 🎯 Clearer architecture boundaries
  • 🎯 Faster onboarding for new members
  • 🎯 Reduced "outdated documentation" issues

---

学习模式

Learning Mode

交互式教学

Interactive Teaching

/intent-assess --learn
通过问答方式教授 IDD：
┌───────────────────────────────────┐
│  欢迎学习 IDD！                   │
│                                   │
│  我将介绍：                        │
│  1. 什么是 IDD                    │
│  2. IDD vs TDD vs SDD             │
│  3. Intent 文件结构               │
│  4. 实际案例                       │
│                                   │
│  你想从哪个话题开始？              │
└───────────────────────────────────┘
/intent-assess --learn
Teach IDD through Q&A:
┌───────────────────────────────────┐
│  Welcome to learning IDD!         │
│                                   │
│  I will cover:                    │
│  1. What is IDD                   │
│  2. IDD vs TDD vs SDD             │
│  3. Intent File Structure         │
│  4. Practical Examples            │
│                                   │
│  Which topic would you like to start with? │
└───────────────────────────────────┘

核心概念讲解

Core Concept Explanation

1. 什么是 IDD

1. What is IDD

开发方法论演进：

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

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

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

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

Traditional:  Code → Test → Docs
              (Documentation often becomes outdated)

SDD:          Spec → Code → Test
              (Specs are scattered and hard to maintain)

TDD:          Test → Code → Docs
              (Tests cannot capture design rationale)

IDD:          Intent → Test → Code → Sync
              (Intent serves as the single source of truth)

2. Intent 三层结构

2. Three-Layer Structure of Intent

┌─────────────────────────────────────┐
│  Layer 1: 结构图 (Structure)        │
│  - 目录结构、数据结构、模块关系      │
│  - ASCII 图优先                     │
├─────────────────────────────────────┤
│  Layer 2: 约束规则 (Constraints)    │
│  - 依赖方向、边界规则、不变式        │
│  - 可转化为测试断言                  │
├─────────────────────────────────────┤
│  Layer 3: 行为示例 (Examples)       │
│  - 输入 → 输出 示例                 │
│  - 边界情况                         │
└─────────────────────────────────────┘
┌─────────────────────────────────────┐
│  Layer 1: Structure Diagram         │
│  - Directory structure, data structure, module relationships │
│  - ASCII diagrams preferred         │
├─────────────────────────────────────┤
│  Layer 2: Constraint Rules          │
│  - Dependency direction, boundary rules, invariants │
│  - Convertible to test assertions   │
├─────────────────────────────────────┤
│  Layer 3: Behavior Examples         │
│  - Input → Output examples          │
│  - Boundary cases                   │
└─────────────────────────────────────┘

3. IDD vs SDD 对比

3. IDD vs SDD Comparison

markdown
| 维度 | SDD | IDD |
|------|-----|-----|
| 组织方式 | 按类型 (功能/UX/技术) | 按模块 |
| 核心载体 | 文字描述 | 结构图 |
| 粒度 | 细分 User Story | 完整 Pattern |
| Task 管理 | 独立 Task 文件 | AI 自主分解 |
| LLM 友好度 | 需要拼装上下文 | 一次理解完整 |
markdown
| Dimension | SDD | IDD |
|-----------|-----|-----|
| Organization | By type (function/UX/technology) | By module |
| Core Carrier | Text description | Structure diagram |
| Granularity | Granular User Stories | Complete Patterns |
| Task Management | Independent Task files | AI autonomous decomposition |
| LLM Friendliness | Context assembly required | Complete understanding in one go |

4. 实际案例

4. Practical Examples

展示一个真实的 Intent 文件，解释各部分作用。
Show a real Intent file and explain the role of each part.

快速参考

Quick Reference

/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 --learn --topic <topic>
Optional topics:
  • what
    - What is IDD
  • vs-sdd
    - IDD vs SDD Comparison
  • vs-tdd
    - IDD vs TDD Comparison
  • structure
    - Intent File Structure
  • workflow
    - IDD Workflow
  • approval
    - Section Approval Mechanism
  • best-practices
    - Best Practices

与其他命令配合

Integration with Other Commands

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