intent-assess by arcblock/idd
npx skills add https://github.com/arcblock/idd --skill intent-assess评估项目是否适合 IDD,并教育 IDD 方法论。
/intent-assess
分析当前项目,评估是否适合采用 IDD。
/intent-assess --learn
教育 IDD 方法论,解释核心概念。
/intent-assess
↓
┌───────────────────────────────────┐
│ Phase 1: 项目分析 │
│ - 项目类型识别 │
│ - 代码库规模 │
│ - 现有文档情况 │
│ - 团队协作模式 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 2: 适配度评估 │
│ - 计算匹配分数 │
│ - 识别优势和挑战 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 3: 建议 │
│ - 是否推荐 IDD │
│ - 如何开始 │
│ - 替代方案(如不适合) │
└───────────────────────────────────┘
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 维度 | 有利于 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. 实际案例 │
│ │
│ 你想从哪个话题开始? │
└───────────────────────────────────┘
开发方法论演进:
Traditional: Code → Test → Docs
(文档经常过时)
SDD: Spec → Code → Test
(Spec 分散,难以维护)
TDD: Test → Code → Docs
(测试不能捕捉设计理由)
IDD: Intent → Test → Code → Sync
(Intent 作为唯一真相来源)
┌─────────────────────────────────────┐
│ Layer 1: 结构图 (Structure) │
│ - 目录结构、数据结构、模块关系 │
│ - ASCII 图优先 │
├─────────────────────────────────────┤
│ Layer 2: 约束规则 (Constraints) │
│ - 依赖方向、边界规则、不变式 │
│ - 可转化为测试断言 │
├─────────────────────────────────────┤
│ Layer 3: 行为示例 (Examples) │
│ - 输入 → 输出 示例 │
│ - 边界情况 │
└─────────────────────────────────────┘
| 维度 | SDD | IDD |
|------|-----|-----|
| 组织方式 | 按类型 (功能/UX/技术) | 按模块 |
| 核心载体 | 文字描述 | 结构图 |
| 粒度 | 细分 User Story | 完整 Pattern |
| Task 管理 | 独立 Task 文件 | AI 自主分解 |
| LLM 友好度 | 需要拼装上下文 | 一次理解完整 |
展示一个真实的 Intent 文件,解释各部分作用。
/intent-assess --learn --topic <topic>
可选 topic:
what - 什么是 IDDvs-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
Weekly Installs
70
Repository
GitHub Stars
7
First Seen
Jan 20, 2026
Security Audits
Installed on
claude-code60
opencode55
codex54
gemini-cli52
cursor44
antigravity41
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
122,000 周安装
PostgreSQL优化助手 - JSONB操作、性能调优、窗口函数、全文搜索实战指南
9,600 周安装
GitHub Copilot create-readme:AI自动生成专业README文档工具
9,600 周安装
React Native 最佳实践与性能优化指南 | 提升应用FPS、启动速度与包体积
9,600 周安装
Web无障碍性(a11y)指南:WCAG 2.1原则、Lighthouse审计与代码实践
10,500 周安装
Vue Router 最佳实践指南:导航守卫、路由生命周期与常见陷阱解决方案
9,900 周安装
SEO优化指南:技术性SEO、页面优化与结构化数据实践
10,700 周安装