72 lines
2.6 KiB
Markdown
72 lines
2.6 KiB
Markdown
|
# AGENTS.md - AI Agent 指令体系 v6
|
|||
|
|
|
|||
|
|
!!! 本指令体系采用 AB 双流程架构，请根据当前任务阶段选择对应的子目录指引。
|
|||
|
|
|
|||
|
|
## 架构概览
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
用户需求 → A部分（任务前置准备） → task-spec.md → B部分（任务执行） → 交付成果
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 目录结构
|
|||
|
|
|
|||
|
|
| 目录 | 职责 | 入口文件 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| `ai-agent-task-builder/` | A部分：任务前置准备，优化任务描述 | `claude.md` |
|
|||
|
|
| `ai-agent-exec/` | B部分：任务执行，完整实施闭环 | `claude.md` |
|
|||
|
|
|
|||
|
|
## 快速导航
|
|||
|
|
|
|||
|
|
### A部分：任务前置准备
|
|||
|
|
- **入口**：`ai-agent-task-builder/claude.md`
|
|||
|
|
- **核心文件**：
|
|||
|
|
- `AI-AGENT_preparation.md`：完整流程规范
|
|||
|
|
- `now-task.md`：用户任务描述输入
|
|||
|
|
- `undetermined-template.md`：待定项记录模板
|
|||
|
|
- **产出**：`task-spec.md`（任务细则）
|
|||
|
|
|
|||
|
|
### B部分：任务执行
|
|||
|
|
- **入口**：`ai-agent-exec/claude.md`
|
|||
|
|
- **核心文件**：
|
|||
|
|
- `AI-AGENT_execution.md`：完整执行流程规范
|
|||
|
|
- `task-spec.md`：任务细则（来自A部分或用户提供）
|
|||
|
|
- **产出**：按任务要求的交付成果
|
|||
|
|
|
|||
|
|
## 使用流程
|
|||
|
|
|
|||
|
|
### 场景一：完整流程（推荐）
|
|||
|
|
1. 用户在 `ai-agent-task-builder/now-task.md` 填写任务需求
|
|||
|
|
2. 进入 A 部分，阅读 `ai-agent-task-builder/claude.md`
|
|||
|
|
3. A 部分产出 `task-spec.md`
|
|||
|
|
4. 进入 B 部分，阅读 `ai-agent-exec/claude.md`
|
|||
|
|
5. B 部分按 `task-spec.md` 执行并交付
|
|||
|
|
|
|||
|
|
### 场景二：跳过A部分
|
|||
|
|
若用户已有清晰明确的任务细则，可直接：
|
|||
|
|
1. 将任务细则保存为 `task-spec.md`
|
|||
|
|
2. 进入 B 部分执行
|
|||
|
|
|
|||
|
|
## AB 部分差异对照
|
|||
|
|
|
|||
|
|
| 维度 | A部分（任务前置准备） | B部分（任务执行） |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 核心目标 | 优化任务描述，产出清晰的任务细则 | 按任务细则执行，完成交付 |
|
|||
|
|
| 运行模式 | 轻量化，无状态记录和git提交 | 完整流程，含状态记录和git提交 |
|
|||
|
|
| 用户交互 | 频繁确认（待定项、优化结果） | 按需交互（阻塞、验证） |
|
|||
|
|
| 产出物 | `task-spec.md` | 按任务要求的交付成果 |
|
|||
|
|
| 返工机制 | 根据用户意见返回分析优化阶段 | 回退到相应环节并记录原因 |
|
|||
|
|
|
|||
|
|
## 通用约定
|
|||
|
|
|
|||
|
|
1. **语言**：所有记录与沟通统一使用简体中文。
|
|||
|
|
2. **MCP调用**：优先使用本地工具；调用MCP前确认权限。
|
|||
|
|
3. **复杂任务**：建议调用 `mcp-sequential-thinking` 进行结构化分析。
|
|||
|
|
4. **时间戳**：所有时间戳必须由 `mcp-time` 服务获取。
|
|||
|
|
|
|||
|
|
## 版本说明
|
|||
|
|
|
|||
|
|
本指令体系为 v6 版本，采用 AB 拆分架构：
|
|||
|
|
- A部分专注任务优化，轻量运行
|
|||
|
|
- B部分专注任务执行，完整闭环
|
|||
|
|
- 两部分通过 `task-spec.md` 衔接
|