intent-assess

仓库: arcblock/idd
安装量: 71
排名: #10904

安装

npx skills add https://github.com/arcblock/idd --skill intent-assess

Intent Assess

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

两个模式 1. 评估模式 (Assessment) /intent-assess

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

  1. 学习模式 (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. 从核心模块开始
  2. 先为 src/core/ 编写 Intent

  3. 建立 Intent 模板和规范

  4. 渐进式推广

  5. 新功能必须先写 Intent

  6. 老代码逐步补充

  7. 工具配套

  8. 安装 IDD plugin
  9. 配置 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 作为唯一真相来源)

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

  2. IDD vs SDD 对比 | 维度 | SDD | IDD |

|------|-----|-----|

| 组织方式 | 按类型 (功能/UX/技术) | 按模块 |

| 核心载体 | 文字描述 | 结构图 |

| 粒度 | 细分 User Story | 完整 Pattern |

| Task 管理 | 独立 Task 文件 | AI 自主分解 |

| LLM 友好度 | 需要拼装上下文 | 一次理解完整 |

  1. 实际案例

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

快速参考 /intent-assess --learn --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

← 返回排行榜