网络安全后端【免费下载链接】PeerBanHelperAutomatically block unwanted, leeches and abnormal BT peers with support for customized and cloud rules.| BT 反吸血工具 - 自动封禁不受欢迎、吸血和异常的 BT 客户端并支持自定义规则。支持 qB/qBEE/Deluge/BiglyBT/BitComet项目地址https://gitcode.com/gh_mirrors/pee/PeerBanHelper点击查看免费下载本文基于 PeerBanHelper 仓库中 OPSX 实验工作流的核心操作命令文档系统讲解如何用openspecCLI 与 Agent 协作在一次操作中批量归档多个已完成变更change并妥善处理多个变更之间的 spec 冲突。读完本文你将掌握从列出活动变更到智能解析冲突、同步 delta spec、执行归档、输出汇总的完整批量归档方案并理解其与单条归档、spec 同步等命令的协作关系。背景OPSX 工作流与批量归档的定位PeerBanHelper 仓库的 .claude/commands/opsx/ 目录下维护着一组以/opsx:*形式触发的 Claude Code 命令用于支撑一套实验性experimental的 OpenSpec 规范驱动开发工作流。与之配套的 .claude/skills/ 目录存放了功能等价的 skill 定义如openspec-bulk-archive-change、openspec-sync-specs、openspec-archive-change等二者共享同一套步骤与守则。仓库根目录的 openspec/config.yaml 声明了工作流采用的 schema 为spec-driven并预留了context项目背景与rules按 artifact 类型的规则两个可选配置位。在 OpenSpec 规范驱动流程中一次变更change从openspec new change name创建开始依次产出 proposal、specs、design、tasks 等 artifact经 apply实现与 verify校验后最终归档。当多个变更并行开发并先后完成时逐条执行/opsx:archive效率低下此时便需要批量归档Bulk Archive一次操作归档多条变更并对多个变更同时改动同一 capability 规范的情况做智能化冲突解析。本文讲解的核心命令文档为 .claude/commands/opsx/bulk-archive.md其对应 skill 定义为 .claude/skills/openspec-bulk-archive-change/SKILL.md。一、批量归档的整体流程概览批量归档命令不需要任何输入参数Agent 会通过交互提问引导用户逐步完成。整个操作分为 9 个阶段步骤动作关键命令/依据1获取所有活动变更openspec list --json2让用户多选要归档的变更AskUserQuestion多选3批量校验每个变更的状态openspec status --change name --json、读取tasks.md、检查specs/4检测 spec 冲突构建capability - [changes]映射5Agent 化解析冲突读 delta spec 检索代码库实现证据6展示合并状态表汇总 Artifacts/Tasks/Specs/Conflicts/Status7单次确认批量操作AskUserQuestion单选确认8按解析顺序执行归档mkdir -pmv spec 同步9展示最终汇总成功/跳过/失败分类输出该命令允许归档任意数量的变更1 个即可运行2 个及以上是典型使用场景且绝不自动选择——每一步选择权都在用户手中。二、第 1–2 步列出活动变更并让用户选择流程的第一步是获取当前所有活动变更openspec list --json如果不存在任何活动变更Agent 应当告知用户并立即停止输出参考模板## No Changes to Archive No active changes found. Use /opsx:new to create a new change.当存在活动变更时Agent 使用AskUserQuestion 工具以多选方式让用户挑选要归档的变更每个变更要展示其使用的 schema提供全部变更All changes选项允许任意数量的选择1 个以上即可2 个及以上是典型场景。重要约束IMPORTANT: Do NOT auto-select. Always let the user choose.——即使用户只提到一个变更也不能跳过选择直接归档。这与单条归档命令 .claude/commands/opsx/archive.md 的不得猜测或自动选择守则一脉相承。三、第 3 步批量校验——为每个选中变更收集三类状态选定变更后Agent 需要为每一个被选中的变更收集三类信息作为后续冲突检测与状态汇总的依据。a. Artifact 完成状态openspec status --change name --json解析 JSON 中的两个关键字段schemaName该变更使用的工作流 schema如spec-driven、tddartifactsartifact 列表及其状态需要标记哪些为done、哪些处于其他状态ready/blocked等。从openspec status的用法可以看出它与 .claude/commands/opsx/new.md 中展示 artifact 状态、.claude/commands/opsx/apply.md 中解析 schema 与 artifact使用的是同一个命令形态是整条 OPSX 工作流中读取变更状态的统一入口。b. 任务完成度读取变更目录下的任务清单openspec/changes/name/tasks.md统计清单中的任务完成情况- [ ]计为未完成- [x]计为已完成如果 tasks 文件不存在记为 No tasks无任务不产生任务相关警告。c. Delta spec 清单检查变更目录下的 delta spec 子目录openspec/changes/name/specs/列出存在哪些 capability 的 delta spec对每个 delta spec提取需求名称——即匹配### Requirement: name的行。这里的 delta spec 目录结构与 .claude/skills/openspec-sync-specs/SKILL.md 描述的openspec/changes/name/specs/capability/spec.md布局一致是后续冲突检测和 spec 同步的共同数据来源。四、第 4 步检测 spec 冲突将收集到的 delta spec 信息汇总构建一张能力 → 改动它的变更映射表auth - [change-a, change-b] - CONFLICT (2 changes) api - [change-c] - OK (only 1 change)冲突判据当2 个及以上被选中的变更针对同一个 capability提供了 delta spec 时即判定为冲突。只有 1 个变更触碰的能力如示例中的api不构成冲突。这一步的意义在于尽早暴露问题如果两个变更分别向同一个主规范main spec添加/修改了需求直接先后归档会导致后一个覆盖前一个丢失信息。五、第 5 步Agent 化冲突解析对于每个检测到的冲突Agent 需要动手调查代码库来判定实际实现情况而不是机械合并读取 delta spec阅读每个冲突变更的 delta spec理解各自声称添加/修改了哪些需求检索代码库实现证据搜索与各 delta spec 需求对应的实现代码查找相关文件、函数或测试确定解析策略按以下优先级判定只有一个变更实际实现了 → 只同步该变更的 spec两个都实现了 → 按时间先后顺序应用旧的在前、新的在后覆盖两个都未实现→ 跳过 spec 同步并向用户发出警告记录解析结论对每个冲突记录——应用哪个变更的 spec、应用顺序若两者都实现、以及代码库中查到的依据rationale。示例 1只有一个变更实际实现Conflict: specs/auth/spec.md touched by [add-oauth, add-jwt] Checking add-oauth: - Delta adds OAuth Provider Integration requirement - Searching codebase... found src/auth/oauth.ts implementing OAuth flow Checking add-jwt: - Delta adds JWT Token Handling requirement - Searching codebase... no JWT implementation found Resolution: Only add-oauth is implemented. Will sync add-oauth specs only.示例 2两个变更都已实现Conflict: specs/api/spec.md touched by [add-rest-api, add-graphql] Checking add-rest-api (created 2026-01-10): - Delta adds REST Endpoints requirement - Searching codebase... found src/api/rest.ts Checking add-graphql (created 2026-01-15): - Delta adds GraphQL Schema requirement - Searching codebase... found src/api/graphql.ts Resolution: Both implemented. Will apply add-rest-api specs first, then add-graphql specs (chronological order, newer takes precedence).这一以代码库证据为准的解析思路与 .claude/commands/opsx/verify.md 中搜索代码库关键字评估需求是否已实现的校验启发式一致体现了 OPSX 工作流用实现事实校正规范声明的核心原则。六、第 6 步展示合并状态表所有变更校验并解析完毕后Agent 输出一张汇总表让用户在确认前对全局一目了然| Change | Artifacts | Tasks | Specs | Conflicts | Status | |---------------------|-----------|-------|---------|-----------|--------| | schema-management | Done | 5/5 | 2 delta | None | Ready | | project-config | Done | 3/3 | 1 delta | None | Ready | | add-oauth | Done | 4/4 | 1 delta | auth (!) | Ready* | | add-verify-skill | 1 left | 2/5 | None | None | Warn |对于存在冲突的变更需要附上冲突解析结论* Conflict resolution: - auth spec: Will apply add-oauth then add-jwt (both implemented, chronological order)对于未完成的变更展示警告Warnings: - add-verify-skill: 1 incomplete artifact, 3 incomplete tasks注意add-oauth的Ready*星号标记该变更本身可归档但需要按解析顺序处理 spec而add-verify-skill因存在未完成的 artifact 与任务状态降级为Warn。七、第 7 步单次确认批量操作状态表展示后Agent 使用AskUserQuestion 工具发起一次统一确认而不是逐条询问。选项基于状态动态生成归档全部 N 个变更Archive all N changes只归档 N 个就绪变更跳过未完成的Archive only N ready changes取消Cancel如果存在未完成变更需要明确告知用户它们会被连同警告一起归档theyll be archived with warnings而不是静默处理。八、第 8 步执行归档确认后Agent 按冲突解析确定的顺序逐个处理变更每个变更经历两个子步骤a. 同步 spec如存在 delta spec如果变更存在 delta spec先执行 spec 同步——采用openspec-sync-specs的Agent 驱动智能合并方式详见 .claude/skills/openspec-sync-specs/SKILL.md 与 .claude/commands/opsx/sync.md读取openspec/changes/name/specs/capability/spec.md中的## ADDED / MODIFIED / REMOVED / RENAMED Requirements分区对应修改主规范openspec/specs/capability/spec.md智能合并的精髓在于部分更新新增一个 scenario 时无需复制既有 scenariodelta 表达的是意图intent而非整文件替换对于冲突场景按解析后的顺序应用先旧后新。b. 执行归档mkdir -p openspec/changes/archive mv openspec/changes/name openspec/changes/archive/YYYY-MM-DD-name归档目录目标命名使用当前日期YYYY-MM-DD-变更名。移动目录时会一并保留.openspec.yaml它随目录一起移动。c. 记录每个变更的结果每个变更都要跟踪三类结果之一Success归档成功Failed归档过程出错记录错误原因Skipped用户选择不归档该变更如跳过未完成的变更。失败隔离原则如果某个变更的归档目标目录已存在该变更标记失败但继续处理其余变更不中断整个批次。九、第 9 步输出最终汇总归档完成后按实际情况输出对应模板。全部成功## Bulk Archive Complete Archived 3 changes: - schema-management-cli - archive/2026-01-19-schema-management-cli/ - project-config - archive/2026-01-19-project-config/ - add-oauth - archive/2026-01-19-add-oauth/ Skipped 1 change: - add-verify-skill (user chose not to archive incomplete) Spec sync summary: - 4 delta specs synced to main specs - 1 conflict resolved (auth: applied both in chronological order)部分成功## Bulk Archive Complete (partial) Archived N changes: - change-1 - archive/YYYY-MM-DD-change-1/ Skipped M changes: - change-2 (user chose not to archive incomplete) Failed K changes: - change-3: Archive directory already exists存在失败Failed 1 change: - some-change: Archive directory already exists汇总中必须包含 spec 同步摘要同步了多少 delta spec、解决了多少冲突让用户确认规范已正确收敛到主规范。十、Guardrails批量归档的安全护栏命令文档末尾给出了一组明确的执行守则是 Agent 行为边界的权威约束守则含义允许任意数量变更1 即可2 是典型用例始终提示选择绝不自动选择每一步选择权归用户尽早检测 spec 冲突并检索代码库解析用实现事实而非猜测判定两个变更都实现时按时间序应用 spec旧在前、新覆盖仅在实现缺失时跳过 spec 同步跳过时必须警告用户确认前展示每个变更的清晰状态状态表先行整个批次使用单次确认不逐条打扰跟踪并报告所有结果success/skip/fail 全覆盖移动时保留.openspec.yaml随目录一并归档归档目标用当前日期YYYY-MM-DD-name避免重名目标已存在则失败该变更但继续其余失败隔离结语与单条归档的协作及当前仓库状态批量归档是单条归档 .claude/commands/opsx/archive.md 的批处理升级版单条命令在无参数时同样要求用户选择变更、校验 artifact 与任务、评估 delta spec 同步状态并提供 Sync now (recommended) / Archive without syncing / Archive now / Cancel 等选项批量版则把状态校验升级为冲突检测与 Agent 化解析把逐条确认压缩为单次确认从而在多变更并行落地的场景下显著提升效率。从当前仓库的 openspec/config.yaml 看项目仅声明了schema: spec-driven基础配置openspec/changes/与openspec/specs/目录尚未创建任何内容说明该实验工作流正处于就绪待用状态。若要在 PeerBanHelper 仓库启用完整流程可依序参考 .claude/commands/opsx/new.md创建变更→ .claude/commands/opsx/apply.md实现任务→ .claude/commands/opsx/verify.md实现校验→ 本文所述 bulk-archive批量归档的完整链路。需要说明的是该命令要求本地已安装openspecCLIskill 元数据标注Requires openspec CLI命令运行于 Claude Code 环境并依赖 AskUserQuestion 等交互工具。扩展阅读均为仓库内既有文件命令定义.claude/commands/opsx/bulk-archive.mdSkill 定义.claude/skills/openspec-bulk-archive-change/SKILL.md单条归档.claude/commands/opsx/archive.md、.claude/skills/openspec-archive-change/SKILL.mdSpec 同步.claude/commands/opsx/sync.md、.claude/skills/openspec-sync-specs/SKILL.md工作流配置openspec/config.yaml赞分享网络安全后端【免费下载链接】PeerBanHelperAutomatically block unwanted, leeches and abnormal BT peers with support for customized and cloud rules.| BT 反吸血工具 - 自动封禁不受欢迎、吸血和异常的 BT 客户端并支持自定义规则。支持 qB/qBEE/Deluge/BiglyBT/BitComet项目地址https://gitcode.com/gh_mirrors/pee/PeerBanHelper点击查看免费下载相关推荐Rivet Actors 仓库中的 OpenSpec 变更归档实操/opsx-archive 全流程解析Rivet Actors 仓库中的 OpenSpec 变更归档实操/opsx archive 全流程解析 Rivet Actorsriv/actors仓库后端AI Agent人工智能流程编排WebSocketKun 仓库 OPSX Archive 工作流实验性 OpenSpec 变更归档的完整实战指南Kun 仓库 OPSX Archive 工作流实验性 OpenSpec 变更归档的完整实战指南 导读 /opsx:archive 是 Kun 仓库实验工作流人工智能AI Agent自主智能体桌面应用MCP ClientsKun 仓库 OpenSpec 工作流归档命令 /opsx-archive 的设计、执行流程与落地实践Kun 仓库 OpenSpec 工作流归档命令 /opsx archive 的设计、执行流程与落地实践 导读 本文以 Kun 仓库中定义的斜杠命令 /opsx:人工智能AI Agent自主智能体桌面应用MCP Clients上一篇Mapbox Studio Classic完整指南快速掌握专业地图设计终极方案下一篇如何快速掌握Mapbox Studio Classic新手也能上手的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考