القائمة
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.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Scan and normalize existing intent/planning files to IDD standard. Auto-fixes mechanical issues (frontmatter, directory structure), tags content issues for pickup. Use /intent-normalize to scan current project, or /intent-normalize <path> for specific directory.
Critical review of Intent design quality. Checks for over-engineering, YAGNI violations, premature abstraction, and simplification opportunities. Uses interactive discussion to refine design decisions.
Transform vague ideas into implementation-ready specifications through structured interviewing. Use when user describes a new feature/product idea, has a problem to solve, or needs to document requirements. Two-phase process: Phase A produces decisions.md, Phase B composes INTENT.md under budget constraints.
Transform approved Intent into executable phased plan with strict TDD. Each step requires tests first (happy/bad/edge/security cases), then implementation. Use after /intent-review when ready to start development.
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.
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.
| name | intent-assess |
| description | 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. |
评估项目是否适合 IDD，并教育 IDD 方法论。
/intent-assess
分析当前项目，评估是否适合采用 IDD。
/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. 实际案例 │
│ │
│ 你想从哪个话题开始？ │
└───────────────────────────────────┘
开发方法论演进：
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