setup-repo

一次运行完成本仓库设置

一次运行即可让仓库能用于工程技能的入口。它是一个轻量编排器：按顺序调用两个设置基础流程，只包含顺序和路由信息——绝不复述它们的步骤或复制其内容。

标准答案（可编辑——此用户的仓库始终采用这些选项）

• 问题跟踪器：GitHub
• 空仓库（没有远程仓库，甚至可能还不是 Git 仓库）：先从当前目录创建 GitHub 私有仓库，以确保 GitHub 默认选项仍然成立（第 2 步）
• 分类标签：默认词汇（needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix）
• Agent 文件：编辑已存在的文件——如果有 CLAUDE.md 就用它，否则用 AGENTS.md；绝不创建另一个文件
• 领域文档：单一上下文（根目录下的 GLOSSARY.md + docs/adr/），除非有迹象表明这是单体仓库

流程

1. 探查

如果目录中没有 .git，则运行 git init——在仓库之外运行 git remote -v 会报错。然后执行探查步骤：检查 git remote -v、根目录下的 AGENTS.md/CLAUDE.md、GLOSSARY.md/GLOSSARY-MAP.md、docs/adr/、docs/agents/、.scratch/、单体仓库迹象，以及是否已安装 triage 技能。

2. 仓库没有远程仓库时，确保添加一个

如果探查发现完全没有远程仓库，应在设置跟踪器之前创建一个：

1. 目录已经是 Git 仓库（第 1 步）。
2. 尚无提交？创建一个最简初始提交（README.md 或 .gitignore）——空推送会失败（src refspec HEAD does not match any）。
3. gh repo create <dir-name> --private --source=. --push（默认启用 Issues；远程仓库名 = 目录名）。
4. 失败（gh 未认证／网络问题／名称冲突）→ 改为询问用户（GitHub／GitLab／本地 Markdown／其他）。

基础流程运行前必须先有远程仓库——有 GitHub 远程仓库时，其 A 部分会建议使用 GitHub，本地 Markdown 回退方案也不会触发。

3. 使用预填的默认选项运行 setup-matt-pocock-skills

按照其流程执行，但使用上述标准答案，而不是逐项询问。只有当探查证据与默认选项矛盾或缺少证据时才询问，并在每个需要询问的部分先给出推荐答案：

• 远程仓库是 GitLab → 建议使用 GitLab；完全没有远程仓库 → 第 2 步已创建 GitHub 私有仓库，GitHub 默认选项仍然成立。
• 只存在 CLAUDE.md，或两个 Agent 文件都不存在 → 需要用户选择 Agent 文件。
• 存在单体仓库迹象 → 提供多上下文布局选项。
• 未安装 triage → 静默跳过该部分。
• docs/agents/ 中已存在先前的输出 → 重新运行前先确认（只有切换跟踪器时才需要重新运行）。

该流程自身的规则仍然适用：如果 CLAUDE.md 已存在（反之亦然），绝不创建 AGENTS.md。

4. 然后运行 setup-coding-standards

它会在仓库根目录写入 CODING_STANDARDS.md（原样写入基准内容，并附上已验证的仓库惯例）。其防护规则保持不变：如果仓库已有规范文件，它会停止并报告——不会写入任何内容。

5. 一次性确认，然后写入

提供一份涵盖所有内容的草稿：## Agent skills 区块、docs/agents/* 文件，以及 CODING_STANDARDS.md 的内容。允许用户编辑后再写入。然后一次性写入全部内容。

6. 完成

报告写入了哪些内容以及写入位置。只需部分设置时，仍可单独使用这些基础流程（例如，在临时仓库中单独运行 setup-matt-pocock-skills）。

范围之外

• 扩展 ## Agent skills 区块的结构，或添加基础流程不会写入的部分：基础流程是其输出内容的唯一来源。
• 任何已有规范文件已经涵盖的内容：由用户决定要做哪些修改。