SuperAPI AI 工具集

progress-handoff

办公与效率

查看项目

更新于 10-16 05:55

技能介绍

用途:Progress Handoff 用于在长会话结束或准备移交时,从当前讨论中提炼出面向实施的交接文档(PLAN 风格),供下一次会话直接参考。

主要能力:推断目标计划文件路径;先检查仓库约定,如 plans/、docs/plans/、.pi/plans/、现有 PLAN*.md 或类似交接文件;若无约定则在仓库根目录创建 PLAN-<UPPERCASE-SLUG>.md。从讨论主题或功能中选取简短具体的话题 slug,优先使用具体产品或代码名词,避免 TASK、UPDATE、CHANGES 等模糊词;主题不明确时会先询问一个短 slug。若推断出的文件已存在,会先读取并询问是否覆盖、合并或大幅重写。将讨论提炼为可直接实施的上下文,以当前对话为主要事实来源,调用该技能的命令文本或用户指令视为最新显式交接指令;必要时才检查仓库以明确路径、命令和约束。保留持久性决策、约束、预期行为、命名选择、被否决的替代方案、真实阻塞项和影响实现的开放问题,优先保留最新可操作状态而非历史日志、已解决的不确定性或重复内容,并区分已确认决策与假设、开放问题。常规交接约 80-140 行,任务确实需要大量参考细节时才允许更长。

使用方式:默认采用精简结构,包括标题、Purpose、Current state、Next implementation slice 等;仅在具有独立后续价值时添加可选章节,如 Files to inspect first(最多 3-5 个文件或区域并说明原因)、Validation(仅非显而易见的聚焦检查、当前验证阻塞或人工 QA 提示,包含仓库或讨论中已知且对下一阶段可能有用的命令,优先使用占位符如 bun run lint:files -- <changed-files>,不要把完整命令输出复制进计划)、Open questions、Scope、Decisions and rejected alternatives、Risks and edge cases、Reference notes、Progress log(仅记录实际已完成工作、阻塞项或刚运行的验证;当 Current state 已覆盖后续所需信息时折叠或移除旧进度细节)。避免可预测的模板套话;默认不添加专门的 Next command 章节,只有当某个具体下一步命令是真实且非显而易见的立即行动或解阻项时才写入。不创建空章节。最终响应只报告:新建或更新的文件路径;建议的下一命令(如有);实施前需要回答的开放问题(如有)。

限制:不会实现代码、暂存文件、提交或推送,只产出交接计划;不能凭空确定文件约定或主题 slug,主题模糊时需先询问;文件已存在时需先确认再覆盖、合并或大幅重写;命令和验证信息需来自仓库或讨论,否则不写入。