用途:将一份可测试的规格说明(spec)拆解为最小的构建任务集合,每个任务可独立实现、测试和提交,并连成依赖 DAG、按层组织,使构建过程能安全推进并在图允许处并行。计划会经过自审,以发现循环依赖、顺序错误、过胖任务和幻影路径等缺陷。
主要能力:每个任务包含 id 与标题、验收标准、scopeItems 映射、写入范围(同层任务间不重叠)、切片级 validate 命令、专家路由(agent/skill/reviewer,按已安装项的描述匹配,不按名称猜测)以及备注。任务保持单一切片,写入范围最多 3 个文件或目录。计划写入唯一规范产物 .ulpi/plans/<name>.json,包含 selectedScope[]、任务级 scopeItems[] 和 scopeDrops[];不存储 markdown 副本,人类可读视图按需由脚本渲染。
使用方式:先读取 spec 与独立 intake 快照,再分解任务、连 DAG 并分层,然后运行结构门禁:node <skill-dir>/scripts/validate-plan.mjs .ulpi/plans/<name>.json --intake <absolute-snapshot.json>,退出码 1 表示需修复后重跑。可执行计划还需满足安全任务 id(如 TASK-001)、提供 validateCommand、写入范围非空、至少 2 条验收标准等要求。之后用对抗式自审循环收敛,最后报告计划路径、任务数、层数、最宽并行层与范围覆盖情况。
适用场景:需要把规格说明转化为可执行、可验证、可并行的构建计划,并作为 auto-build 输入时。
限制:spec 缺失或不可测试时应停止并回到 auto-spec;不得编造未安装的 agent/skill;不得输出幻影路径或整包 e2e 作为切片验证;范围丢弃需用户逐 id 单独确认,计划整体批准不构成证据。具体安装与运行环境细节暂未提供。