SuperAPI AI 工具集

woostack-prepare

智能体与模型

查看项目

更新于 10-15 22:14

技能介绍

用途:woostack-prepare 是面向功能需求与已证实缺陷的“只做规划”薄编排层,最终交付一个已验证的 GitHub 规格父议题、PR 粒度的原生子议题、真实前置依赖边以及完整规划交接。交接可作为 Orchestrate 的工作上下文。它绝不修改实现源码、创建源码分支或工作树、提交、开 PR、派发 worker,也不调用 Execute 或 Orchestrate。

主要能力与阶段:Prepare 只负责总体目标分类、阶段排序、未决用户决策与最终交接,各公开阶段拥有各自契约。功能类:把完整纯文本包交给 woostack-ideate,Ideate 只询问缺失的用户决策并返回完整已验证规格;若已有完整规格或 Ideate 交接,则复用既定决策从 Harden 开始。缺陷类:先调用只读的 woostack-debug,或独立复核已提供的完整诊断包,把观察与预期行为、因果链、源码/运行时/复现证据、最小完整修正、受影响与未受影响面、风险、回归与冒烟检查带入规格;症状、告警、议题正文、PR 描述或看似合理的理论都不算证据,证据缺失、过期、矛盾或不可复现时停在诊断阻塞点。Harden:把完整规格与精确仓库/证据身份交给 woostack-harden,由其核对仓库事实与候选议题契约。Plan:把 Harden 交接、已批准规格、精确仓库/基线/证据身份与选定父范围交给 woostack-plan,Plan 是唯一发布者,负责分解最小连贯的 PR 粒度图、写入或复用 GitHub 父与子议题、只创建声明的原生前置边,并独立读回每个结果。

用法:命令为 /woostack-prepare <goal-or-defect> [--parent-issue new|<exact canonical GitHub parent URL>]。可选选择器原样传给 woostack-plan;new 表示新建一个规格父议题,已有选择器必须是精确规范的 GitHub 议题 URL。冲突、重复、格式错误、外部或缺失的发布范围会在 Plan 发布前阻塞。若指定 GitHub Project,应直接用其精确选择器调用 Plan。Prepare 没有 --run、--project、远程同步选择器、兼容别名或本地规划台账,也不发现或改动 .woostack/tmp/runs/。

限制:每个阶段包使用共享的纯文本规划输入与交接契约,需包含精确规范仓库、已准入的不可变基线、检出身份、证据身份与范围化观察、完整内容以及发布前为空的未决问题区。成功结果报告已验证规格父议题 URL、按显示顺序的子议题 URL 与稳定任务 ID、规范化原生技术前置图、读回所用仓库/基线与证据身份,以及完整规划交接,并可能附带建议命令 /woostack-orchestrate --issue <verified specification-parent-URL>,该命令只是交接提示。仅父议题结果、缺失子议题/契约、成员关系含糊、依赖含义未知、必需成功读取分页不完整、变更结果未知或 Plan 读回不完整,都不算完整发布;应保留已确认 URL/ID 并从首个未证实关系或读回边界恢复 Plan,绝不重放创建或分配替代项。即使输入是小修复、含“fix”“build”“complete”等词或已批准的单 PR 请求,Prepare 仍停在已验证父议题加可执行子议题;直接实现需显式选择 woostack-execute。