SuperAPI AI 工具集

slate-plan

编程与开发

查看项目

更新于 10-16 07:09

技能介绍

用途

Slate Plan 是一个针对 Slate v2 架构/API 方案的两阶段评审与执行技能。它面向反复出现「严苛、绝对最优 Slate v2 架构/DX」评审需求、且易陷入「增量建议致死」模式的场景。当用户询问某方案是否在以下方面达到最优形态时使用:React 19.2 运行时性能、无倾向性的 Slate 式开发体验、Plate 与 slate-yjs 迁移、可证明无回归的浏览器行为、Lexical / ProseMirror / Tiptap 证据、shadcn 式可组合性与最小 props。

不适用场景:狭窄的 bug 修复或浏览器复现;对 diff 的常规代码评审;没有任何方案或架构/API/规范形态的请求(应改用 task 或特定 issue 技能)。

两个阶段

  • 规划模式(默认):创建或更新可执行方案,对其进行打分,并以活动 goal 作为持久的 lane 契约,直到所有必需的 pass、issue/引用同步门、验证门与关闭评分门全部完成。评分只是输入之一,高分本身不允许达成目标;规划完成意味着完整 pass 计划关闭且方案已可供用户评审。
  • 执行模式:仅在用户明确接受就绪方案并再次调用 slate-plan 指向该方案后启动。执行模式为已接受方案的实现目标创建或继续一个新 goal,然后以新的验证证据执行下一个计划执行者。不得将规划 goal 用作执行 goal,用户评审边界是真实存在的。

硬性策略

规划模式下不得修改 Slate v2 实现代码,只可编辑其明确拥有的规划、研究、issue 台账与 PR 引用工件。执行模式下,仅当最新用户消息明确接受就绪方案或要求执行该命名方案时,才可编辑 .tmp/slate-v2 的实现、测试、示例、包文件、构建配置与相关引用文档。「go」「rewrite」「feel free to build」「fix it」「execute」等短语在方案尚未就绪时不能覆盖规划模式,需转化为方案决策与证明行。

要求以 autogoal 作为生命周期内核、以 --template slate-plan 作为方案外壳,每次激活执行一个计划 pass。Slate Plan 负责 pass 计划、记分卡、台账、工作区证明与最终交接;autogoal 负责目标冲突、完成与阻塞语义。

主要能力与要求

  • 保持 Slate v2 无倾向性,倾向性产品 API 由 Plate 负责。
  • 破坏性或范式变更需要采用故事,「架构更干净」本身不构成理由。
  • 意图、结果、范围、非目标与决策边界必须在方案可评为就绪前明确。
  • 重大决策需要决策简报:原则、首要驱动因素、可行选项、被拒替代方案及选择理由。
  • Plate/slate-yjs 迁移指架构骨干,而非支持其当前公开 API;必须的证据是基底层面的:state/tx 扩展命名空间、schema/spec 策略、确定性操作/快照/提交、提交元数据与本地目标语义。
  • 方案不得自我认证,评分、裁决与保留/弃用决策需引用证据。
  • 工作区验证属于证据的一部分:plate-2 命令仅证明规划、台账与完成态工件;任何 Slate v2 源码、运行时、浏览器、包、公开 API 或 issue 修复声明,都必须从实时 .tmp/slate-v2 工作区以相关命令验证。在 plate-2 中运行的 bun run test、typecheck、lint、Playwright 或包过滤不计为 Slate v2 验证。

必需工件

  • docs/plans/ 下的方案文件(由 slate-plan 模板生成)。
  • 规划模式的活动 goal:一条 lane 用一个简短的 create_goal 目标(240 字符内),命名期望的关闭方案状态、简短完成阈值与方案路径。
  • 执行模式的活动 goal:用户明确接受后,为已接受方案路径与实现目标启动新 goal。
  • 研究更新(docs/research/,当证据 lane 过时或不完整时)。
  • 方案中的 issue 台账核算;当方案变更公开 API、运行时、浏览器行为、示例、issue 声明或 PR 叙述时执行 ClawSweeper 相关 issue pass。
  • issue 发现以台账/缓存优先,复用 docs/slate-v2/ledgers/ 与 docs/slate-issues/ 中的既有输出,不从 Slate Plan 运行宽泛的 gh issue list 或搜索。
  • 各类台账与引用同步:fork-issue-dossier.md、issue-coverage-matrix.md、gitcrawl-v2-sync-ledger.md、pr-description.md 等。
  • 方案中的维护者异议台账、评审增量、意图/边界记录、决策简报、生态策略综述、适用实现技能评审说明。

使用方式

使用 autogoal 脚本以 slate-plan 模板创建方案:

node .agents/skills/autogoal/scripts/create-goal-scratchpad.mjs --template slate-plan --title "<short Slate Plan title>"

默认方案路径:docs/plans/YYYY-MM-DD-slate-v2-absolute-architecture-review-plan.md。每次激活执行一个 pass;pass 是方案中的行,而非独立 goal。若没有 goal 工具,需在方案中记录降级控制状态,并在自主 pass 工作前停止,除非用户明确接受。

适用场景与限制

适用于 Slate v2 架构、公开 API、hooks、运行时边界或渲染契约的评审,以及在第二次明确调用命名已接受方案后,针对实时 .tmp/slate-v2 工作区执行用户已接受的方案。限制包括:实时源码优先,陈旧文档与已关闭方案不构成当前 API 证据;不得编造当前状态(应写 decision/target/gap);相关 .tmp/slate-v2 命令失败会使方案或执行评审保持待定;关闭状态不得矛盾。

公开资料未提供该技能的收费、价格、平台范围或效果数据。