Aide Plugin 设计文档
一、概述
aide-plugin 是 Claude Code 插件，提供 Aide 工作流体系的 Commands 和 Skill。
1.1 解决的问题
| 问题 | 解决方案 |
|---|---|
| CLAUDE.md 信息过载 | 流程规则封装到 Commands，按需触发 |
| 操作指令分散 | 工具使用方法集中到 Skill |
| 流程遵循不一致 | Commands 定义明确的阶段和顺序 |
1.2 组件关系
┌─────────────────────────────────────────────────┐
│ Commands │
│ 定义"做什么"和"按什么顺序做" │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ init │ │ prep │ │ exec │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
└───────┼────────────┼────────────┼───────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────┐
│ Skill │
│ 定义"怎么调用工具" │
│ ┌─────────────────────────────────────────┐ │
│ │ aide skill │ │
│ │ env | flow | decide | config | init │ │
│ └─────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
│
▼ 调用
┌─────────────────────────────────────────────────┐
│ aide-program │
│ 实际执行操作，返回精简结果 │
└─────────────────────────────────────────────────┘
二、Commands 索引
| Command | 设计文档 | 执行文件 | 职责 |
|---|---|---|---|
/aide:init |
commands/init.md | ../../commands/init.md | 项目认知与环境初始化 |
/aide:prep |
commands/prep.md | ../../commands/prep.md | 任务准备流程 |
/aide:exec |
commands/exec.md | ../../commands/exec.md | 任务执行流程 |
2.1 Commands 设计原则
聚焦思考方法论，不涉及工具细节
Commands 只告诉 LLM：
- 怎么思考（分析方法、优化方向）
- 流程是什么（阶段划分、执行顺序）
- 决策边界（哪些自主完成，哪些需确认）
具体工具调用由 Skill 负责说明。
2.2 工作流程
/aide:init /aide:prep /aide:exec
│ │ │
▼ ▼ ▼
┌────────┐ ┌──────────┐ ┌──────────┐
│环境检测│ │ 任务分析 │ │ 流程设计 │
│项目认知│ │ 任务优化 │ │ 迭代实现 │
│介绍能力│ │ 待定项 │ │ 验证交付 │
└────────┘ │ 生成细则 │ │ 文档更新 │
└──────────┘ │ 收尾 │
│ └──────────┘
▼
task-spec.md ──────────────▶
三、Skill 索引
| Skill | 设计文档 | 执行文件 | 职责 |
|---|---|---|---|
| aide | skill/aide.md | ../../skills/aide/SKILL.md | aide 命令行工具使用指南 |
3.1 Skill 设计原则
纯工具说明，便于快速查阅
Skill 只包含：
- 命令语法和参数
- 输入输出格式
- 典型使用示例
不包含流程指导和业务逻辑。
四、职责边界
4.1 需要程序约束的场景
| 场景 | 处理方式 |
|---|---|
| 环境检测与修复 | aide env ensure |
| 待定项呈现与确认 | aide decide |
| 状态记录与 git 提交 | aide flow |
| 配置读写 | aide config |
4.2 不需要程序约束的场景
| 场景 | 说明 |
|---|---|
| 任务分析思考 | LLM 自由发挥 |
| 任务优化思考 | LLM 自由发挥 |
| 业务决策判断 | LLM 自由发挥 |
| 任务细则编写 | LLM 自由发挥，产出 task-spec.md |
| 业务代码编写 | LLM 自由发挥 |
五、修改指南
5.1 修改 Command
- 阅读对应的设计文档（如
commands/init.md） - 理解职责和流程
- 修改执行文件（如
../commands/init.md） - 更新设计文档（如有重大变更）
- 更新本导览（如有新增/删除 Command）
5.2 修改 Skill
- 阅读 skill/aide.md
- 理解各子命令的接口
- 修改执行文件
../skills/aide/SKILL.md - 更新设计文档
- 如涉及 aide-program 变更，同步更新 aide-program 文档
5.3 新增 Command
- 在
commands/下创建设计文档 - 在
../commands/下创建执行文件 - 更新本导览的索引表
- 更新 总导览