用途:为仓库搭建 Utarn 工程技能所依赖的配置,包括 issue 跟踪位置、triage 标签词表、领域文档(CONTEXT.md 与 ADR)布局。属于提示驱动的技能,不是确定性脚本,首次使用工程技能前运行一次。
主要能力:探索仓库现状(git remote、AGENTS.md/CLAUDE.md、CONTEXT.md、docs/adr、docs/agents、.scratch、是否安装 triage 技能、monorepo 信号),按推荐默认值生成配置,并写入 docs/agents/ 下的说明文件。
使用方式:先探索,再逐节采用默认值并逐行展示选择,随后起草并写入。Section A 依 remote 决定跟踪器:GitHub 用 gh CLI、GitLab 用 glab CLI、其他用本地 markdown(.scratch/<feature>/);Jira、Linear 等自定义跟踪器需用户提供工作流,应改用交互式 /setup-utarn-skills。Section B 仅在 triage 技能已安装时运行,保留默认标签 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。Section C 默认单上下文(根 CONTEXT.md + docs/adr/),发现 monorepo 信号则用多上下文(根 CONTEXT-MAP.md 指向各上下文 CONTEXT.md)。写入时优先编辑已存在的 CLAUDE.md,否则 AGENTS.md,都不存在则新建 CLAUDE.md;已有 ## Agent skills 块则原地更新。
适用场景与限制:适用于使用 Utarn 工程技能的仓库初始化。自定义跟踪器、收费与平台细节暂未提供。