用途:在首次运行 Linear AI 工作流前,或标签、项目缺失、配置状态不确定时,用 Linear Doctor 做一次只读的安装检查。
主要能力:通过 Linear MCP 工具读取团队、项目和标签,核对工作流所需配置。需要检查的标签包括 llm-* 工作流标签(llm-refine、llm-ready、llm-active、llm-blocked、llm-review)、状态机之外的占用锁标签 in-use,以及 sp-* Superpowers 阶段标签(sp-clarify、sp-plan、sp-implement、sp-review、sp-verify)。同时报告缺失的组件标签、类型标签、目标团队和目标项目。组件、类型和项目名称因工作区而异,应基于实时元数据提出候选值,而不是硬编码旧列表。
使用方式:优先使用可用的 Linear MCP 读取工具 list_teams、list_projects、list_issue_labels。诊断默认只读,除非明确要求修复已有 issue,否则不需要 save_issue。可用脚本捕获并校验实时元数据: 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 使用本地可用的 JavaScript 包管理器或运行时:Bun 可直接运行 .ts 脚本;Node/npm/pnpm/yarn 环境应通过 tsx 等 TypeScript 运行器执行。若 Linear MCP 读取工具不可用,则请求导出的团队、项目和标签;若写入工具不可用或不支持创建标签,则输出 REQUIRED_LINEAR_MUTATIONS,列出确切的配置变更。
输出与交接:按当前阶段、变更内容、实时证据、缺失证据、未解决阻塞、建议下一步、建议下一技能的结构报告,并询问是否还有补充。若没有,建议进入下一步,通常是新 issue 用 linear-create-issue,已有 issue 用 linear-status。在用户确认前不要自动运行下一技能。
限制:该技能是只读诊断,不负责自动修复;缺失事实如具体工作区标签值需从实时元数据获取,资料未提供固定清单。