菜单
Initialize IDD structure in a project. Checks existing state, creates directory structure, and generates templates. Use /intent-init to set up Intent-driven development in current project.
用 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-init |
| description | Initialize IDD structure in a project. Checks existing state, creates directory structure, and generates templates. Use /intent-init to set up Intent-driven development in current project. |
初始化项目的 IDD (Intent Driven Development) 结构。
/intent-init
↓
┌───────────────────────────────────┐
│ Phase 1: 扫描现状 │
│ - 查找 intent/, specs/, docs/ │
│ - 识别 README, DESIGN 等文档 │
│ - 检测项目类型 (monorepo/单模块) │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 2: 展示发现 │
│ - 已有文档列表 │
│ - 项目结构分析 │
│ - 推荐的 IDD 结构 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 3: 确认并创建 │
│ - AskUserQuestion 确认结构 │
│ - 创建目录和模板文件 │
│ - 可选：迁移现有文档 │
└───────────────────────────────────┘
project/
├── intent/
│ └── INTENT.md # 项目 Intent（入口）
├── src/
└── ...
project/
├── intent/
│ ├── INTENT.md # 项目概述（入口）
│ └── architecture/
│ ├── DEPENDENCIES.md # 模块依赖图
│ └── BOUNDARIES.md # 边界规则
│
├── src/
│ ├── module-a/
│ │ └── intent/
│ │ └── INTENT.md # 模块 Intent
│ └── module-b/
│ └── intent/
│ └── INTENT.md
└── ...
# [Project Name] Intent
> 一句话描述项目目标
状态: draft
最后更新: YYYY-MM-DD
## 愿景
[项目要解决的问题和目标]
## 架构概览
[ASCII 架构图]
## 模块索引
| 模块 | 职责 | Intent |
|------|------|--------|
| xxx | ... | [link] |
## 非目标
- [明确不做什么]
## 约束
- [技术约束]
- [业务约束]
# [Module] Intent
> 模块职责一句话
状态: draft
最后更新: YYYY-MM-DD
## 职责
[模块做什么]
## 非目标
[模块不做什么]
## 数据结构
[核心数据结构定义]
## API
[对外接口定义]
## 示例
[输入 → 输出 示例]
// 检查路径
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 # 检查一致性