用途
Sus Campaign 是一款用于编写或修订「可重启目标契约」的技能,面向一次多 Pull Request 的交付战役(delivery campaign)。它适用于存在一个持久目标,需要拆解为依赖感知、写入互不重叠、可重启执行的工作流场景。
技能的核心主张是:快照会腐烂,目标需存活。它通过一份持久化的战役文档来锁定目标,使跨会话、跨执行者在同一契约下持续协作。
主要能力
信息读取与锁定。 技能要求先读取项目治理规则、约束性需求、依赖状态、交付命令、分支保护、发布约束、当前工作树以及实时跟踪器,随后锁定一个目标与一个可验证的停止条件,并拒绝无关的积压事项。
台账选择。 技能会选择一个项目原生的 issue、epic 或等价台账作为载体,由其持有工作项、依赖、分配、Pull Request 与状态。战役仅指向该台账,而从不镜像其可变状态。台账需对目标受众自包含,稳定需求被翻译进入台账,且不暴露临时或仅本地可见的制品名、路径或链接。
权威建模(Authority)。 技能只映射战役实际会使用的操作,包括通道分配、验证、重量级执行、发布、评审、合并和清理,并在台账中记录每个操作的所有者、强度、机制与失败行为。权威分为三类:建议型(指令协调自愿的 agent,不声称拒绝或遏制)、确定性本地型(项目命令拒绝非法转换)、隔离权威型(worker 无法触及受保护状态、资源或凭据)。技能强调按主张匹配强度,例如主张 worker 无法绕过边界就必须具备隔离。
通道管理(Lanes)。 技能会检查路径、分支、已跟踪与未跟踪状态及 git worktree 列表,按路径、分支、所有者、来源和状态对每条通道分类,禁止占用活跃或未知通道。容量基于可证明的独立工作、机器限制、验证成本与评审容量确定,仅复用干净的已释放通道,每条通道保持一个分支和一个实现所有者。
分派(Dispatch)。 仅分派依赖就绪、写入互不重叠的工作。每个所有者会获得目标、台账、仓库、通道、分支、范围、排除项、依赖、验收条件、检查项与 PR 策略。回报只要求状态、变更路径、分支、Pull Request、head、决定性检查与阻塞项,不使用进度日记。实现所有者负责编辑、测试、提交、推送与修复评审;编排者负责协调与验证,不劫持他人的分支。模型层级按任务复杂度与歧义选择:经济层级用于有决定性 oracle 的受限机械工作,标准层级用于普通受控工作,最强层级用于架构、安全、迁移、跨仓库判断、冲突证据或未解决歧义。
交付(Delivery)。 在改变行为之前定义最强可观测检查。对于 bug,先复现原始失败与预期原因再编辑。回归测试只有在缺陷上失败、在修复上通过、覆盖生产行为且不凭空发明需求时才被信任。记录命令、工作目录、状态、退出码与决定性输出,材料漂移后重新运行。每个 Pull Request 保持一个可独立评审的关注点,并按依赖顺序合并。
草稿与评审。 在存在可评审代码时开启草稿 PR,遵循仓库标题与正文约定;若无约定则使用祈使句标题、Summary 和 Verification,仅在有实质内容时添加 Dependencies 或 Risks。只发布有支撑、可操作的缺陷,每条发现陈述缺陷、后果与所需结果。实现所有者不能接受自己的工作。
合并与清理。 合并前夕核对治理制品、head、base、证明、评审状态与未决对话,将合并绑定到预期 head。仅回收已合并或关闭且工作树干净的通道,仅删除战役自有的已合并分支,通过指定清理所有者清理战役创建的工作树。
使用方式
技能最终产出为一份战役制品,写入 ~/.agents/artifacts/<workspace>/ 绝对路径下(workspace 取自仓库或工作目录的 basename)。文件需包含以下头部:
---
type: campaign
id: CAMPAIGN-{{slug}}
status: draft
ledger: {{project-native-url-or-relative-path}}
sources:
- {{governing-artifact-or-url}}
---
以及以下必备章节:Objective(一个持久结果)、Completion contract(证明整个战役完成的可观测条件)、Authorities(治理制品、台账及每个预期交付转换的所有者与机制)、Operating loop(重读、核对、选择、执行、验证、记录、重复)、Stops(完成或阻塞依赖工作的具名人工决策)。仅在携带信息时添加 Constraints、Non-goals 或 Workstreams。
每次拾取(pickup)都必须运行同一循环:读取战役与每项权威;从实时证据核对仓库、台账、Pull Request、工作树、worker 与验证状态;在信任状态前修复台账漂移;选择适配当前容量与所有权、优先级最高且依赖就绪的工作;通过项目的实现、验证、评审与集成闸门执行;在项目原生台账中记录持久进展;重复直到完成契约通过或被具名人工决策阻塞。
输出阶段只返回战役及每个 sidecar 的可点击 Markdown 链接,使用紧凑的 ~/.agents/... 标签与完全展开的绝对目标路径。
适用场景
适用于一次性交付战役包含多个 Pull Request、需要依赖感知与写入互不重叠并行、需要跨会话可重启执行,且项目已有原生台账(issue、epic 或等价物)与治理机制的场景。技能明确要求人类拥有意图、材料决策、豁免、不可逆权威与验收权,可将其执行委派给具名编排者或项目机制。
限制
技能明确:指令只能建议,项目命令才能拒绝,隔离才能移除权限,只能声明机制所证明的内容。托管状态检查是可选的,项目批准的本地证明同样有效。技能不提供行数或文件阈值,也不提供评审者或立场数量。无法确定 workspace 或发生冲突时需呈现人类可读名称选项。禁止覆盖或回退到仓库、vendor 目录或临时路径。不得在战役中放入任务清单复选框、当前计数、分支 SHA、通道占用、Pull Request 快照、会话身份、首次运行步骤或交接日记。