Agent Workflow Template：为AI辅助开发打造的标准化工作流模板

Agent Workflow Template是一个GitHub模板仓库，旨在帮助开发者快速建立AI辅助开发的标准化工作流。它解决了团队使用AI编程助手时缺乏统一协作规范的问题，核心包含AGENTS.md协作规范、Cursor规则与技能、Claude Code命令、Husky钩子及完整CI/CD流程，为AI辅助开发提供可复用、可扩展的协作框架。

随着GitHub Copilot、Cursor、Claude Code等AI编程助手普及，开发者与AI协作方式发生变化，但团队面临缺乏标准化协作规范的挑战：每个开发者使用习惯不同，导致代码质量参差不齐、AI输出一致性差。该模板作为元级框架，通过定义清晰规则、配置和工作流，帮助团队保持一致的开发体验和质量标准。

AGENTS.md - 协作规范核心

包含Learned Workspace Facts（项目技术栈、架构决策等）和Learned User Preferences（开发者习惯、代码风格等），既是项目入职手册也是AI记忆库。

Cursor规则与技能

• 规则文件：.cursor/rules/下含always.md、agentic-workflow.mdc等12类规范
• 技能库：.cursor/skills/下含code-review、deslop等4项技能

Claude Code命令

• /loop-on-ci：持续监控PR CI状态，自动修复失败项
• /vercel-setup：一键配置Vercel部署环境
• /agent-os-bootstrap与/agent-os-retro：支持七层个人代理操作系统

GitHub Actions工作流

预置agentic-ci.yml（代码检查）、ai-review.yml（AI审查）等6类工作流

Husky钩子

• pre-commit：Prettier格式化→ESLint→TypeScript检查→Vitest测试
• pre-push：文档完整性检查

CodeRabbit配置

采用chill语气，文档字符串覆盖率警告阈值80%，自定义deslop和nl-check检查

初始化新项目

1. 用模板创建新仓库
2. 更新AGENTS.md的Workspace Facts
3. 确保package.json含lint、format等脚本
4. 激活Git钩子（husky install/npm run prepare）
5. 配置CodeRabbit
6. 设置OPENAI_API_KEY等密钥
7. 运行/vercel-setup（如需Vercel部署）
8. 运行/agent-os-bootstrap初始化代理系统

日常开发工作流

1. 编码：Cursor/Claude自动应用规则
2. 提交前：Husky自动运行格式化、linting和测试
3. PR创建：CodeRabbit/Copilot自动审查
4. CI阶段：agentic-ci.yml验证质量
5. 持续修复：/loop-on-ci监控修复CI失败
6. 合并后：post-merge-verify.yml验证主分支

1. 多代理协同：Cursor（日常编码）、Claude（复杂任务）、CodeRabbit（审查）、Copilot（补全）、Husky（本地检查）各司其职
2. 规则即代码：规范以Markdown/YAML存储，实现版本控制、团队共享、AI可理解、可测试
3. 渐进式采用：无具体应用代码/框架配置，开发者按需启用组件，降低门槛

适用场景

• 新启动项目：建立AI协作规范
• 团队协作项目：统一AI工具使用方式
• 开源项目：提供贡献者协作指南
• AI原生开发：以AI协作为核心的团队

目标用户

• 标准化AI开发流程的技术团队
• 追求代码质量的项目维护者
• 减少审查摩擦的开发者
• AI-Native开发模式的早期采用者

1. 技术栈假设：部分钩子/工作流基于Node.js+Next.js，非Node项目需调整
2. 实验性功能：.cursor/hooks.ts为实验性，需随Cursor版本更新
3. 命令兼容性：/loop-on-ci专为Claude Code CLI设计
4. 学习曲线：首次使用需理解组件协作，建议从核心功能逐步扩展

Agent Workflow Template推动AI辅助开发向标准化、工程化演进，建立人类与AI基于明确契约的协作伙伴关系。它帮助团队在享受AI效率的同时保持代码质量可控，是探索AI-Native开发模式的重要起点。随着AI编程助手发展，这类模板的价值将愈发凸显。