SuperAPI AI 工具集

pocket-structuring

通用与其它

查看项目

更新于 10-16 07:59

技能介绍

用途:使用 Pocket CLI 将已完成的执行计划转换为 execution-plan/index.md、execution-plan/tasks/ 下每个任务一个文件,以及计划需要多阶段时的阶段清单。CLI 负责解析、分解、文件生成和日志对账,其 JSON 结果为准。

用法:使用交接或用户请求中的计划路径运行:

npx -y pocketto-pi structure "<path-to-execution-plan.md>" --json --contract 3

解析 JSON 信封。成功后报告计划功能、任务与阶段数量、生成路径,以及 CLI 是否重建了执行日志。不要从文字描述推断成功,也不要手动生成这些文件。

失败处理:检查错误和计划,修正可恢复原因(如路径错误或输入格式错误)后重跑;仅在需要缺失上下文、访问权限或人工决策时说明剩余阻塞。契约不匹配应使用兼容的 Pocket CLI 版本,不要当作计划格式错误。

限制:当计划变更会改变任务拓扑时,CLI 保护已有执行进度。--force 仅在没有执行进度时可重建拓扑。--reset 会丢弃进度并开始新的执行日志,未经用户明确授权绝不可使用。效果不明确时用 --dry-run 预览。

交接:结构化仅授权生成计划产物,本身不授权实施。成功后,仅当用户要求开始执行或已授权该交接时才继续 pocket-development,否则报告结果并停止。明确要求“结构化并执行”即视为授权,不要重复请求同一批准。pocket-development 和 pocket-closing 负责任务执行、阶段评审和阶段推进,继续多阶段计划时遵循其阶段门,不要在此重复或绕过。若用户明确要求跳过结构化,简要说明计划将保持扁平并遵从;仅当下一步不明确时追问,不要要求特定短语或反驳用户决定。