SuperAPI AI 工具集

setup-repo

编程与开发

查看项目

更新于 11-06 06:29

技能介绍

setup-repo 是一个仓库脚手架技能,用于为新仓库安装一套面向生产环境的开发基础设施。根据资料,它涵盖 GitHub issue 模板、PR 模板、开发流程文档、TDD 工作流配置、hooks 以及 CI 配置。

用途 该技能用于在项目初期建立统一的协作与开发规范,尤其强调计划先行、行为优先的 TDD 以及回归测试纪律。当需要为新仓库搭建上述基础设施时使用。

主要能力

  1. GitHub Issue 模板:提供三类结构化模板。Feature Slice 模板包含用户与操作者路径保护、行为契约(Given/When/Then)、产品与设计规格、集成规格、范围内与范围外、研究与上下文来源、agent 待办清单、先写的测试及预期红灯命令、TDD 审计轨迹计划、回归风险、部署影响、文档交接说明与完成定义。Bug Regression 模板包含观察行为与预期行为、复现步骤、回归测试计划、影响范围(blast radius)、agent 待办清单、TDD 审计轨迹、文档交接说明与完成定义。Research Spike 模板包含研究问题、待比较选项、文档来源(Context7 与厂商文档)、agent 待办清单、预期输出(建议写入 docs/research/)。config.yml 禁用空白 issue,并链接项目文档索引与构建流程。
  2. PR 模板:结构化 PR 正文,包含摘要与 issue 关联(Closes #)、Why、范围内与范围外、先添加的测试(单元、集成、回归)、覆盖的回归风险、文档更新、验证清单。
  3. 开发流程文档:docs/process/development-workflow.md 规定先阅读上下文文档、先计划后编码、每个任务一个 issue 大小的分支、行为优先 TDD(红→绿→重构)、格式与类型检查门禁、行为变更同步更新文档。behavior-tdd.md 提供行为优先 TDD 清单模板、红绿提交纪律及何时需要独立提交。github-build-process.md 规定每个 PR 对应一个 issue、每个 issue 一个分支、main 分支受 PR 门禁保护、合并前经过 CI 门禁、在接入真实系统前使用确定性测试。regression-discipline.md 要求每个 bug 修复必须先有失败的回归测试,对生产事故、客户 bug、认证与计费 bug 为强制要求,并保留红绿审计轨迹。
  4. Claude Code Hooks:通过 .claude/settings.json 配置。TDD 提醒 hook(在 src/ 的 Edit/Write 前触发)在未先写失败测试就修改源码时发出警告;会话启动 hook 宣告 TDD 优先要求;学习捕获 hook(Stop/SessionEnd)从已完成工作中收集经验。
  5. 协调状态模板:docs/context/current-intent.md(当前构建内容)、docs/context/repo-practices.md(约定与模式)、docs/context/known-issues.md(已知问题)、docs/plans/active-plan.md(当前计划)。

使用方式 命令格式为 /setup-repo [--full] [--templates-only] [--hooks-only] [--process-only]。--full 默认开启,安装全部内容;--templates-only 仅安装 GitHub issue/PR 模板;--hooks-only 仅安装 hooks 与设置;--process-only 仅安装流程文档。

执行流程 调用时先检查 .github/ISSUE_TEMPLATE/ 是否存在,若已存在则跳过模板并向用户确认;检查 .claude/settings.json 是否存在,存在则合并 hooks,不存在则创建;创建 .github/ISSUE_TEMPLATE/、docs/process/、docs/context/、docs/plans/、docs/research/ 等目录;依据技能中的参考文件写入全部模板与流程文件;将 .coord/ 加入 .gitignore;最后报告创建内容。

适用场景 适合需要在新仓库中快速建立 issue 规划、TDD、回归测试与 CI 门禁规范的团队或开发者,也适合配合 Claude Code 使用以强化测试先行纪律。

限制 资料未提供该技能对语言、框架或 CI 平台的具体支持范围,也未说明除 Claude Code 之外的集成方式;价格、收费与效果信息暂未提供。