名称: 最小可行代理层 描述: 指导为代码库创建最小可行代理层。用于在新项目中启动代理式编码、引导基本组件或为代理成功创建最小脚手架。 允许的工具: 读取, 搜索, 全局
最小可行代理层技能
指导团队通过创建基本的代理层组件来启动代理式编码。
何时使用
- 在新项目中启动代理式编码
- 向现有代码库添加代理层
- 理解最低要求
- 快速启动代理自动化
核心概念
“对于您的最小可行代理层，您真的只需要这些部分：AI开发者工作流目录、提示和计划。”
最小可行结构
项目/
├── 规范/ # 代理的计划
│ └── (生成的计划放在这里)
├── .claude/
│ └── 命令/ # 代理提示
│ ├── 杂务.md # 杂务规划
│ └── 实现.md # 实现HOP
└── 自动工作流/ # AI开发者工作流
├── 自动工作流_模块/
│ └── 代理.py # 核心执行
└── 自动工作流_杂务_实现.py # 网关脚本
总计: 4-5个文件用于引导。
实现工作流
步骤1: 创建目录结构
mkdir -p 规范
mkdir -p .claude/命令
mkdir -p 自动工作流/自动工作流_模块
步骤2: 创建杂务模板
.claude/命令/杂务.md:
# 杂务规划
为此杂务任务创建详细计划。
## 任务
$ARGUMENTS
## 输出
在: 规范/杂务-{adw_id}-{名称}.md 创建一个规范文件
包括:
- 任务描述
- 要修改的文件
- 逐步实现步骤
- 验证标准
步骤3: 创建实现HOP
.claude/命令/实现.md:
# 实现
实现提供的计划。
## 计划文件
$ARGUMENTS
读取计划文件并实现每一步。
完成时用 git diff --stat 报告更改。
步骤4: 创建代理模块
自动工作流/自动工作流_模块/代理.py:
- Claude Code子进程执行
- 请求/响应数据模型
- 输出文件处理
- 错误处理
步骤5: 创建网关脚本
自动工作流/自动工作流_杂务_实现.py:
- 接受杂务描述
- 执行 /杂务 以生成计划
- 用计划执行 /实现
- 报告结果
验证清单
设置后，验证:
- [ ]
规范/目录存在 - [ ]
.claude/命令/杂务.md存在 - [ ]
.claude/命令/实现.md存在 - [ ]
自动工作流/自动工作流_模块/代理.py存在 - [ ] 网关脚本成功运行
时间投资
| 阶段 | 时间 | 活动 |
|---|---|---|
| 设置 | 2小时 | 目录结构，基本模板 |
| 代理模块 | 2-4小时 | 核心执行代码 |
| 网关脚本 | 1-2小时 | 第一个组合工作流 |
| 总计 | 5-8小时 | MVP完成 |
扩展路径
MVP后，逐步添加:
- 第2周: 添加 /bug 和 /功能 模板
- 第3周: 为自动化添加钩子
- 第4周: 为调度添加触发器
- 第5周: 添加工作树隔离
- 第6周+: 添加完整SDLC工作流
关键记忆参考
- @代理层-结构.md - 完整结构参考
- @网关-脚本-模式.md - 脚本模式
- @模板-工程.md - 模板设计
输出格式
## 最小可行代理层设置
**项目:** {名称}
**状态:** 准备实现
### 要创建的文件
1. **规范/** (目录)
- 将包含生成的计划
2. **.claude/命令/杂务.md**
- 杂务规划模板
- 从描述生成规范
3. **.claude/命令/实现.md**
- 实现HOP
- 执行生成的计划
4. **自动工作流/自动工作流_模块/代理.py**
- 核心代理执行
- 子进程处理
- 输出管理
5. **自动工作流/自动工作流_杂务_实现.py**
- 网关脚本
- 组合杂务 + 实现
### 实现顺序
1. 创建目录
2. 添加杂务.md模板
3. 添加实现.md模板
4. 创建代理.py模块
5. 创建网关脚本
6. 测试端到端
### 估计时间
5-8小时到生产就绪MVP
常见错误
- 过度工程MVP (太早添加太多模板)
- 跳过代理.py (尝试直接调用claude)
- 网关脚本中没有错误处理
- 没有一致组织输出文件
版本历史
- v1.0.0 (2025-12-26): 初始发布
最后更新
日期: 2025-12-26 模型: claude-opus-4-5-20251101