trackers

跟踪工具

必读：../pack-shared/standards.md。本轮应用 AGENTS.md 的 品味和架构部分，确保不遗漏工单的验收标准和约束。请勿跳过。

提问风格：../pack-shared/asking.md

此技能是 /task 或 /just-do-it 的工作步骤，不是典型的用户起始步骤。

此工具包通过 MCP 和 gh 与跟踪工具交互。请将精简的工单摘要返回到父级的内联执行上下文中；不要将其持久化到 Agent 自有状态中。Cursor Cloud Agent 关联另行处理。

请在摘要中保留工单中的品味／架构验收标准和约束。不要遗漏。

硬性规则：只读

**允许：**获取／列出／查看问题、PR、评论、状态（用于理解）、描述中的检查清单、关联的 QA 备注。

禁止（绝不可执行）：

• 更改状态／进度（“进行中”“已完成”“关闭”）
• 评论、回复或添加解决说明
• save_issue / update_issue / create / assign
• gh issue comment、gh issue close、gh pr comment（写入），或任何变更 API
• 在 ACHIEVED 后关闭或“收尾”

关闭工单是用户的工作（手动操作或合并 PR）。此技能只负责读取。

识别跟踪工具

输入	跟踪工具
IN-1234、ENG-99、TEAM-123（字母-数字）	Linear
linear.app/.../issue/... URL	Linear
#123、owner/repo#123、github.com/.../issues/123	GitHub
github.com/.../pull/N 或 PR 引用	GitHub（PR）
仅有模糊的数字	只询问一次：Linear 还是 GitHub？

除非调用方明确指定多个相关工单，否则每个有界执行上下文只处理一个工单 ID。

先发现工具

开始调用前：

1. 使用模式 linear|github 调用 GetMcpTools（或直接检查 Linear／GitHub 服务）。
2. 读取实时工具架构；优先使用读取工具（get_issue、list_comments、get_pull_request 等）。忽略写入工具。
3. 如果服务为 needsAuth，运行一次 mcp_auth，然后重新发现工具。

获取信息

Linear

优先使用匹配以下名称的 MCP 读取工具：get_issue、list_comments、list_issue_statuses（以发现到的确切名称为准——状态仅用于标注摘要，不用于写入）。

按原样传入标识符（IN-1234）。获取：

• 标题、描述、状态、优先级、标签、受指派人
• 描述中的验收标准／QA 检查清单
• 添加约束的评论（忽略纯闲聊）
• 关联的 PR／Git 分支（如有）；随后在可用时获取 PR 标题／正文／评审评论（只读）

GitHub

如果有 GitHub MCP 读取工具，优先使用；否则只使用 gh 查看／列出：

gh issue view <N> --json number,title,body,labels,assignees,state,url,comments
# or
gh issue view owner/repo#N --json number,title,body,labels,assignees,state,url,comments

gh pr view <N> --json number,title,body,url,comments,reviews,commits

如果缺少 gh 或未通过身份验证，请说明并停止；不要臆造工单／PR 正文。

整理工单摘要

# Ticket
- **ID:** IN-1234
- **Tracker:** Linear | GitHub
- **URL:** …
- **Title:** …

# Ask
<what the ticket wants, user perspective>

# Acceptance / QA (from ticket)
1. …
2. …

# Constraints
- …

# Out of scope
- … (explicit non-goals from ticket or comments)

# Linked PR (if any)
- **URL:** …
- **Summary:** …
- **Review notes worth keeping:** …

# Source
<ticket or PR URL only — do not paste the full body into every later prompt>

如果缺少验收标准，请提出一个问题，或根据 Ask 推导出二元 Done 条件（并展示以供批准）。不要将其写回跟踪工具。

调用方如何使用摘要

• 作为父级摘要、验收证据和 /code-review 的规范来源
• 在聊天中保留工单／PR 引用和相关验收标准；父级会将它们与 Git 和代码库证据结合
• 不要创建工作区、状态、计划、登记记录或跟踪工具更新

失败处理

问题	操作
没有 Linear MCP	告知用户从 Cursor MCP 工具中添加 Linear（https://mcp.linear.app/mcp），然后重试。不要伪造工单。
没有 gh／未登录	请用户安装／验证 gh，或粘贴一次问题正文。
未找到工单／PR	停止；确认 ID／团队／仓库。

反模式

• 单独调用此技能来“更新我的工单”
• 仅凭 ID 臆造标题／验收标准
• 对 Linear 或 GitHub 执行任何写入／关闭／评论操作
• 在每轮技能调用中完整粘贴工单正文（保留摘要；链接到来源）
• 使用 Cloud Agent 的 Linear 指派代替在此聊天中获取信息