SuperAPI AI 工具集

execute

编程与开发

查看项目

更新于 10-15 20:33

技能介绍

用途:execute 用于实现一个已规划、已批准的切片阶段(slice 的某个 phase)。前提是该阶段的设计与计划已存在、运行时阶段表(runtime phase sheet)已就绪。

必要输入:活动运行时阶段表(state/.../phases/phase-NN.md)、plan.toml / plan.md、design.md(权威设计参考)、slice-nnn.md(范围)。

主要流程:先确认阶段进入条件(EN-)满足;编码前阅读 design.md、plan.toml 与运行时阶段表,若阶段表未填先运行 /phase-plan,若输入、假设与冲突尚未澄清用 /preflight;先确定预期改动的文件或组件,并在深读或编辑前对这些路径运行 /retrieve-memory,让范围相关的陷阱与模式尽早浮现。状态须与事实一致:首个阶段开始时执行 doctrine slice status <id> started;用 doctrine slice phase 把阶段置为 in_progress,该转换会自动记录一致性边界(handler 将 code_start_oid = HEAD 写入阶段表),在 dispatch 协调上下文中会自行跳过。

实现按小而连贯的单元推进,采用 TDD 红/绿/重构:先写失败测试、令其通过、再重构;测试行为而非琐碎实现,并持续构建与改进测试辅助与夹具。每个有意义的单元后运行 /harvest;若产生值得未来检索的持久陷阱、模式或子系统事实,先运行 /record-memory。持续 lint(cargo clippy,零警告),保持代码树可构建。遵循仓库提交策略:频繁、小型约定式提交并带上切片 id(如 feat(SL-NNN): …)。若 preflight 或实现暴露未解决的设计歧义、意外障碍、权衡或策略歧义,停下来运行 /consult,不要临场发挥。运行时阶段表须随进展保持最新,不要把进度记录进 plan.toml / plan.md。

收尾:声明阶段就绪前运行验证门禁 doctrine check gate(lint + test + format),并复查触及子系统与笔记是否有遗漏的记忆捕获;阶段收束时按 code-review 技能的节奏权衡是否做阶段评审。当退出条件(EX-)与验证(VT-,以及 agent/human 的 VA-/VH- 模式)满足后,用 doctrine slice phase 把阶段翻转为 completed,这会关闭一致性边界(捕获 code_end_oid = HEAD、应用祖先/非合并守卫、把该阶段行写入切片的 arm-neutral registry);slice record-delta 仅是手动回退手段。随后交接:/phase-plan 进入下一阶段,或当切片所有阶段完成时执行 doctrine slice status <id> audit 与 /audit。

可选 solo 隔离(需显式开启):默认在树内执行;仅当用户或计划明确要求隔离时,才在实现前(第 5 步前)调用 /worktree,mode = solo、allow_work_in_place = true、branch = slice/SL-NNN-slug(如 slice/SL-NNN-<slug>)、worktree 目录按持久 id(.worktrees/SL-NNN)。/worktree 负责检测、创建阶梯(doctrine worktree fork)、供给、启动守卫与绿色基线。确认 DOCTRINE_WORKER 未设置(doctrine worktree status 会打印解析出的模式),若已设置则 unset。在 fork 内完成 TDD 循环,变绿后把 fork 落到协调分支:

doctrine worktree land --fork slice/SL-NNN-slug # merge --no-ff, ancestry preserved (NEVER squash) doctrine worktree gc --fork slice/SL-NNN-slug # reap the spent fork once the oracle proves it landed

限制:本技能仅覆盖一个已批准阶段的实现;不负责设计或计划本身;隔离为可选而非默认;具体命令与工作流依赖 Doctrine 工具链,资料未提供未列出的功能、收费或平台信息。