SuperAPI AI 工具集

pflow-task-plan

办公与效率

查看项目

更新于 10-16 08:04

技能介绍

用途:为 mdtodo 任务清单中的当前活动任务生成具体实现计划。调用时先运行 .agents/skills/pflow-task-plan/scripts/plan-context.sh 获取 JSON(status、current_task、previous_tasks、next_tasks),仅对 current_task 制定计划;previous_tasks(最多 2 个刚完成)与 next_tasks(最多 2 个即将进行)仅用于理解上下文,不得纳入计划。

能力与流程:1) 澄清:先自行从代码库与项目文档中找答案,只在真正需要决策时逐个向用户提问,每个问题给出推荐答案(通过 AskUserQuestion),并沿决策分支追问到底;用户调用时附带的额外细节视为任务输入。2) 规划:把任务拆到另一智能体可正确执行的小步骤,写成 Markdown。3) 保存:用一次非交互式 Bash 调用保存计划,将完整 Markdown 通过引用式 heredoc 传入:.agents/skills/pflow-task-plan/scripts/plan-save.sh <<'PFLOW_PLAN_EOF' … PFLOW_PLAN_EOF。必须重定向 stdin,禁止使用 PTY、交互会话或 write_stdin;终止符须为计划中不出现的唯一标记且必须加引号,以保证反引号、$、$() 等按字面处理。成功后仅回复「✅ Plan saved to <plan_filename>」,不回显计划或摘要。

计划格式:使用标题与列表(非清单),至少含 Goal、Scope、Context、Affected files、Analysis、Implementation、Definition of Done。

限制与错误处理:若脚本失败(非零退出或 JSON 中 status 为 error),仅在 stdin 计划内容为空时以正确的引用式 heredoc 重试保存一次;再次失败或出现其他错误时打印 ⚠️ <error.message> 并停止,不得无限重试。若当前模式无法编辑文件,打印 ⚠️ Agent cannot write files in this mode. Switch to a mode with write access. 并停止。计划面向零上下文工程师:需真实文件路径与具体步骤,禁止 TBD 等占位表述;不添加构建检查、测试、缓存重置、规划或图表步骤;若当前里程碑文件夹有设计文档需纳入;保存前自审需求覆盖、无占位、路径名称一致。