linear-doctor

Linear Doctor

在工作流执行前或无法确定设置状态时，将此作为设置检查。

Linear MCP Contract

在可用时使用以下 Linear MCP 工具：

• list_teams - 读取可用团队。
• list_projects - 读取可用项目及其所属团队。
• list_issue_labels - 读取类型、组件、LLM 和 Superpowers 标签。
• 无需使用 save_issue；除非 Agent 被明确要求修复现有问题，否则设置诊断为只读。

使用以下内容捕获并验证实时元数据：

scripts/linear_metadata.ts capture --teams linear-teams.json --projects linear-projects.json --labels linear-labels.json > linear-metadata.json
scripts/linear_metadata.ts validate --metadata linear-metadata.json

使用 Agent 可用的本地 JavaScript 包管理器或运行时：Bun 可直接运行 .ts 脚本；Node/npm/pnpm/yarn 环境应通过 tsx 等 TypeScript 运行器运行这些脚本。

如果 Linear MCP 读取工具不可用，请索取导出的团队、项目和标签。如果 Linear MCP 写入工具不可用或不支持创建标签，请输出 REQUIRED_LINEAR_MUTATIONS，并列出确切的设置变更。

Required Setup

报告缺失的 llm-* 工作流标签：

• llm-refine
• llm-ready
• llm-active
• llm-blocked
• llm-review

报告缺失的认领锁定标签（不属于 llm-* 状态机）：

• in-use

报告缺失的 sp-* Superpowers 阶段标签：

• sp-clarify
• sp-plan
• sp-implement
• sp-review
• sp-verify

报告缺失的组件标签、类型标签、目标团队和目标项目。组件、类型和项目名称因工作区而异，因此请根据 Linear 实时元数据提出可能的值，而不要硬编码过时的列表。

Step Completion Handoff

报告：

• 当前阶段
• 有何变更（如果本次 doctor 检查修复或澄清了设置）
• 来自实时团队、项目和标签的证据
• 缺失的证据
• 未解决的阻碍
• 建议的下一步
• 建议的下一个技能

询问设置步骤是否还有其他内容需要补充。如果有，请继续当前步骤，检查该设置项。如果没有，建议进入下一个工作流步骤；新问题通常进入 linear-create-issue，现有问题通常进入 linear-status。

用户回答“没有”后，询问是否要继续使用建议的下一个技能。明确指出建议的技能名称并等待用户确认；不要自动运行该技能。

使用以下回复格式：

• 当前阶段
• 有何变更
• 证据
• 缺失的证据
• 未解决的阻碍
• 建议的下一步
• 建议的下一个技能
• 问题：进入下一步之前，还有其他内容需要补充吗？
• 问题：要继续使用建议的下一个技能吗？

设置已就绪，或确切的 REQUIRED_LINEAR_MUTATIONS 列出了缺失的标签／项目／状态后，即停止。