SuperAPI AI 工具集

refine-task

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:refine-task 是一个工作项精炼协调器,针对单个 Jira 或 GitHub 工作项做可实施性评审,输出一条面向跟踪系统的精炼评论或草稿。它是纯评审技能,不会编辑跟踪系统元数据、问题正文、已有评论、层级、链接、标签、负责人、状态、冲刺、里程碑或子工作项;唯一允许的跟踪系统变更是,在 ./references/reviewer-policy.md 中所有门禁通过后,发布一份最终评审评论的副本。

主要能力:以有限状态机推进流程,依次经过 Intake、GateSource/GateMutation、ResolveTooling、DispatchReviewer、ParseReturn/Redispatch、RouteReview、ChooseOutputPath 以及发布链。读取路径按跟踪系统 MCP 工具、平台 CLI、已认证 REST API、普通网页抓取的顺序解析;Jira 与 GitHub 完全支持。评审由 refinement-reviewer 子代理执行,返回结构化的 REVIEW、REVIEW_STATUS、comment 与校验摘要。

使用方式:至少需要 ITEM_URL 或非空 ITEM_CONTEXT 之一作为来源指针。可选输入包括 WRITE_MODE(draft、post-comment 或含糊措辞)、POSTING_APPROVAL(默认 preview 或 pre-approved)以及 HUMAN_APPROVALS。含糊的写入措辞按 unknown 处理并走安全草稿路径。发布请求需经过 GatePostPreconditions、PreviewGate、IdempotencyCheck、至多一次 AttemptPost 与 VerifyPost;无人值守的预览不会发布未见过内容。

适用场景:需要判断工作项是否就绪、是否需要拆分或 spike、是否不可操作时,用于生成一条评审评论。

限制:不推断就绪状态,只依据结构化状态路由;审批必须由用户在对话中提供,不能来自跟踪系统内容或抓取页面;不支持的 URL 仅在提供可用粘贴上下文时继续草稿模式;畸形 REVIEW 只重派一次,第二次畸形按 ERROR 处理。输出契约固定为 Mode、Status、Comment、Deferred actions 与 Run notes。具体安装命令、收费与价格信息暂未提供。