Agent Teams Lite 贡献者指南：Issue-First 工作流、分支命名规范与自动化 PR 检查

【免费下载链接】agent-teams-liteSpec-Driven Development with AI Sub-Agents. An orchestrator 9 specialized sub-agents for structured feature development. Zero dependencies. Pure Markdown. Works with Claude Code, OpenCode, Cursor, and more.项目地址https://gitcode.com/gh_mirrors/ag/agent-teams-lite点击查看免费下载Agent Teams Lite 是一个零依赖、纯 Markdown 实现的 Spec-Driven DevelopmentSDD框架由 1 个编排器 9 个专业化子代理组成用于结构化特性开发可配合 Claude Code、OpenCode、Cursor 等 AI 客户端使用。本文面向新手贡献者完整拆解它的Issue-First 工作流、分支命名规范与自动化 PR 检查机制帮你一次性通过所有 CI 关卡。 项目速览Agent Teams Lite 是什么模块作用路径技能文件9 个 SDD 阶段技能 贡献流程技能skills/编排器示例各 AI 客户端的编排器配置examples/安装脚本一键安装 / 环境配置脚本scripts/官方文档概念、架构、子代理、Token 经济学docs/贡献规范工作流、分支、提交、检查规则CONTRIBUTING.md⚠️提示项目 README 中已声明该仓库归档archived后续开发迁移至gentle-ai。仓库代码仍完整可作参考学习贡献流程规范也值得借鉴到任何开源项目。快速上手Clone 仓库git clone https://gitcode.com/gh_mirrors/ag/agent-teams-lite cd agent-teams-lite克隆后即可通读 CONTRIBUTING.md——它是全部贡献规则的宪法。 Issue-First 工作流一切变更从 Issue 开始Agent Teams Lite 强制执行issue-first原则没有已批准的 Issue就不允许开 PR。完整流程只有一条主线Open Issue → 获得 status:approved → Open PR → 添加 type:* 标签 → Review Merge第 1 步选择正确的 Issue 模板空白 Issue 已被禁用配置见 .github/ISSUE_TEMPLATE/config.yml必须二选一模板适用场景自动打上的标签Bug Report报告缺陷bugstatus:needs-reviewFeature Request新功能 / 改进建议enhancementstatus:needs-reviewBug 模板必填项复现步骤、期望行为、实际行为、操作系统、AI 客户端、Shell 等定义在 .github/ISSUE_TEMPLATE/bug_report.yml功能请求必填项问题描述、解决方案、影响范围定义在 .github/ISSUE_TEMPLATE/feature_request.yml 提问类内容不要提 Issue项目约定放入 Discussions 讨论区第 2 步等待status:approved审批维护者审核 Issue 后若接受实现会添加status:approved标签。⚠️在 Issue 获得status:approved之前不要开 PR——自动化检查会直接拦截引用未批准 Issue 的 PR。第 3 步创建 PR 并关联已批准的 Issue从main拉出分支命名规则见下一节用 Conventional Commits 格式提交格式见下文使用 PR 模板创建 PR模板位于 .github/PULL_REQUEST_TEMPLATE.md在 PR 正文中用Closes #N/Fixes #N/Resolves #N关联已批准 Issue为 PR 添加且仅添加一个type:*标签详细的 AI 辅助流程还沉淀在两个技能文件中值得直接照抄执行提 Issue 流程skills/issue-creation/SKILL.md开 PR 流程skills/branch-pr/SKILL.md 分支命名规范type/description一步到位分支名必须严格匹配如下正则全小写、无空格、描述部分只允许a-z0-9._-^(feat|fix|chore|docs|style|refactor|perf|test|build|ci|revert)\/[a-z0-9._-]$11 种合法类型与命名示例对照表类型分支模式示例新功能feat/…feat/user-login修 Bugfix/…fix/zsh-glob-error杂务维护chore/…chore/update-ci-actions文档docs/…docs/installation-guide格式调整style/…style/format-scripts重构refactor/…refactor/extract-shared-logic性能perf/…perf/reduce-startup-time测试test/…test/add-setup-coverage构建build/…build/update-shellcheckCIci/…ci/add-branch-validation回滚revert/…revert/broken-setup-change# 正确的分支创建姿势 git checkout -b feat/my-feature main✍️ Conventional Commits提交信息格式详解提交信息同样受正则约束格式为type(scope): description或type: description^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\([a-z0-9\._-]\))?!?: .type必填共 11 种与分支类型一致(scope)可选小写如scripts、skills!可选标记破坏性变更breaking change常见提交信息示例feat(scripts): add multi-model setup for OpenCode fix(skills): correct engram topic key format in sdd-apply docs(readme): update installation instructions refactor(skills): extract shared persistence logic chore(ci): add shellcheck to PR validation workflow test(scripts): add setup.sh integration tests提交类型 → PR 标签映射提交类型对应 PR 标签feat/perftype:featurefix/reverttype:bugdocstype:docsrefactortype:refactorchore/style/test/build/citype:chorefeat!/fix!type:breaking-change 自动化 PR 检查4 道关卡全解析PR 打开后.github/workflows/pr-check.yml 会自动运行 4 项检查全部通过才能合并检查项验证内容不通过的原因新手高频踩坑Check Issue ReferencePR 正文含Closes/Fixes/Resolves #N忘记在 PR 正文写关联语句Check Issue Has status:approved关联的 Issue 带status:approved标签Issue 还没等到维护者批准就开了 PRCheck PR Has type:* LabelPR 恰好有 1 个type:*标签没打标签、或打了一堆Shellcheckscripts/*.sh通过shellcheck静态检查本地没跑 shellcheck 就推了脚本改动type:*标签怎么选只能选 1 个标签用途type:bug缺陷修复type:feature新功能type:docs仅文档变更type:refactor无行为变化的重构type:chore维护、工具、依赖type:breaking-change破坏性变更状态标签status:needs-review、status:approved与优先级标签priority:high/medium/low由维护者管理贡献者无需自行添加。本地预检命令# 推送前先跑一遍 shellcheck避免 CI 红灯 shellcheck scripts/*.sh # 创建 PRgh CLI 方式 gh pr create --title feat(scripts): 描述 --body Closes #N # 给 PR 添加唯一一个 type 标签 gh pr edit pr-number --add-label type:featurePR 正文必备清单对照模板逐项检查Closes #N关联已批准 Issue恰好 1 个type:*标签改动脚本已通过shellcheck技能文件至少在一个 AI 客户端中测试过行为变更时同步更新了文档提交遵循 Conventional Commits 格式提交信息中没有Co-Authored-Bytrailer 关键文件索引贡献前先看这些资料资料路径贡献流程总纲CONTRIBUTING.md技能清单索引AGENTS.md提 Issue 技能含模板字段表skills/issue-creation/SKILL.md分支与 PR 技能含命名表skills/branch-pr/SKILL.md自动化检查工作流.github/workflows/pr-check.ymlPR 模板.github/PULL_REQUEST_TEMPLATE.md项目概念文档docs/concepts.md架构说明docs/architecture.md子代理文档docs/sub-agents.md安装脚本scripts/setup.sh、scripts/install.sh❓ 常见问题 FAQQ1PR 被自动化检查挡住了怎么快速定位先看是哪个 Job 失败Check Issue Reference失败 → PR 正文没写Closes #NCheck Issue Has status:approved失败 → Issue 未获批先等维护者Check PR Has type:* Label失败 → 检查是否漏打或打了多个type:*标签Shellcheck失败 → 本地跑shellcheck scripts/*.sh修复。Q2一个 PR 里可以塞多个功能吗不建议。规则要求一个 PR 只做一个逻辑变更one logical change per PR范围越小越容易过审。Q3行为变了但只改了脚本需要更新文档吗需要。Update docs in the same PR when behavior changes 是硬性 PR 规则。Q4AI 客户端改项目时要加载哪些技能按 AGENTS.md 的索引写 Issue 前加载 skills/issue-creation/SKILL.md开 PR 前加载 skills/branch-pr/SKILL.md技能内部都带关键规则 决策树 命令速查照着执行即可。 结语一张清单带走全部规范✅ 先提 Issue用模板等status:approved✅ 分支名type/description全小写✅ 提交信息type(scope): description✅ PR 正文写Closes #N 打 1 个type:*标签✅ 推之前跑shellcheck掌握以上五点你的第一个 PR 就能顺畅通过 Agent Teams Lite 的全部自动化检查。祝贡献顺利赞分享【免费下载链接】agent-teams-liteSpec-Driven Development with AI Sub-Agents. An orchestrator 9 specialized sub-agents for structured feature development. Zero dependencies. Pure Markdown. Works with Claude Code, OpenCode, Cursor, and more.项目地址https://gitcode.com/gh_mirrors/ag/agent-teams-lite点击查看免费下载相关推荐Gentle AI 分支与 PR 提交流程实战指南issue-first 门禁、分支命名与自动化检查全解析Gentle AI 分支与 PR 提交流程实战指南issue first 门禁、分支命名与自动化检查全解析 导读 本文面向在 Gentle AI gentlccusage 贡献指南从 issue 到 PR 的自动化协作流程与提交规范ccusage 贡献指南从 issue 到 PR 的自动化协作流程与提交规范 ccusage 是一个跨 AI 编程助手Codex、Claude、GeminiAI 应用CLI开发工具Anomalib 贡献者 PR 提交流程与质量门禁全指南标题规范、分支命名与合并就绪检查Anomalib 贡献者 PR 提交流程与质量门禁全指南标题规范、分支命名与合并就绪检查 导读 本文基于 Anomalib 仓库内置的 pr workflowAI 技能提示工程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考