用途
本技能用于在首次使用一组工程技能（如 to-issues、triage、to-prd、qa、improve-codebase-architecture、diagnosing-bugs、tdd 等）之前，为当前仓库搭建它们所依赖的配置。它本身不是确定性脚本，而是一个提示驱动的流程：探索现有状态、向用户展示发现、确认三个决策、写入配置。
主要能力
- 确定问题跟踪器：让技能知道 issues 存放的位置（GitHub、GitLab、本地 Markdown 或其他如 Jira、Linear），并记录外部 PR 是否作为 triage 请求来源（仅 GitHub/GitLab 可选）。
- 配置分级标签词汇：将五个规范 triage 角色（needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix）映射到仓库实际使用的标签字符串，避免重复创建。
- 确认领域文档布局：确定是单上下文（根目录一个 CONTEXT.md + docs/adr/）还是多上下文（根目录 CONTEXT-MAP.md 指向各子上下文的 CONTEXT.md），以便相关技能读取正确的领域语言和架构决策。
- 写入配置：在 CLAUDE.md 或 AGENTS.md（优先编辑已存在的那个）中添加统一的 ## Agent skills 区块，并在 docs/agents/ 下生成 issue-tracker.md、triage-labels.md、domain.md 三个文件。
使用方式
运行该技能后，它会按以下步骤执行：
- 探索仓库现状：检查 git remote、AGENTS.md/CLAUDE.md 是否存在及是否已有 ## Agent skills 区块、CONTEXT.md 与 CONTEXT-MAP.md、docs/adr/ 目录、docs/agents/ 是否已存在、.scratch/ 是否表明本地 Markdown 跟踪约定。
- 逐一呈现三个决策（问题跟踪器、标签词汇、领域文档布局），每个决策先解释概念再给出选项和默认值，等待用户回答。
- 展示配置草稿供用户修改确认。
- 根据规则选择编辑 CLAUDE.md 或 AGENTS.md（已存在则编辑，不存在则询问用户创建哪一个），就地更新 ## Agent skills 区块而非追加重复内容。
- 使用技能内置的种子模板（issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md、domain.md）生成 docs/agents/ 下的文件；对于“其他”跟踪器，则根据用户描述从零编写 issue-tracker.md。
- 告知用户设置完成及哪些技能会读取这些文件。
适用场景
- 首次在仓库中启用这组工程技能。
- 需要将技能默认的 GitHub 约定适配到 GitLab、本地 Markdown 或 Jira/Linear 等跟踪器。
- 仓库已使用自定义标签名称，需要与技能的分级状态机对齐。
- 多上下文仓库（如 monorepo）需要明确领域文档查找路径。
限制
- 该技能为提示驱动，依赖用户交互确认，非自动化脚本。
- 仅当用户选择 GitHub 或 GitLab 时才会询问“外部 PR 是否作为 triage 来源”。
- 不会自动创建 AGENTS.md 当 CLAUDE.md 已存在（反之亦然），需用户明确选择。
- 若需切换问题跟踪器或从头开始，需重新运行该技能；日常可直接编辑 docs/agents/*.md。
- 不包含任何收费、价格或效果承诺信息。