SuperAPI AI 工具集

linear-status

智能体与模型

查看项目

更新于 10-16 10:21

技能介绍

用途:作为单个 Linear 议题的只读状态与恢复检测器。当智能体不确定下一步该做什么时,从它开始。它根据议题真实状态而非记忆判断阶段,并给出缺失证据和推荐的下一个技能。

主要能力与判定阶段:setup-blocked(缺少必需的 Linear 标签、项目或组件/类型标签,运行 linear-doctor);create-issue(不存在议题或入口元数据不完整,运行 linear-create-issue);refine-plan(有 llm-refine、无有效 ready 计划或有未决产品问题,运行 linear-refine);implement(有 llm-ready 且最新有效计划 plan_status: ready,运行 linear-implement);blocked(有 llm-blocked 或最新状态评论含未解决问题,运行 linear-refine 或提出所列阻塞问题);review-handoff(有 llm-review 或最新状态评论为 review_ready,准备人工审查);repair-state(标签、描述仪表盘与评论互相矛盾、存在多个 llm-* 状态、最新标记评论无效、缺少必需的仪表盘/状态证据,或占用中的认领锁过期或矛盾)。

使用方式:可用时使用 Linear MCP 工具 get_issue 和 list_comments,并用 scripts/validate_marked_comments.ts --description <issue-description-file> <comment-file> 校验标记评论和描述仪表盘。Bun 可直接运行 .ts 脚本;Node/npm/pnpm/yarn 环境应通过 tsx 等 TypeScript 运行器执行。若读工具不可用,要求粘贴议题描述、标签、状态和最新标记评论;若写工具不可用或状态需修复,则输出 REQUIRED_LINEAR_MUTATIONS。

认领锁检查:按 docs/workflow.md 的 Claim Lock Rule 检查 in-use 认领锁。一级为结构性矛盾(仅凭标签):Done/closed 仍带 in-use、有 in-use 但无活跃工作状态或状态为 llm-ready/llm-blocked;in-use 与 llm-refine、llm-active 或 llm-review 并存属合法持有。二级为过期(需认领元数据):描述中有 linear-ai:claim 块且 now - claimed_at 超过过期阈值(默认 60 分钟,用户可覆盖)即视为过期,报告 claimed_by 与时长;有 in-use 但无 claim 块则标记不匹配并回退一级检查。对过期或矛盾锁,建议最小修复:移除 in-use 标签和 linear-ai:claim 块;除非明确以有写工具的 finalizer 身份操作,否则以 REQUIRED_LINEAR_MUTATIONS 输出。

交接输出:报告当前阶段、变化、来自标签/状态和最新标记评论的证据、缺失证据、未决阻塞、建议下一步、建议下一个技能,并询问是否还有补充;无补充后再询问是否继续推荐技能,明确命名并等待确认,不自动运行。在给出阶段诊断、缺失证据列表和推荐技能后停止,除非明确为有写工具的 finalizer,否则不改变议题状态。限制:仅覆盖单个 Linear 议题,需 Linear MCP 或手动粘贴数据,分类与阈值依赖 docs/workflow.md 定义。