mcpField
R
release-archivist

release-archivist

github.com/magebyte-zero开发87656 次安装3 天前更新
代码仓库

关于 release-archivist

release-archivist 是用于验证并结束软件变更的技能，针对直接、有限范围和旧版工作流分别规定流程。它区分逻辑收尾与经授权的合并、清理，并记录验证结果和遗留风险。

主要功能

  1. 01根据工作流状态恢复处理
  2. 02执行所需的最终验证
  3. 03检查契约与审查覆盖情况
  4. 04同步增量规格说明
  5. 05区分收尾与实际集成

适用场景

  1. 01结束已验证的计划变更
  2. 02记录未完成工作的已接受风险
  3. 03完成获授权的分支集成
  4. 04恢复待处理的验证或清理

安装

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

$npx skills add https://github.com/magebyte-zero/spec-superflow --skill release-archivist

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

详细介绍

发布归档员

捆绑运行时

执行下方 CLI 命令前，将开头的 SSF 替换为 node "<plugin-root>/scripts/spec-superflow.mjs"；<plugin-root> 是本文件上两级目录的绝对路径。切勿直接运行 SSF，也不要调用 PATH 中的 ssf。

读取 SSF resume <change-dir> --json。若处于 executing，完成验证并进行逻辑收尾。若处于 closing，且合并已获授权，则仅执行记录的待处理物理收尾操作。若处于 abandoned 或已完成收尾，则无需操作。其他状态请转入工作流启动流程。

新建直接执行／计划执行的变更

使用 SSF workflow complete <dir> --verification-command "<required check command>"。它会运行一次最终验证；调用它前不要立即运行相同的完整测试套件。计划执行还会检查已完成的任务、当前的全范围／波次评审，以及任何增量规范的发布。直接执行无需计划或评审回执。常规失败应留在 executing 状态，进行针对性修复。不要为已获授权的代码交付增加 DP-6／DP-7 或其他审批。

如果用户明确接受未完成的工作或验证失败，则使用 SSF workflow complete <dir> --accept-risk --confirm --reason "<decision and remaining issues>"。保留所有失败记录，并报告为风险已接受，而非验证成功。这样会结束代码交付，但不会合并或删除分支。普通的状态转入 closing 不能绕过失败检查。对于已验证的工作，物理集成仍是单独的授权操作。其余收尾步骤是旧版兼容流程。

有界路径

快速／直接 Hotfix／Tweak 路径需记录变更文件、针对性命令及结果，持久化 test_result: pass，然后转入 closing。Hotfix 必须证明原始症状已修复。轻量路径还需要其回执中的针对性评审和验证通过证据。这些路径不需要契约、执行计划、波次评审、审计、DP-6／DP-7 或 SSF finish。

完整／旧版 Hotfix

  1. 使用必需的构建／测试／验证命令检查最终代码快照。仅当代码、环境和命令完全相同时，才可复用近期结果；不要仅因技能发生变化就重跑相同的完整测试套件。
  2. 根据实际差异检查契约覆盖情况、设计一致性、范围和未解决的问题。注明命令／结果；不要根据编辑内容或未经核实的说法推断成功。
  3. 遵循当前计划的评审政策：Native final 需进行一次最终全范围评审；wave／旧版计划则需提供规定的波次回执。不要重复评审未变化的证据。
  4. 在 executing 状态下，使用 spec-merger 同步实际的增量规范。如果已明确省略规范且不存在增量，则不要重新创建。
  5. 运行 SSF audit <dir> 并记录验证结果（dp_6_result、时间戳和 test_result）。仅当已获得用户的归档授权或用户明确提出要求时，才记录 DP-7。不要捏造缺失的决定。
  6. 解决所有阻塞项后，运行 SSF state transition <dir> closing。这是逻辑收尾，不表示合并或清理已成功。

仅报告结果、关键验证、未解决的风险和下一步操作。保留已批准的契约和实施证据；不要将所有规划文件复制到第二份摘要中。

实际收尾

对于获准的 Full/legacy Hotfix 集成，运行 SSF finish <dir> [--test-cmd <command>]。它使用记录的目标检出/分支，在必要时执行合并，验证目标，并安全移除隔离环境。它会验证被忽略的更改产物是否已归档，并在清理前保留原目标。它绝不会强制删除未提交的工作。仅分支隔离不会删除检出目录。

验证失败时会保留隔离环境。对于记录为 verify-pending 的状态，恢复流程会提供受保护的 closing -> debugging 转换；请先诊断，在获批范围内修复，重新验证并审核，然后再关闭。已完成的收尾和已放弃的更改无法重新打开。清理失败会保持为 cleanup-pending。恢复操作会继续执行剩余步骤；每次未完成收尾的重试都会再次验证，因为即使 HEAD 相同，被忽略的依赖项、本地配置和外部服务也可能已发生变化。已完成的收尾不会重新运行验证。已完成的收尾具有幂等性。目标缺失或不明确属于实际阻碍：请先恢复来源信息，再执行合并，绝不要根据当前目录猜测目标。

如果用户要求仅交付分支而不进行合并，请保留分支/工作树并报告该状态。不要将逻辑上的关闭视为允许合并、推送或发布。

记录这些决定时，请使用 SSF state set <change-dir> dp_6_timestamp now 和 SSF state set <change-dir> dp_7_timestamp now。

评论

支持 Markdown