mcpField
T
tracer-setup

tracer-setup

github.com/scottwaterAgent 工作流142 次安装1 周前更新
代码仓库

关于 tracer-setup

tracer-setup 是通过提示驱动的技能，用于配置 Tracer 技能所需的仓库约定。它会检查现有跟踪器和领域文档，提出配置供确认，再写入达成一致的设置。

主要功能

  1. 01检查仓库远程地址和现有文档
  2. 02配置问题跟踪约定
  3. 03指定领域文档位置
  4. 04支持单上下文和多上下文布局
  5. 05更新 Agent 技能说明

适用场景

  1. 01设置 GitHub、GitLab 或本地 Markdown 跟踪
  2. 02记录仓库背景和 ADR 的位置
  3. 03明确仓库中的 Agent 工作约定

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/scottwater/skills --skill tracer-setup

安装后在 Claude Code 中输入/tracer-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

domain.md
issue-tracker-github.md
issue-tracker-gitlab.md
issue-tracker-local.md
agents/
openai.yaml

详细介绍

设置 Tracer

搭建 tracer 技能所读取的仓库配置：

  • 问题跟踪器 — /tracer-wayfinder 在哪里绘制决策地图，/tracer-to-spec 和 /tracer-to-tickets 在哪里发布内容，以及 /tracer-code-review 从哪里获取规范（GitHub、GitLab、本地 Markdown，或你描述的工作流）
  • 领域文档 — CONTEXT.md 和 ADR 存放在哪里，以及读取这些文档的使用方规则

跳过设置也没关系：每项技能都会回退到 .tracer/ 下的本地 Markdown。当你想使用真正的问题跟踪器，或想明确约定以供仓库中的其他 Agent 遵循时，再运行此技能。

这是一项由提示词驱动的技能，而非确定性脚本。先探索并展示发现，再与用户确认，然后写入文件。

流程

1. 探索

读取现有内容；不要想当然：

  • git remote -v — 是 GitHub？GitLab？没有远程仓库？
  • 仓库根目录下的 CLAUDE.md / AGENTS.md — 是否存在？是否已有 ## Agent skills 部分？
  • docs/agents/ — 是否已存在此技能之前生成的内容？
  • CONTEXT.md、CONTEXT-MAP.md、docs/adr/ — 现有领域文档
  • .tracer/ — 是否表明已在使用本地 Markdown 约定
  • Monorepo 信号 — pnpm-workspace.yaml、workspaces 字段，或包含自身 src/ 的非空 packages/*。如果没有这些信号，就按单一上下文处理，这适用于绝大多数仓库。
2. 展示发现并提问

每个部分都先给出建议答案，方便用户一句话接受。

A 部分 — 问题跟踪器。 如果远程仓库指向 GitHub，就建议使用 GitHub；如果是 GitLab 主机，就建议使用 GitLab；否则建议使用本地 Markdown。选项如下：

  • GitHub — 在 GitHub Issues 中跟踪问题（gh CLI）→ 以 issue-tracker-github.md 为模板
  • GitLab — 在 GitLab Issues 中跟踪问题（glab CLI）→ 以 issue-tracker-gitlab.md 为模板
  • 本地 Markdown — .tracer/ 下的文件（没有远程仓库的项目）→ 以 issue-tracker-local.md 为模板
  • 其他（Jira、Linear、……）— 请用户用一段话描述工作流；围绕该工作流从头编写 docs/agents/issue-tracker.md。其中必须说明如何创建和获取实现工单、表达阻塞关系，以及将工单标记为可供 Agent 处理。还必须包含寻路操作：创建/更新地图、创建决策工单并设置其父项、查询地图范围内的待处理工单、由一名协调者在并行分发前认领工单、让工作者仅处理其子工单，以及由协调者按顺序应用地图索引更新。

B 部分 — 领域文档。 默认采用单一上下文 —— 在仓库根目录放置一个 CONTEXT.md 和 docs/adr/；直接编写，无需提问。只有在探索中发现 monorepo 信号时，才提供多上下文选项（根目录的 CONTEXT-MAP.md 指向各上下文对应的 CONTEXT.md 文件）。以 domain.md 为模板。

3. 确认并写入

向用户展示 docs/agents/issue-tracker.md、docs/agents/domain.md 的草稿，以及下方的 ## Agent skills 区块；允许用户在写入前修改。如果更新已有的问题跟踪器文档，保留用户自定义内容，并添加或更新其中的寻路操作，不要整体替换文件。如果用户选择本地 Markdown，请确认 .tracer/ 已加入忽略规则；如有必要，将 /.tracer/ 添加到根目录的 .gitignore。

选择该区块所在的文件： 如果 CLAUDE.md 存在，就编辑它；否则编辑 AGENTS.md；如果两者都不存在，就询问要创建哪个。若其中一个已存在，绝不要创建另一个。如果已存在 ## Agent skills 区块，就在原处更新。

## Agent skills

### Issue tracker

[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.

### Domain docs

[one-line summary — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
4. 完成

告知用户哪些技能现在会读取这些文件（/tracer-wayfinder、/tracer-to-spec、/tracer-to-tickets、/tracer-code-review、/tracer-implement；领域文档会被所有技能读取），并说明之后通常直接编辑 docs/agents/*.md 来调整配置。切换问题跟踪器，或需要为旧版问题跟踪器文档添加寻路操作时，请重新运行此技能。

评论

支持 Markdown