ArcBlock Intent Init
初始化项目的 IDD (Intent Driven Development) 结构。
功能
- 检查现状 - 扫描项目，识别已有的 intent 文件或类似结构
- 创建目录 - 建立标准 IDD 目录结构
- 生成模板 - 创建入口 INTENT.md 和模块级模板
- 配置建议 - 根据项目类型给出配置建议
工作流程
/intent-init
↓
┌───────────────────────────────────┐
│ Phase 1: 扫描现状 │
│ - 查找 intent/, specs/, docs/ │
│ - 识别 README, DESIGN 等文档 │
│ - 检测项目类型 (monorepo/单模块) │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 2: 展示发现 │
│ - 已有文档列表 │
│ - 项目结构分析 │
│ - 推荐的 IDD 结构 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 3: 确认并创建 │
│ - AskUserQuestion 确认结构 │
│ - 创建目录和模板文件 │
│ - 可选：迁移现有文档 │
└───────────────────────────────────┘
标准 IDD 目录结构
单模块项目
project/
├── intent/
│ └── INTENT.md # 项目 Intent（入口）
├── src/
└── ...
Monorepo / 多模块项目
project/
├── intent/
│ ├── INTENT.md # 项目概述（入口）
│ └── architecture/
│ ├── DEPENDENCIES.md # 模块依赖图
│ └── BOUNDARIES.md # 边界规则
│
├── src/
│ ├── module-a/
│ │ └── intent/
│ │ └── INTENT.md # 模块 Intent
│ └── module-b/
│ └── intent/
│ └── INTENT.md
└── ...
模板内容
项目级 INTENT.md
# [Project Name] Intent
> 一句话描述项目目标
状态: draft
最后更新: YYYY-MM-DD
## 愿景
[项目要解决的问题和目标]
## 架构概览
[ASCII 架构图]
## 模块索引
| 模块 | 职责 | Intent |
|------|------|--------|
| xxx | ... | [link] |
## 非目标
- [明确不做什么]
## 约束
- [技术约束]
- [业务约束]
模块级 INTENT.md
# [Module] Intent
> 模块职责一句话
状态: draft
最后更新: YYYY-MM-DD
## 职责
[模块做什么]
## 非目标
[模块不做什么]
## 数据结构
[核心数据结构定义]
## API
[对外接口定义]
## 示例
[输入 → 输出 示例]
检测逻辑
识别已有 Intent 结构
// 检查路径
const intentPaths = [
'intent/INTENT.md',
'INTENT.md',
'docs/INTENT.md',
'specs/',
'design/',
];
// 检查内容特征
const intentMarkers = [
'## 职责',
'## 非目标',
'::: locked',
'::: reviewed',
];
项目类型识别
// Monorepo 特征
const monorepoMarkers = [
'packages/',
'apps/',
'src/modules/',
'lerna.json',
'pnpm-workspace.yaml',
];
选项
/intent-init # 交互式初始化
/intent-init --dry-run # 只展示计划，不执行
/intent-init --minimal # 最小化结构
/intent-init --migrate # 尝试迁移现有文档
与其他命令配合
/intent-init # 初始化结构
↓
/intent-interview # 填充 Intent 内容
↓
/intent-review # 审批关键 sections
↓
[开发]
↓
/intent-check # 检查一致性