SuperAPI AI 工具集

refine-issue-plan

设计与创作

查看项目

更新于 10-15 22:17

技能介绍

用途:将不完整的 issue 上下文转化为可实施的计划,同时不丢弃原始请求。该技能把分析、审批、issue 变更与实现分开处理。

主要能力:解析任务,确认 tracker、仓库或项目及 issue;核对本地检出是否属于该 issue;阅读 issue 正文、评论、附件、元数据、关联设计与子链接;把当前对话作为规划证据,记录已批准决策、被否决选项、约束与有意占位符;检查仓库上下文以获取可发现事实,而非询问用户;分析阶段仅使用只读操作。

就绪审计:只总结影响执行的内容,包括期望结果、可复用实现与资产、缺失行为或依赖、受保护或生成区域、已确认决策与占位符、未决问题、验证约定;区分事实、决策、假设与开放问题,不编造 URL、文案、API、归属或验收标准。

保留或拆分:当工作产生一个连贯可评审结果、涉及一个紧密相关区域、可在一次变更中完成验证、无独立前置或并行工作流时,优先保留为单个 issue;仅当存在真实边界(如独立价值的前置 schema、契约、基础设施、迁移或共享资产,可独立实现评审的多个结果,不同负责人,需隔离发布验证,或范围过宽)时才建议拆分。测试应与其验证的行为放在一起,不因文件多、步骤多或测试用例多而拆分。

拆分时:若可用则使用 $split-issue-into-subissues 并遵循其审批与保留流程,传入已检查的 issue 上下文、现状审计、已确认决策与未决问题;不可用时给出拆分建议并请用户授权。

单 issue 时:起草实施简报,保留原始 issue 正文作为来源请求,默认追加受管区段而非重写,区段以 <!-- implementation-brief:start --> 与 <!-- implementation-brief:end --> 标记,包含目标、已确认决策、范围、用户流程、实现要求、验收标准、范围外、依赖与开放问题、验证等标题,并按任务调整,省略无意义部分。

写入前预览:展示保留或拆分结论、现状审计、完整简报、相关元数据变更,并声明保留所有无关内容;在创建、编辑、链接、指派、打标签或关闭 issue 前需获得明确批准。

安全更新:批准后立即重读 issue,逐字保留原标题与无关正文,首次追加标记区段,后续仅替换标记之间内容;若存在类似未标记计划,先预览协调方案;只应用已批准的元数据变更;重新获取并验证内容、链接、附件与元数据;除非用户另行授权,不实施仓库变更。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息;该技能本身不实现代码变更。