mcpField
G
grace-execute

grace-execute

github.com/osovv开发25642 次安装5 周前更新
代码仓库

关于 grace-execute

用于执行由已批准 GRACE spec 和 plan bundle 管理项目的工作流 Skill。它要求通过基线与最终 lint、任务验证及受控并行检查，并在应用和归档前取得明确确认。

主要功能

  1. 01已批准 bundle 与身份检查
  2. 02基线和最终 lint 门槛
  3. 03任务级验收验证
  4. 04并行安全预检
  5. 05持久状态协调
  6. 06明确的应用确认

适用场景

  1. 01执行已批准的 GRACE 项目计划
  2. 02应用 bundle 前验证工作
  3. 03项目出现未知偏差时安全停止

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/osovv/grace-marketplace --skill grace-execute

安装后在 Claude Code 中输入/grace-execute确认已加载。

附带文件agents/openai.yaml

详细介绍

要求存在一个处于 active 状态且包含已批准、身份匹配的 `spec.xml` 和 `plan.xml` 的 bundle。已批准的计划不可修改。编辑前先读取上下文、投影、断言、范围、任务依赖关系和验证要求。写入前拒绝与阶段不兼容的计划：`MustPassCommand` 必须是项目级叶子证据，目标断言和写入后的任务验证都不得调用 `--assertions current`，也不得嵌套 GRACE 生命周期命令。遇到已批准的冲突时，应取代原计划并重新规划，而不是直接修改。

<assertion_commands>

  • 写入观测结果前的活动基线预检：grace lint --path PROJECT --assertions current
  • 选定基线：grace lint --path PROJECT --change C-ID --assertions baseline（基线声明了 MustPassCommand 时，添加 --run-commands）
  • 不运行命令的选定目标：grace lint --path PROJECT --change C-ID --assertions target
  • 使用命令证据的选定目标：grace lint --path PROJECT --change C-ID --assertions target --run-commands
  • 最终状态验证：grace lint --path PROJECT --change C-ID --assertions final（目标声明了 MustPassCommand 时，添加 --run-commands）
  • 并行预检：grace lint --path PROJECT --parallel-preflight </assertion_commands>

<mode_selection> 等待用户明确选择 sequential 或 parallel-safe。并行安全模式要求显式预检通过。工作者不得修改已批准的计划；只有观测到的工作通过验证后，才由中央统一应用持久化的 .grace 变更。 </mode_selection>

<recovery_decision_table>

状态必需操作
可干净启动运行选定基线，然后执行任务。
存在部分观测写入检查声明的观测范围，并询问是继续还是回滚。
持久化状态已变更立即停止；取代原计划并重新规划。已批准的断言不可修改。
目标已满足运行最终状态验证、声明要求且用户选择启用的命令证据验证、持久化状态协调，然后请求用户明确确认应用。
存在不安全的未知漂移立即停止并报告无法解释的文件。
</recovery_decision_table>

<execution_rules>

  1. 实施前运行选定基线；如果其断言声明了 MustPassCommand，还要显式添加 --run-commands。
  2. 每次只执行一个依赖条件已满足的任务，或一个经验证可安全并行的批次。
  3. 立即运行每个任务的验收和验证。
  4. 由中央统一应用已批准的持久化上下文、图和验证变更。
  5. 协调持久化状态，运行叶子计划门禁，然后运行选定的 --assertions final，作为最外层的生命周期门禁；如果声明了 MustPassCommand，还要添加 --run-commands。最终模式会执行完整的项目 lint、评估选定目标、保持无关的已批准基线处于活动状态，并且不会重新评估所选计划已被取代的基线。
  6. 全新的最终状态证据通过后，请求用户明确确认应用。
  7. 只有此后才能将 spec 和 plan 设置为 applied，并归档完整 bundle。
  8. 切勿直接修改已批准的断言／范围／任务、绕过过时证据，或在存在未知漂移时继续操作。 </execution_rules>

评论

支持 Markdown