AI导哈

AI辅助软件开发工作流

Agentic Workflow是一个用于AI辅助软件交付的便携式操作模型，为Copilot、MCP-enabled IDEs和命令行编码代理提供共享合约，涵盖规划、实施、调试、审查和持久记忆等功能。

  • by ant3869
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ant3869/AgenticWorkflow

使用说明

代理工作流

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.json
  • AGENTS.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

相关 MCP