mcpField
C
comet-archive

comet-archive

github.com/rpamisAgent 工作流3.2k865 次安装今天更新
代码仓库

关于 comet-archive

comet-archive 是用于 Comet 第 5 阶段归档与交付流程的 Agent 技能，指导 SDK Run 完成提案和授权、OpenSpec 归档、Git 交付及完成检查。

主要功能

  1. 01归档提案与审批
  2. 02本地、推送和 PR 交付选项
  3. 03受控 OpenSpec 归档
  4. 04明确的暂存与提交指引
  5. 05交付完成验证

适用场景

  1. 01审查归档影响和交付目标
  2. 02授权本地、推送或 PR 交付
  3. 03归档 OpenSpec 并提交变更
  4. 04验证交付已完成

安装

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

$npx skills add https://github.com/rpamis/comet --skill comet-archive

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

附带文件agents/openai.yamlreference/compat.md

详细介绍

Comet 第 5 阶段：归档

首次进入某个阶段、交接给新的 Agent 或恢复上下文时，请阅读并遵循任务上下文和产物语言。优先使用当前 continuation 或已认领 Action 的 contextRequest；在同一阶段连续工作期间，不要重复检索。

进入后返回布局时，请遵循 comet-classic/reference/classic-layout.md，将每个逻辑根目录绑定到对应目录。如果协议已在上下文中，则不要重新加载。调用 OpenSpec CLI 时使用适配器，路径使用已绑定的 <classic-*> 根目录；不要额外先运行一次 root show。

SDK 运行路径

首次进入当前 SDK 阶段、交接给新的 Agent 或恢复上下文时，请阅读阶段进入与恢复及该参考文档中当前阶段的章节。如果本会话中已有且仍有效，则复用这些内容。继续执行下方的阶段；基于 nextAction.kind 的恢复路由仅适用于没有 continuation mode 的较早版本响应。

复用同一变更、工作区和 Run 的最新有效响应：agent.continuation、data.nextAction、阶段、修订版本和路径摘要。仅在冷启动恢复、工作区或外部状态发生变化、响应版本过期，或缺少当前步骤所需信息时，才运行 comet state next <change-name> --json；加载下一个 Skill 并非再次查询的理由。运行时仍会在写入时验证当前版本和证据；缓存上下文不能绕过检查或审批。确认 data.runtimeFormat: sdk、阶段和 nextAction.kind，并在已绑定的 projectRoot 中操作；仅在路径缺失或绑定发生变化时，才运行 comet classic workspace resolve <change-name> --json。验证回执仍须有效；状态文件和报告文件都不能授权交付。对于 reconcile，使用 comet state check <change-name> archive --recover --json 检查原始 Action 以及磁盘/Git 证据。结果未知时，不要重复执行归档、提交、推送或 PR。

  1. 复用当前有效的状态、工作区和证据摘要；仅在缺少这些内容时运行 comet state check <change-name> archive --json。在 SDK 执行方法中，检查验证、绑定的分支、归档影响和无关编辑。对于推送或 PR，确认远程端和 PR 基础分支；不要在多个选项中猜测。运行 comet state propose-archive <change-name> --summary "<delivery-summary>"，并根据需要添加 --remote <name> 和 --pr-base <branch>。将 data.wait.proposalHash 保存为 <proposalHash>。复用现有的待处理 Wait。
  2. 在 decision-point.md 和 SDK 执行方法的归档和 Git 交付部分，展示当前提案和交付选项。复用明确涵盖当前归档影响和相同交付目标的授权；否则等待用户选择。运行 comet state decide-archive <change-name> --proposal-hash <proposalHash> --choice <local|push|pr|reverify|later>：local 会归档并提交，push 还会推送，pr 会推送并创建 PR，reverify 会返回 Verify，later 会保留工作并停止本次调用。如果目标或 Verify 证据发生变化，则重新检查并获取新的决策；绝不复用过期的提案哈希。
  3. 只有在获得有效的 local|push|pr 决策后，才直接应用 comet guard <change-name> archive --apply。Guard 会检查授权、分支和 Verify 收据，并在本次 Run 中将 OpenSpec 归档一次。中断后检查 state next --json 和 --recover；不要再次应用已完成的归档。
  4. 在 SDK 执行方法的归档和 Git 交付部分，检查脏工作树的归属，并明确暂存此变更的实现、归档目录、主规范以及 Design Doc/Plan 注释。检查暂存的差异，然后创建一个归档提交。SDK Guard 不执行 Git 操作。不要使用旧版的 state set branch_status、state delivery 或 archive-confirm。对于 push，仅推送已批准的远程端/分支。对于 PR，先推送，然后创建指向已批准目标的 PR。如果结果未知，重试前先检查远程端或 PR。
  5. 使用真实提交运行 comet state complete-delivery <change-name> --commit <sha>；对于 PR，添加 --pr-url <url>。此命令会验证归档提交和已批准的远程端/PR 交付，并完成 Run；它不会提交、推送或创建 PR。如果失败，则保留 Run 和决策，并处理报告的问题。只有当该响应显示 Run 已完成且后续操作状态为 done 时，才可声明交付已完成；仅在缺少终止状态时运行 comet state next <change-name> --json。

Compat 路径

剩余的原始 Runtime 步骤仅适用于 runtimeFormat: compat。阅读 Compat 操作，并继续当前阶段。SDK 不会加载该参考文档。

评论

支持 Markdown