SuperAPI AI 工具集

sus-campaign

编程与开发

查看项目

更新于 11-05 02:29

技能介绍

用途

Sus Campaign 用于为一个多拉取请求的交付战役写下或修订一份可重启的目标契约。当存在一个持久目标,且需要依赖感知、写不相交的并行工作时使用。它的核心主张是:快照会腐烂,目标能存活——因此不在契约中镜像易变的台账状态,而是指向项目原生台账,让工作项、依赖、分配、拉取请求和状态都在台账中维护。

主要能力

  • 方法:读取项目治理、适用需求、依赖状态、交付命令、分支保护、发布约束、当前工作树和实时跟踪器;锁定一个目标与一个可验证的终止条件,拒绝无关积压;选择一个项目原生 issue、epic 或等价台账,使其对读者自包含,把稳定需求翻译进去,不暴露瞬时或仅本地的产物名、路径、链接。
  • 权威:只映射战役将使用的操作(通道分配、验证、重型执行、发布、评审、合并、清理),在台账中记录每个操作的负责人、强度、机制和失败行为。三种强度:建议(指令协调愿意的智能体,不声称拒绝或遏制)、确定性本地(项目命令拒绝非法转换)、隔离权威(工作者无法触及受保护状态、资源或凭据)。缺少权威只阻塞依赖操作,独立工作继续;受信任的负责人可引导缺失控制,但其受保护转换保持阻塞。
  • 通道:检查路径、分支、已跟踪与未跟踪状态、git worktree list,按路径、分支、负责人、来源、状态分类每条通道,绝不抢占活动或未知通道;根据已证实的独立工作、机器限制、验证成本和评审容量确定容量;每条通道保持一个分支和一个实现负责人;lockfile 或工具链漂移后刷新被忽略的依赖;不强制清理任何东西。
  • 派发:只派发依赖就绪、写不相交的工作,给每个负责人提供目标、台账、仓库、通道、分支、范围、排除项、依赖、验收条件、检查和拉取请求策略,只要求状态、变更路径、分支、拉取请求、head、决定性检查和阻塞项,不要进度日记或复盘。实现负责人负责编辑、测试、提交、推送和修复评审;编排者协调与验证,不劫持他人分支。按任务复杂度与歧义选择实现模型层级,按评审立场的关键性选择评审模型层级,忽略自我信心。
  • 交付:在改变行为前定义最强可观察检查;对 bug 先复现原始失败与预期原因再编辑;回归只有在缺陷上失败、在修复上通过、检验生产行为且不发明需求时才可信,记录命令、工作目录、状态、退出码和决定性输出,材料漂移后重跑。每个拉取请求只承载一个可独立评审的关注点,按依赖顺序合并;仓库规模策略优先,没有策略时在可评审性下降时拆分,除非关注点不可分。有可评审代码时开草稿,遵循仓库标题与正文约定,无约定时使用祈使标题、Summary 和 Verification,仅在重要时添加 Dependencies 或 Risks。
  • 评审与合并:推导覆盖重要风险的最小评审集;给每位评审者当前 head、diff、需求、已接受决策和一个不同风险;只发布有支持、可操作的缺陷,每条发现陈述缺陷、后果和所需结果。实现负责人不能接受自己的工作,由不同评审者或指定评审权威验证修复。合并前立即对账治理产物、head、base、证明、评审状态和开放对话;将合并绑定到预期 head;漂移会重置受影响的检查和评审;依赖分支在前提合并后重新验证;仅在合并或关闭且工作树干净后回收通道。
  • 产物:将 ~/.agents/artifacts/<workspace>/ 解析为绝对路径,<workspace> 从仓库或工作目录基名派生;以 type: campaign、唯一 CAMPAIGN-ID 和并列的链接侧车文件写入;碰撞或工作区歧义时提供人类可读的名称选项;目标阻塞或不可写时提供授权重试、另一个智能体中立的用户目录或取消;绝不覆盖或回退到仓库、供应商目录或临时路径。本地源引用相对于产物写入,仅运行时交接使用绝对路径。

使用方式

产物以 YAML front matter 开头(type、id、status、ledger、sources),随后写恰好这些必填节:Objective(一个持久结果)、Completion contract(证明整个战役完成的可观察条件)、Authorities(治理产物、台账,以及每个预期交付转换的负责人和机制)、Operating loop(重读、对账、选择、执行、验证、记录、重复;仅当相关状态改变、上次尝试失败或独立证明要求时才重复动作)、Stops(完成或阻塞依赖工作的具名人类决策)。仅在承载信息时添加 Constraints、Non-goals 或 Workstreams;Workstreams 可命名稳定台账 ID,状态留在台账中。

每次拾取都必须运行同一循环:读取战役与每项权威;从实时证据对账仓库、台账、拉取请求、工作树、工作者和验证状态;在对账台账漂移前不信任其状态;选择符合当前容量与所有权、依赖就绪的最高优先级工作;通过项目实现、验证、评审和集成门执行;在项目原生台账记录持久进展;重复直到完成契约通过或具名人类决策阻塞进展。

工作器和阶段交接只陈述动作、当前状态、结果、决定性证据、未解决条件和下一负责人或动作。战役中不放任务清单复选框、当前计数、分支 SHA、通道占用、拉取请求快照、会话身份、首次运行步骤或交接日记。

仅当每项权威从目标执行环境可达、每个阻塞选择已解决、每个预期操作都命名诚实的负责人、强度、机制和失败行为时,才使用 status: ready。

适用场景与限制

适用于需要在一个持久目标下协调多个拉取请求、依赖感知且写不相交的交付战役。资料明确说明:指令只是建议,不声称拒绝或遏制;只有在工作者无法绕过权威时才声称独立;人类拥有意图、重要决策、豁免、不可逆权威和验收;Suspec 不提供行数或文件阈值,也不提供评审者或立场数量。输出时只返回战役和每个侧车文件的可点击 Markdown 链接,使用紧凑的 ~/.agents/... 标签和完全展开的绝对目标。区块关闭时,需人类对产物及侧车做一次处置:Delete、Leave 或 Promote。关于收费、价格、平台等信息暂未提供。