mcpField
S
setup-issue-tracker

setup-issue-tracker

github.com/ismail9k开发3052 次安装1 周前更新
代码仓库

关于 setup-issue-tracker

setup-issue-tracker 是用于在仓库中记录问题与意图跟踪后端及其读取、关联方式的技能。它只配置本地文件，并可在获得确认后将配置接入现有 AGENTS.md。

主要功能

  1. 01记录跟踪后端与位置
  2. 02记录问题读取和关联约定
  3. 03可选更新现有 AGENTS.md
  4. 04检查变更并汇报结果

适用场景

  1. 01为仓库配置 GitHub 问题跟踪
  2. 02设置本地 Markdown 意图文件流程
  3. 03为后续 Agent 记录跟踪规则

安装

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

$npx skills add https://github.com/ismail9k/skills --skill setup-issue-tracker

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

附带文件assets/AGENTS-sections.md

详细介绍

配置问题跟踪器

在 docs/agents/issue-tracker.md 中记录仓库的问题和意图后端，以及后续技能如何读取其中的问题，并将已完成的工作关联回对应问题。还可以选择将此配置关联到现有的 AGENTS.md，但不要接管该文件的其他内容。

此技能仅配置本地文件。它不会创建远程仓库、问题或标签，也不会创建或替换 AGENTS.md 或 CLAUDE.md。

先检查

  1. 完整阅读现有的 docs/agents/issue-tracker.md。
  2. 如果根目录存在 AGENTS.md，请阅读并检查它是否已指向跟踪器配置，或描述了从意图到 PR 的工作流。
  3. 运行 git remote -v。将常规 GitHub HTTPS 和 SSH URL 规范化为 owner/repo，并去掉末尾的 .git。如果拉取和推送 URL 不一致、存在多个可能的远程仓库，或远程仓库可能是 fork，请列出候选项，而不是自行选择。每个推断出的位置都只是提议，并不代表已确认是用户想要的跟踪器。
  4. 检查 git status，然后在更改之前总结当前状态。

确认后端

询问问题和意图应存放在哪里：

后端需要确认的配置
GitHub确认根据远程仓库推断出的 owner/repo。如果远程仓库不一致，或没有任何远程仓库能确定 GitHub，请先询问，不要猜测。提供 intent 作为标签选项，但需确认；此后端必须有标签，因为 brainstorm-to-issue 需要使用标签。
本地 Markdown确认使用 .scratch/<feature>/ 或用户指定的其他位置。
其他询问后端名称、位置，以及足够详细的自由格式工作流说明，以便其他 Agent 使用。

配置时不要检查、创建或更新远程标签。后续创建问题的工作流可在获得必要授权后执行这些操作。

确认读取和关联方式

后续技能还需要从此文件中了解另外两项内容：如何读取问题，以及如何将已完成的工作关联回来。两项都要记录，避免技能将 GitHub 语法用于非 GitHub 跟踪器。

后端需要确认的提议
GitHub使用 GitHub 自身的惯例：以 #<number> 作为引用；使用 gh issue list 和 gh issue view 读取；在 PR 正文中使用 Closes #<number>，以便合并时关闭问题；部分完成时使用 Relates to #<number>；手动关闭时使用 gh issue close。建议将这些设为默认方式。
本地 Markdown意图文件的路径就是其引用，读取意图即打开该文件。合并时不会自动关闭，因此请询问如何标记已完成的意图，例如在文件中添加状态行；由此确定哪些文件仍处于未完成状态。
其他逐项询问：引用格式、如何列出和读取问题（CLI、MCP 服务或 URL）、PR 如何写入关闭或引用问题的信息，以及如何手动关闭问题。对于 Jira，引用通常是在分支、提交或 PR 标题中使用问题键（例如 PROJ-123）；合并是否会关闭工单取决于团队的 Jira–GitHub 集成，请先询问，不要假设。

写入配置

如有需要，创建 docs/agents/，并保留其中已有的所有文件。按以下结构写入 docs/agents/issue-tracker.md：

# Issue tracker



## Backend
<GitHub, Local markdown, or the named backend>

## Location
<confirmed owner/repo, local path, or tracker location>

## Labels
<confirmed labels, or None>

## Reading
- Issue reference: <e.g. `#<number>`, `PROJ-<number>`, or the intent file's path>
- List open issues: <command, tool, or rule for which files are open>
- Read one issue: <command, tool, or path>

## Linking
- Finishing PR: <what a PR writes to close the issue on merge, or None>
- Partial PR: <what a PR writes to reference the issue without closing it>
- Close by hand: <command or step, for when no PR carries the link>

## Notes
<user-provided details, or None>

对于 GitHub，将意图标签记录为 - <label> — applied to issues created by brainstorm-to-issue。对于已有配置，请展示拟议的差异，并在替换实际值之前获得确认。如果配置是在“读取”和“关联”章节出现之前写入的，那么它只是缺少这些值，而不是已有值错误：请提议添加这两个章节，并像确认其他更改一样进行确认。使用相同值重新运行时，不执行任何更改。

连接现有的 AGENTS.md

如果根目录下不存在 AGENTS.md，请保持其不存在。跟踪器配置仍然可用；如果用户希望添加共享的仓库说明，请推荐 setup-agent-md。

如果 AGENTS.md 存在，请读取 assets/AGENTS-sections.md，并向用户展示确切缺失的条目或章节。选择跟踪器并不代表默认批准这项可选修改：请展示补丁并征得确认；也可以在同一个问题中一并确认后端。

  • 如果已有 Agent configuration 章节，请将跟踪器条目合并进去；不要重复添加标题。
  • 保留现有的 Workflow 章节。如果其中缺少意图到 PR 的步骤，请展示仅合并缺失步骤的方案。如果现有步骤与提供的工作流冲突，请展示冲突并询问应保留哪段文本。
  • 不要重排、改写或重新格式化无关的项目说明。

完成

回读跟踪器配置并检查最终差异。如果 AGENTS.md 已更改，请确认只有获批的条目或章节发生了变化。报告后端、位置、标签、读取和链接约定，以及任何刻意保持不变的文件。如果用户拒绝或推迟可选的 AGENTS.md 集成，已完成的跟踪器文件仍然有效；请如实说明这一状态。 不要创建议题或调用其他技能，直接停止。

不要做以下事情

  • 不要猜测跟踪器、GitHub 仓库、本地路径或标签。
  • 不要猜测非 GitHub 跟踪器如何读取、链接或关闭议题，也不要为其记录 GitHub 的 #<number> 和 Closes 语法。
  • 不要在本地配置期间修改 GitHub 或其他远程服务。
  • 如果已有非空的跟踪器配置，不要在未展示差异并获得确认的情况下覆盖它。
  • 不要创建 AGENTS.md 或 CLAUDE.md；这属于 setup-agent-md 的工作。
  • 不要用模板替换现有的 AGENTS.md，也不要改写无关说明。
  • 不要在配置过程中创建意图议题、规格、计划或拉取请求。

评论

支持 Markdown