2.6 KiB
Executable File
2.6 KiB
Executable File
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部分或用户提供)
- 产出:按任务要求的交付成果
使用流程
场景一:完整流程(推荐)
- 用户在
ai-agent-task-builder/now-task.md填写任务需求 - 进入 A 部分,阅读
ai-agent-task-builder/claude.md - A 部分产出
task-spec.md - 进入 B 部分,阅读
ai-agent-exec/claude.md - B 部分按
task-spec.md执行并交付
场景二:跳过A部分
若用户已有清晰明确的任务细则,可直接:
- 将任务细则保存为
task-spec.md - 进入 B 部分执行
AB 部分差异对照
| 维度 | A部分(任务前置准备) | B部分(任务执行) |
|---|---|---|
| 核心目标 | 优化任务描述,产出清晰的任务细则 | 按任务细则执行,完成交付 |
| 运行模式 | 轻量化,无状态记录和git提交 | 完整流程,含状态记录和git提交 |
| 用户交互 | 频繁确认(待定项、优化结果) | 按需交互(阻塞、验证) |
| 产出物 | task-spec.md |
按任务要求的交付成果 |
| 返工机制 | 根据用户意见返回分析优化阶段 | 回退到相应环节并记录原因 |
通用约定
- 语言:所有记录与沟通统一使用简体中文。
- MCP调用:优先使用本地工具;调用MCP前确认权限。
- 复杂任务:建议调用
mcp-sequential-thinking进行结构化分析。 - 时间戳:所有时间戳必须由
mcp-time服务获取。
版本说明
本指令体系为 v6 版本,采用 AB 拆分架构:
- A部分专注任务优化,轻量运行
- B部分专注任务执行,完整闭环
- 两部分通过
task-spec.md衔接