用途
Atelier Setup 用于为仓库配置 Atelier 开发工作流所需的指引。它不接管开发者的安装、harness 配置或项目结构，只负责探索仓库、呈现拟议的编辑内容，并在开发者批准后写入。该技能应在被显式调用时使用。
主要能力
探索
在提出任何变更之前先阅读仓库，包括：根目录的 AGENTS.md 和 CLAUDE.md（如果存在，并注意是否已有 ## Agent skills 标题）；根目录的 CONTEXT.md 和 CONTEXT-MAP.md；docs/adr/ 以及任何 context-local 的 docs/adr/ 目录；docs/agents/，包括已有的 issue-tracker.md 和 domain.md；已有的 issue-tracker 约定（remotes、文档中的 issue 链接、本地 issue 目录、项目指引）；真正的 monorepo 信号（workspace manifest，或带有各自源码目录的多个可独立部署包）。探索阶段不创建、安装、配置或修改任何内容。
呈现发现
总结现有内容，并推荐领域文档布局：
- 单上下文为默认：领域语言放在根 CONTEXT.md，架构决策放在根 docs/adr/。
- 多上下文仅在仓库确实存在相互独立的 bounded context 时适用。CONTEXT-MAP.md 放在根目录，指向每个上下文的 CONTEXT.md 和 docs/adr/ 目录。
- 领域文档保持惰性：在另一个 Atelier 技能解决术语或记录值得记录的决策之前，不创建 CONTEXT.md、CONTEXT-MAP.md 或 ADR 目录。
选择或确认 issue 跟踪器：
- 如果 docs/agents/issue-tracker.md 已定义跟踪器，则保留，除非开发者要求更改。
- 否则推荐由现有仓库实践指示的跟踪器，然后请开发者确认或描述其跟踪器。
- 可接受 GitHub、GitLab、本地 Markdown、开发者描述的其他跟踪器，或不使用跟踪器。
- 将所选工作流记录到 docs/agents/issue-tracker.md；不安装、初始化或创建外部跟踪器资源。
选择要编辑的指令文件：
- 如果两个文件都存在，询问哪个文件负责 agent 指引，不要重复。
- 否则在根 AGENTS.md 存在时使用它。
- 否则在根 CLAUDE.md 存在时使用它。
- 如果两者都不存在，询问要创建哪个指令文件，不要替开发者做决定。
向开发者展示所选文件、领域布局以及以下内容的精确内容：## Agent skills 区块；使用 references/issue-tracker.md 的 docs/agents/issue-tracker.md；使用 references/domain.md 的 docs/agents/domain.md。然后停止并等待明确批准。
批准后写入
将以下区块添加到所选指令文件：
## Agent skills
### Planning and implementation
Use `atelier-orchestrator` at the start of development work. It selects an Inline Plan for bounded
changes or a Spec-backed Plan when durable design and coordination artifacts are warranted.
### Issue tracking
Read `docs/agents/issue-tracker.md` when issue tracking is relevant. It defines this repository's
tracker workflow; `plan.json` remains authoritative for Spec-backed task details and dependencies.
### Domain documentation
Read `docs/agents/domain.md` before working in a domain area. It defines how to locate and use this
repository's context documents and ADRs.
如果已存在 ## Agent skills 区块，则就地更新 ### Planning and implementation、### Issue tracking 和 ### Domain documentation 子区块，而不是追加重复内容。保留其他子区块以及该区块之外的全部内容，包括用户编辑。需要时创建 docs/agents/，然后写入已批准的 tracker 和 domain 文档。不创建任何其他文件或目录。
报告
说明哪些指令文件和 agent 文档发生了变更、所选的跟踪器以及所选的领域文档布局。提醒开发者该布局只是约定：第一个领域建模或架构决策任务在有实质内容时才会创建相关文档。
使用方式
仅在被显式调用时使用。流程为：探索 → 呈现发现并等待明确批准 → 批准后写入 → 报告变更。
适用场景
需要为仓库建立 Atelier 开发工作流所需的指引文件，包括 agent 技能区块、issue 跟踪约定和领域文档约定时。
限制
不接管开发者的安装、harness 配置或项目结构；不在探索阶段做任何修改；不安装、初始化或创建外部跟踪器资源；不创建除指令文件和 docs/agents/ 下已批准文档之外的其他文件或目录；不在开发者未确认时替其选择指令文件或跟踪器。