Squad×GitHub Agentic Workflows实战直接在Issue中用/squad斜杠命令管理AI Agent团队【免费下载链接】squadSquad: AI agent teams for any project项目地址: https://gitcode.com/gh_mirrors/squad4/squadSquad 是一个开源的AI Agent 团队框架AI agent teams for any project。将它接入 GitHub Agentic Workflowsgh aw之后你可以在任意 Issue 中直接输入/squad斜杠命令一句话就能为你的仓库“组建”一支 AI Agent 团队、执行研究与规划、自动拆分任务 Issue 并产出可审查的 Pull Request。全程以人类可审查的 PR交付从不自动合并——这是它区别于黑盒自动化的核心设计。什么是 Squad为什么用斜杠命令管理 AI Agent 团队传统上让 AI 参与开发需要你在本地跑 CLI、配置 Agent、手动派发任务。Squad 把这一切搬进了你每天都在看的GitHub Issue 线程一个入口所有操作都是/squad ...命令写在 Issue 正文、Issue 评论或 PR 的 Conversation 里即可触发一支团队/squad cast会分析你的仓库语言、框架、CI、测试、文档自动组建 4~7 个角色互补的 AgentLead、前后端专家、测试、质量角色等并为每个成员生成章程charter一套流程研究research→ 规划plan→ 激活activate→ 实现implement→ 审查review→ 回顾retro构成完整的 Agentic SDLC 闭环。官方入口文档在这里docs/src/content/docs/guide/gh-aw.md配合本仓库自带的 Agentic Workflows 工作流定义 workflows/squad.md 阅读可以了解整套/squad命令是如何被路由到各个 worker 的。准备工作开始前的 3 项前置检查在 Issue 里敲下第一个/squad之前先确认这三件事要求说明GitHub 仓库已启用 Copilot激活运行与copilot审查都依赖它ghCLI 已安装并登录用gh auth login完成认证gh aw扩展已安装执行一次gh extension install github/gh-aw即可 如果你希望让 AI 编码助手替你完成接入仓库内置了专门的enlistment 技能templates/skills/gh-aw-enlistment/SKILL.md它把接入过程拆成了带明确停止条件的门禁步骤任何异常都会停下来等待人工决策而不是硬着头皮猜。快速安装步骤7 步激活 /squad 斜杠命令整个安装是零到可用的七步核心思想是在独立分支上安装 → 严格编译 → 人类审查 PR → 合并后命令才生效。下面只讲关键动作完整可复制脚本见官方指南的 Quick Start 一节。第 1 步允许 Actions 创建 Pull Request。在仓库设置Settings → Actions → General中开启Allow GitHub Actions to create and approve pull requests但保持默认 token 为只读default_workflow_permissionsread。不开启的话Squad 只能推分支再降级为一条带手动建 PR 链接的 Issue。第 2 步建一个引导分支chore/squad-gh-aw-bootstrap把安装隔离出来保证它是一个干净、可整体审查的变更。第 3 步安装 7 个工作流。用gh aw add从 Squad 官方仓库引入完整工作流集合分派器squad.md必须放第一个编译时靠它发现依赖squad-bootstrap.md放最后它是安装后的专用工作流。装完你会得到 7 对源文件 .lock.yml锁文件gh aw add \ bradygaster/squad/workflows/squad.mddev \ bradygaster/squad/workflows/squad-implement-worker.mddev \ bradygaster/squad/workflows/squad-review.mddev \ bradygaster/squad/workflows/squad-deps-worker.mddev \ bradygaster/squad/workflows/squad-retro.mddev \ bradygaster/squad/workflows/squad-improvement-worker.mddev \ bradygaster/squad/workflows/squad-bootstrap.mddevdev后缀是刻意为之新模式和修复先落在开发分支保持稳定跟随最新改进。第 4 步严格编译。首次安装如果弹出 safe-update 报告确认其中只包含文档中列出的两个可选 Secret 和 init action 后用gh aw compile --strict --approve批准最后永远再跑一次不带批准的gh aw compile --strict确保 7 个工作流全部通过。第 5 步提交并打开 bootstrap PR顺手把copilot加为审查者等待 checks 通过。第 6 步人工审查并合并。注意——只推送 bootstrap 分支、甚至只开 PR 都不会激活命令只有合并进默认分支后/squad才正式通电。第 7 步等自动 bootstrap。合并后squad-bootstrap会自动醒来分析一次仓库产出两个产物一份 draft 版 Cast PR你的 AI Agent 团队以及一条[Research Proposals] Agent-discovered repo opportunities研究 Issue。审查合并 Cast PR 后你的 Agent 团队就正式就位了。/squad 斜杠命令全清单从组队到回顾所有命令都以/squad开头按最长前缀优先匹配比如/squad plan accept scope不会被误判成/squad plan。常用命令一览分类命令作用 组队/squad cast分析仓库生成一支量身定制的 AI Agent 团队会替换旧团队 组队/squad cast 需求简报带上内联简报组队直接描述你想要的角色配置 组队/squad connect owner/repo链接到外部 Squad 源远程托管激活时同步 组队/squad adopt owner/repo把另一个仓库的 Squad 一次性复制过来此后归你所有 组队/squad status只读查看当前团队阵容不产生任何 PR 研究/squad research深度分析仓库 Issue以评论形式给出发现不建 Issue 也不建 PR 研究/squad research 关注认证缺口聚焦式研究把分析限定在指定领域 分诊/squad triage把研究发现分类为待做 / 需决策 / 排除 规划/squad plan快车道一步产出项目计划 实施计划 规划/squad plan program/plan implementation精细路线先定战略结构再拆成 PR 粒度任务 激活/squad activate审查并接收最新计划批量创建 GitHub 任务 Issue 实现/squad implement实现指定 Issue或 Epic 的下一波就绪任务派发隔离的 worker 审查/squad review对当前 PR 给出独立顾问式审查意见人类批准仍是强制的 回顾/squad retro立即触发一次共享回顾沉淀团队经验这些命令可以在Issue 正文、Issue 评论、PR Conversation 评论中触发也可以在 Actions 面板通过 Squad → Run workflow 手动派发例如cast或connect myorg/my-squad。组队实操用 /squad cast 打造你的 AI Agent 团队/squad cast是整套体系里最有仪式感的一步。执行后工作流会依次完成 7 个环节解析简报—— 结合 Issue 内容和仓库结构判断要建什么团队仓库分析—— 扫描语言、框架、CI/CD、测试、文档和项目结构团队组合—— 选出 4~7 个角色Lead 专家 至少一个质量角色命名—— 默认使用描述性命名Lead、Frontend、Tester…在简报里指定宇宙如《星际迷航》《瑞克和莫蒂》等 15 个内置宇宙或任意你喜欢的作品它会改用角色名并遵守防剧透规则脚手架替换—— 用最终的章程、路由表、注册表替换一次性激活脚手架确定性验证—— 逐条校验注册表、路由、章程与生成能力的一致性开出 Cast PR—— 在squad/cast-{repo}分支上提交完整团队等你审查。简报怎么写创建一个标题为 Cast my team 的 Issue正文描述需求即可Team spec我需要一个团队来维护 TypeScript monorepoReact 前端 FastAPI 后端。前端是优先级——无障碍和性能落后了。必备角色前端专家React、a11y、性能后端工程师Python、FastAPI测试工程师Vitest pytest。加分项DevOpsGitHub Actions、Docker。团队规模最多 5 个 Agent。然后在同一 Issue 下评论/squad cast。Squad 会把你的简报与仓库扫描结果按优先级级联合并仓库空则听 Issue 的两者都有则合并显式规格则 Issue 说了算产出一支匹配规格的团队。合并 Cast PR 后仓库根目录还会出现一份友好的 meet-the-squad.md 风格团队介绍随时/squad status即可查看阵容。研究 → 规划 → 激活一条 Issue 走完的 Agentic SDLC组队之后日常开发的推荐三件套是/squad research /squad plan /squad activate/squad research是发现阶段它会给出当前架构状态、与目标的差距分析、按区域的风险评估、带文件路径的证据、在线文档引用声明以及明确的下一步建议。全程只发评论不建 Issue、不建 PR。/squad plan是快车道跳过独立分诊和范围评审一步生成项目计划initiatives/epics/milestones 实施计划PR 粒度任务含负责人、规模、依赖、验收标准。/squad activate是唯一的突变命令需要 write/maintain/admin 权限它把已接收的计划变成真实的 GitHub 任务 Issue自动打上squad和squad:{agent名}标签、写入依赖关系与验收标准。大计划可以按阶段激活/squad activate phase 2。每次命令执行后Squad 都会在该 Issue 上更新一条生命周期状态评论当前状态、上条命令、下一步该敲什么、还有哪些可选项。换句话说你不需要记状态机Issue 线程永远告诉你下一步。对于大项目还有更精细的六步路线research → triage → plan program → plan implementation → accept → activate每一步都是人类发起的——Squad 提议你审查并批准。任务 Issue 就绪后在对应 Issue 下评论/squad implement分派器会启动一个隔离的实现 worker干活PR 出来后在 Conversation 里评论/squad review获得一份针对当前 head SHA 的顾问式审查意见。想按 Issue 标签自动路由任务给对应 Agent 的还可以参考随仓库分发的 squad-issue-assign.yml 工作流模板。仓库里会多出什么合并后你会看到这些文件Cast PR 合并后你的仓库会多出一个结构清晰的.squad/目录.squad/ ├── team.md # 完整花名册——名字、角色、专长 ├── routing.md # 工作域 → Agent 的路由表 ├── agents/ │ └── {name}/charter.md # 每个成员的章程身份与规则 ├── casting/ │ ├── registry.json # 命名宇宙映射与状态 │ ├── history.json # 宇宙使用历史 │ └── policy.json # RAI 策略允许列表 └── decisions/ # 团队决策记录初始为空 .github/agents/squad.agent.md # Copilot 自定义 Agent 定义 meet-the-squad.md # 仓库根目录的友好团队介绍从此你可以在 Copilot Chat 里squad与团队对话charter.md就是每个 Agent 的岗位说明书想改角色用/squad cast-member rename name to new-focus想淘汰成员用/squad retire name归档进_alumni/而非删除。安全设计人类审查永不自动合并把 AI Agent 团队放进 Issue 流最大的顾虑是它会不会乱来。Squad 的答案是处处留痕、步步人工从不自动合并bootstrap 安装、Cast 组队、实现 PR、回顾改进全部以 PR/Issue/评论形式交付最终合并权永远在人手里确定性验证器把关Cast 产出在打开 PR 之前会先经过 squad-cast-validator.mjs 这类本地验证脚本做路径与内容一致性校验校验失败的运行会直接给出恢复指引而不是硬开 PR权限最小化默认用内置github.token只读跨仓库或提权才需要显式配置 GitHub App / PAT且鉴权有明确优先级回顾也受控/squad retro的改进建议默认只报告提案真要自动实现必须在.squad/config.json里显式开启且改进 PR 永远保持 draft、禁止自审自合。延伸阅读官方文档与 SDK完整的接入与命令手册含升级、GitHub App 提权、PAT 回退等进阶配置docs/src/content/docs/guide/gh-aw.md一份端到端的 Agentic SDLC 演示走查docs/demo-agentic-sdlc-walkthrough.md接入技能的操作化清单含每一步的停止条件templates/skills/gh-aw-enlistment/SKILL.md7 个工作流的源码定义workflows/如果你的仓库本身就是用 Squad 开发维护的还可以直接体验自己审自己的 PR这种闭环。想深入 SDK 层面用defineSquad等构建器以代码方式定义 Agent 团队可以查看官方文档站的 SDK API Reference 如果想把 Squad 拉下来研究源码仓库地址https://gitcode.com/gh_mirrors/squad4/squadclone 后即可在本地对照本文提到的各工作流与文档文件。小结场景你敲的命令你会得到什么第一次接入bootstrap 七步 人工合并/squad斜杠命令在 Issue 中通电组队/squad cast一支 4~7 人、带章程的 AI Agent 团队PR 交付规划/squad research→/squad plan→/squad activate从证据到 PR 粒度任务 Issue 的完整链路干活/squad implement→/squad review隔离 worker 实现的 PR 独立顾问式审查沉淀/squad retro团队经验回顾与受控的改进提案Issue 是你最熟悉的工作台而/squad斜杠命令把AI Agent 团队管理搬进了这个工作台。先跑通research → plan → activate三步你会对人在环路上的 Agentic 开发有一个非常具体的体感。【免费下载链接】squadSquad: AI agent teams for any project项目地址: https://gitcode.com/gh_mirrors/squad4/squad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
