SPEC-AGENTS.md
一个基于证据校准的AI智能体工作流框架
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SPEC-AGENTS.md。 它的用途是：一个基于证据校准的AI智能体工作流框架 完整的 Skill 内容见：https://321skill.com/skills/spec-agents-md/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请基于当前项目决策框架和路线图，规划并开始下一阶段的开发工作。” 它会首先读取`.phrase/decision.md`, `.phrase/roadmap.md`, `.phrase/current.md`三个核心文件，理解项目目标和当前进度，然后根据`.phrase/evidence.md`中的最新发现，为你制定下一阶段的具体范围、任务切片和验证计划。
介绍
SPEC-AGENTS v3旨在解决传统AI编码智能体工作流中存在的上下文冗余、记忆陈旧和决策不可靠的问题。它通过引入证据驱动的阶段规划（EDPP）和最小执行协议，将工作循环从静态文档驱动转变为动态证据驱动，核心目标是让智能体“读得更少，但读得更准”。
使用时，开发者通过命令行工具初始化项目，生成标准化的决策框架、路线图、当前阶段和证据文件。智能体在常规工作中默认仅读取决策、路线图和当前阶段三个核心文件，仅在必要时（如选择下一阶段、解决冲突时）才查阅证据档案，从而大幅降低令牌负载。
该框架适合需要AI智能体（如Claude、Cursor）辅助进行复杂、多阶段软件开发的团队或个人，尤其适用于项目规划、代码实现和验证流程需要清晰、可追溯且高效管理的场景。
与同类智能体工作流工具相比，SPEC-AGENTS v3的核心区别在于其“证据校准”和“最小上下文”理念。它不预定义未来所有任务的细节，而是强调基于当前阶段产生的“证据增量”来动态决定下一阶段，并将任务严格限定在活动阶段内，避免了传统方法中因过早规划细节而产生的信息过时和资源浪费。
核心特点
核心区别在于采用“证据驱动阶段规划”和“最小上下文读取规则”。它不预拆分未来路线图阶段的任务，而是基于当前阶段产生的证据增量动态决定下一阶段，且智能体默认只读取决策、路线图和当前阶段三个文件，极大减少了冗余信息处理。
注意事项
不适合需要高度自由、无结构化流程的快速原型构建或一次性脚本编写场景。
常见问题
SPEC-AGENTS v3和v2有什么区别？
v3从静态文档驱动循环改为更小的证据驱动循环，强调最小上下文读取和基于证据增量的阶段推进，减少了令牌负载和陈旧记忆。
如何开始使用SPEC-AGENTS？
克隆仓库并运行链接脚本，然后在项目目录中使用 `spec-agents init` 命令初始化即可生成标准工作流文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/spec-agents-md/raw/index.md 读取 SPEC-AGENTS.md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/spec-agents-md/raw/index.md（查看排版版本）