关于 fix-linear-ticket
fix-linear-ticket 是一个按流程处理 Linear 工单并完成代码修复的技能，面向使用编码 Agent 维护代码库的开发者。它要求先读取工单、制定计划并等待确认，再实施和审查修改。
主要功能
- 01从 Linear 获取完整工单信息
- 02按工单内容选择处理模式
- 03依据约定创建 Git 分支
- 04提出修改计划并等待确认
- 05实施修改并检查变更
适用场景
- 01根据 Linear 缺陷工单修复代码
- 02按工单要求增加功能或维护代码
- 03复现问题并补充回归覆盖
- 04在编码前审查变更范围和风险
MCP 相关
该技能使用 Linear MCP 工具读取工单的标题、描述、评论、附件及关联信息。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/fix-linear-ticket确认已加载。
附带文件REFERENCE.md
详细介绍
修复 Linear 工单
标志
| 标志 / 参数 | 作用 |
|---|---|
<ticket-id> | Linear 工单标识符（例如 ENG-123）。从消息中提取。 |
--base <branch> | 要从其创建分支的基础分支。默认值：main。 |
--mode <mode> | auto、scratch、modify、debug、trivial。默认值：auto。 |
如果未找到工单 ID，则停止并询问：“要修复哪个 Linear 工单？ 请提供工单 ID。”
步骤 1：获取工单详情
使用 Linear MCP 工具获取完整记录：标题、描述、评论、附件、关联问题、标签、状态、优先级。切勿仅根据 ID 推断内容。如果 MCP 不可用、工单不存在或 API 出错，则停止并报告。**完成条件：**已加载完整记录，或已因错误停止。
步骤 2：分类模式
如果显式传入了 --mode，则使用该模式。否则，使用 ./REFERENCE.md 中的“模式分类”，根据工单标题、正文和标签进行分类。用一行说明选定的模式及其依据，然后继续，无需询问用户确认模式。**完成条件：**在同一行中给出一个模式及其依据。
步骤 3：确定分支名称
命名约定：pd/<type>/<ticket-id>-<slug>。
<type>：fix（错误/缺陷）、feat（功能/增强）、chore（维护/工具）、docs（文档）。不明确时默认为fix。<ticket-id>：小写。<slug>：根据标题生成 kebab-case，最多 4～5 个词。
示例：ENG-123“修复身份验证重定向循环” → pd/fix/eng-123-fix-auth-redirect-loop。
如果无法构造名称，则停止并询问。**完成条件：**已设置有效名称，或已提出询问。
步骤 4：从基础分支创建分支
git fetch origin <base-branch>
git checkout <base-branch>
git reset --hard origin/<base-branch>
git checkout -b <derived-branch-name>
报告创建的分支。**完成条件：**你已切换到新分支，且基础分支没有未提交的更改。
步骤 5：规划修复
在代码库中搜索与工单相关的文件，阅读这些文件，并列出：要修改的文件、每个文件的改动、依赖关系/顺序以及风险。遵循 ./REFERENCE.md 中的搜索策略和针对不同模式的规划重点。
提交计划，然后等待用户明确确认后再编写代码。trivial 模式下，如果只是单项文书性修改且没有逻辑风险，可以跳过确认；但仍须在执行前报告范围。**完成条件：**已提交计划，且（除 trivial 模式外）已获得用户确认。
步骤 6：实施修复
仅应用已批准的更改。保持改动聚焦且尽可能精简，不要修改无关代码。**完成条件：**已应用的更改符合已批准的计划。
- debug：先复现问题并收集证据，再修改代码；可行时添加回归测试。
- scratch：先确认目标范围和验收标准；仅在需要新建功能范围时搭建默认结构。
- modify：保留现有行为；与当前实现进行差异对比。
- trivial：直接进行小幅修改；跳过繁复的脚手架搭建。
步骤 7：审查
重新阅读每个已修改的文件，并根据 ./REFERENCE.md 中的四项审查标准检查：是否满足工单要求、是否引入回归问题、是否覆盖边缘情况，以及风格是否与周边代码一致。
报告：实施了什么、如何解决工单问题、是否存在回归问题或边缘情况，以及后续工作。**完成条件：**报告涵盖实现内容、与工单的契合度、风险及后续工作。
约束
- 此技能在审查后结束。仅在用户明确要求且不属于此技能范围时，才运行提交、构建、测试和推送。
- 始终从 Linear 获取工单内容；切勿根据 ID 推断。
- 如果找不到工单或无法确定分支名称，则停止并询问。