代理工作流
Agent Workflow是一种用于人工智能辅助软件交付的可移植操作模型。它为Copilot、启用MCP的IDE和命令行编码代理提供了一个共享的契约，用于规划、实现、调试、审查和持久内存。
这个仓库的第一个版本是一组专业提示。这个版本将它变成了一个可用的工具包：
- 版本化的工作流清单：
workflow/default.workflow.json - 专家提示定义：
specialists/*.xml - 复制品和代理指令模板：
templates/ - 用于验证和安装的无依赖性CLI：
bin/agentic-workflow.mjs - CI验证：
.github/workflows/validate.yml - 采用和操作文件：
docs/
为何重要
代理发展不需要更模糊的角色扮演。它需要在上下文重置中幸存下来的交接，看到证据的审查人员，以及存储决策而不是记录的记忆。
代理工作流围绕五个角色构建：
| 角色 | 作业 | 输出 |
|---|---|---|
| 建筑师 | 将模糊的工作形成一个范围明确的计划 | 验收标准、计划、风险 |
| 实施者 | 做出最小的连贯更改 | 差异、文档、验证说明 |
| 调试器 | 验证行为并隔离故障 | 复制、根本原因、检查输出 |
| 审阅者 | 发现正确性和可维护性风险 | 有序发现和剩余风险 |
| 历史学家 | 保持持久的学习 | 决策、结果、后续行动 |
每个角色在清单中都有一个切换目标和质量门。只有当下一个角色有足够的证据继续而不重放完整的聊天时，工作流才完成。
快速开始
验证此存储库：
npm test将工作流安装到另一个存储库中：
node ./bin/agentic-workflow.mjs init /path/to/your/repo验证已安装的存储库：
node ./bin/agentic-workflow.mjs validate /path/to/your/repo从清单中呈现角色提示：
node ./bin/agentic-workflow.mjs render-prompt architect安装什么
init 将可移植工作流表面写入目标存储库：
.agentic/workflow.jsonAGENTS.md.github/copilot-instructions.md.github/instructions/tests.instructions.md.github/prompts/architect.prompt.md.github/prompts/implementer.prompt.md.github/prompts/debugger.prompt.md.github/prompts/reviewer.prompt.md.github/prompts/historian.prompt.md.vscode/mcp.json
使用 --force 故意覆盖现有文件。
仓库的规划
.
├── bin/
│ └── agentic-workflow.mjs
├── docs/
│ ├── adoption-guide.md
│ └── operating-model.md
├── examples/
│ └── .agentic/session.md
├── specialists/
│ ├── architect.xml
│ ├── implementer.xml
│ ├── debugger.xml
│ ├── reviewer.xml
│ └── historian.xml
├── templates/
│ ├── AGENTS.md
│ ├── .github/
│ └── .vscode/
└── workflow/
├── agentic-workflow.schema.json
└── default.workflow.json当前平台对齐
截至 2026-04-30T20:41:26-05:00，目前的官方文件支持此回购的方向：
- GitHub Copilot支持存储库指令、特定路径指令、提示文件和代理指令文件，如
AGENTS.md. - VS Code建议使用基于文件的自定义指令和提示文件，而不是基于旧设置的生成指令。
- MCP将提示定义为用户控制的可重用模板，将工具定义为具有人工批准界面的模型控制的外部操作。
代理工作流使用这些原生表面，而不需要专有运行时。
MCP配置
回购保持 .vscode/mcp.json 作为启动器配置。安装模板有意最小化：
- 当前文档查找的Context7。
- Playwright MCP用于浏览器/UI验证。
当您的团队有具体的证据需求时，添加Octocode、PAMPA、Clear Thought或其他MCP服务器。将令牌和凭据保存在存储库之外。
文档
发展
此项目有意没有运行时依赖关系。
npm run validate
npm run smoke
npm test许可证
阿帕奇-2.0