kata-linear

Linear 工单生命周期

此技能通过结构化的开始／后续／结束工作流封装通用的 /linear 技能。 使用此技能时，实际调用 MCP 时始终使用 /linear 技能。

确定模式

解析用户的请求，确定要运行哪种工作流：

用户说	模式
“开始 KAT-N”“接手 KAT-N”“实现 KAT-N”“处理 KAT-N”	开始
“完成 KAT-N”“办完 KAT-N”“KAT-N 已完成”“关闭 KAT-N”	完成
“接下来做什么”“我该处理什么”“下一个工单”“下一个问题”	后续

如果含义不明确，请询问。

确定项目

1. 检查当前工作目录中的 AGENTS.md，查找 Linear 项目引用。
2. 如果未找到，调用 list_projects 并询问用户要使用哪个项目。
3. 在本次会话剩余时间内缓存项目名称，并更新 AGENTS.md 以供日后参考。

---

模式：后续

查找下一个可执行的问题。

1. 使用状态 Todo 查询该项目的 list_issues。
2. 如果有结果，则列出这些问题。第一个 Todo 问题是建议优先处理的事项。
3. 如果没有 Todo 问题，则根据阻塞关系进行判断： a. 使用状态 Backlog 查询该项目的 list_issues。 b. 对每个 Backlog 问题，调用 get_issue，并设置 includeRelations: true。 c. 找出所有 blockedBy 条目均为 Done（或没有阻塞项）的问题。
4. 如果有多个候选项，通过以下两种方式判断能否在隔离的工作树中并行处理： a. 重新检查 Linear 工单（范围和阻塞项）；然后 b. 检查它们会涉及的当前代码边界，以发现潜在的隐式耦合。
5. 将未受阻塞的问题作为候选项列出，并说明并行处理建议／风险。
6. 如果项目有 Linear 文档（执行模型、工作流约定），使用 list_documents 和 get_document 获取文档，以了解支柱／阶段顺序。

---

模式：开始

步骤 1 — 验证问题

1. 对请求的问题调用 get_issue，并设置 includeRelations: true。
2. 检查 blockedBy 中的每个条目。确认每个阻塞项的状态均为 Done。
3. 如果有任何阻塞项尚未处于 Done 状态，则停止并报告仍未解决的阻塞项。

步骤 2 — 移至 In Progress

1. 调用 update_issue，将状态设置为 In Progress。

步骤 3 — 加载上下文

1. 阅读问题描述，查找对规格、模拟稿、文档或设计文件的引用。
2. 阅读 Linear 文档（执行模型、工作流约定），了解项目专属指引。
3. 阅读步骤 1 和 2 中找到的相关规格文件、模拟图片或设计参考。
4. 检查问题涉及区域的现有源代码。

步骤 4 — 创建功能分支

1. 使用问题响应中的 gitBranchName 字段作为分支名称。
2. 从主分支创建该分支。

步骤 5 — 总结

向用户说明：

• 问题标题和验收标准
• 阻塞状态（全部就绪）
• 已加载的上下文（规格、模拟稿、相关代码）
• 创建的分支名称
• AGENTS.md 中的任何项目专属工作流提醒（例如，TDD 要求）

---

模式：完成

步骤 1 — 收集证据

收集证据：

• PR 链接或包含更改的分支
• 测试结果（单元测试和／或 E2E）
• 能证明符合验收标准的截图／视频或规格状态参考

如果当前分支已存在 PR，使用 gh pr view 检测。

步骤 2 — 验证完成门槛

检查项目的 CLAUDE.md 或 Linear 工作流约定是否定义了硬性门槛。 常见门槛：

• 已验证所引用规格中的状态／交互
• 已附上证据链接（测试、截图或可追溯的 PR 备注）
• 差距分析项均已关闭或拆分为后续问题
• 问题检查清单中的所有验收标准均已标记为已验证
• 已完成完成定义检查清单

如果证据不足，列出缺少的内容并停止。

第 3 步 — 将证据附加到议题和 PR

1. 在议题上调用 create_comment，添加结构化的证据摘要：

   ## Completion Evidence
   - PR: [link]
   - Tests: [pass/fail summary]
   - Acceptance coverage: [which criteria verified]
   - Screenshots/video: [if applicable]
   

2. 在 PR 上添加相同的摘要作为评论。

第 4 步 — 推进后续工作

1. 在已完成的议题上调用 get_issue，并设置 includeRelations: true。
2. 对 blocks 列表中的每个议题： a. 在该下游议题上调用 get_issue，并设置 includeRelations: true。 b. 检查其所有 blockedBy 条目是否都已变为 Done。 c. 如果是，调用 update_issue，将其状态改为 Todo。 d. 报告已推进的议题。

（注意：PR 合并后，当前工单会自动变为 Done。）

第 5 步 — 总结

请列出：

• 已标记为 Done 并附有证据链接的议题
• 已推进至 Todo 的下游议题
• 建议的下一步操作

重要提醒

• 调用 get_issue 时，始终传入 includeRelations: true，以查看阻塞依赖关系。
• 始终以附加媒体作为设计规格和模型稿的准确信息来源。