SuperAPI AI 工具集

plan-maker

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:从模糊目标、稀疏需求、代码库上下文或用户想法出发,设计 PlanWeave 包形态的计划草稿;当正式 Plan Package 尚不存在时使用。仅在用户明确请求时才写出包文件;审计已有包用 plan-auditor,执行是另一项需要执行请求的独立任务。

主要能力:按 planning checklist 检查计划结构、执行选项、验收标准与包有效性;以核心对象生命周期(创建、校验、转换、状态、存储、消费、副作用、最终输出、失败、重试、回滚、人工干预)为中心设计;保持 schema、类型、API、CLI 参数、事件、文件与 prompt 输入输出在生产者与消费者间一致;按数据流、契约边界、归属、风险或可独立验证的验收拆分任务;canvas 承载内聚交付物,task 拥有可独立验证的结果,block 表达执行与评审步骤。

使用方式:先重述目标、非目标、约束与可能的成功标准;只问阻塞性澄清问题,否则陈述假设并继续;从 README、当前代码、schema、测试、示例和邻近文档收集轻量上下文;识别核心对象、生命周期阶段、契约、风险与验证路径;起草任务、block、依赖、prompt 放置、评审关卡与验证,再用 PlanWeave 既有包概念分组进 canvas;最后列出开放假设与推荐下一步(与用户细化、用 plan-auditor 审计,或在显式请求时物化)。

适用场景:将已有强源文档转成 Plan Package 时应改用 plan-importer;无文档时需检查当前代码库以避免虚构架构;多 canvas 编排时输出 project graph 字段。

限制:不发明大型产品需求;不创建 context 节点;不创建 feedback block(反馈是运行时状态);并行任务必须真正独立并隔离或协调共享写入;物化时以包形态草稿为准,通过 PlanWeave CLI 解析工作区、写入声明的包文件并做校验,报告遗留诊断;直接编辑后需运行 canvas 范围校验,涉及 project-graph.json、canvas 边或 crossTaskEdges 时还需项目校验;高风险草稿建议导入前先审计。部分 CLI 命令、字段细节与具体操作步骤暂未提供。