用途
Setup 技能为仓库搭建一组工程类技能所依赖的配置。它把三类约定落到仓库里：Markdown 追踪器（maps、specs、tickets 以文件形式放在 .scratch/ 下）、triage 状态词汇（五个标准状态的前置元数据字符串）、领域文档（GLOSSARY.md 与 ADR 的存放位置及读取规则）。
主要能力
- 探索仓库现状：检查根目录 AGENTS.md / CLAUDE.md 是否已有 ## Agent skills 区块；是否存在 GLOSSARY.md（或旧名 CONTEXT.md / CONTEXT-MAP.md）与 docs/adr/；.agents/ 下是否已有此前产出；docs/agents/ 是否有旧配置残留；.scratch/ 约定是否已在使用；triage 技能是否已安装。
- 分节确认：A 节问题追踪器（Markdown 文件位于 .scratch/ 下，无需认证、可与代码一起 grep，因此不提供选项，直接按种子模板写入 .agents/issue-tracker.md）；B 节 triage 状态词汇（未安装 triage 技能则整节跳过；已安装则只问一个问题：是否沿用默认状态字符串，默认值为 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix）；C 节领域文档（默认单上下文，即根目录一个 GLOSSARY.md 加 docs/adr/；仅当发现真实模块边界如 app-modules/、modules/、monorepo 布局时才提供多上下文选项，即根 GLOSSARY-MAP.md 指向各模块的 GLOSSARY.md）。发现旧命名时，草稿中会包含 git mv 重命名并把映射中的链接改好。
- 确认后写入：展示 ## Agent skills 区块草稿和每个 .agents/*.md 文件，允许用户编辑后再写。若 docs/agents/ 仍有旧副本，则将其移入 .agents/ 而非另写一套。优先编辑 CLAUDE.md，不存在则编辑 AGENTS.md，两者都没有时询问创建哪一个；已存在 ## Agent skills 区块则就地更新，不追加重复内容。
使用方式
这是提示驱动的技能，不是确定性脚本：先探索，展示发现，与用户确认，再写入。逐节处理，一节一个回答，每节先给出推荐答案以便用户一句话采纳。可用时使用 AskUserQuestion，否则在对话中提问并等待。种子模板包括 issue-tracker.md（maps、specs、tickets 的 Markdown 布局）、triage-labels.md（仅当安装了 triage 时）、domain.md（领域文档消费者规则与布局）。完成后告知用户 setup 已就绪，以及哪些技能会读取这些文件：wayfinder、to-spec、to-tickets、implement、code-review、triage。之后可直接编辑 .agents/*.md，仅在需要重新开始时才需重跑本技能。
适用场景
适合需要为仓库统一工程技能配置的团队或项目，尤其是希望 maps、specs、tickets 以可 grep 的 Markdown 文件形式与代码同仓管理的场景，以及需要统一 triage 状态词汇和领域文档（术语表、ADR）约定的仓库。
限制
- 该技能不会自动判断所有情况，仓库现状需实际读取而非假设。
- 追踪器仅使用 .scratch/ 下的 Markdown 文件，无其它追踪器选项；若仓库已有其它存放路径，仅确认该路径。
- 多上下文领域文档仅在发现真实模块边界时才提供。
- B 节在未安装 triage 技能时跳过，对应文件与区块也不写入。