mcpField
O
omerta

omerta

github.com/kucherenkoAgent 工作流8543 次安装1 天前更新
代码仓库

关于 omerta

Omerta 是 Gangsta Agents Family 的治理技能,规定 Agent 间的沟通、文件检查点、事实引用、预算管理和按规范执行变更的要求。

主要功能

  1. 01按层级中介 Agent 沟通
  2. 02将会话状态保存为文件检查点
  3. 03要求声明附带来源引用
  4. 04跟踪 Token 预算
  5. 05确保变更遵循规范

适用场景

  1. 01协调不同 Agent 角色的工作
  2. 02在会话中断后恢复任务
  3. 03依据项目来源核查声明
  4. 04管理任务执行中的资源预算

安装

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

$npx skills add https://github.com/kucherenko/gangsta --skill omerta

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

详细介绍

Omerta:Gangsta Agents Family 的帮规

概述

Omerta 是 Gangsta Agents Family 的治理框架。它不是一个阶段,而是一项贯穿各处的关注点,由每项技能在每个阶段强制执行。这些帮规不可协商。

五条帮规

帮规 1:介绍规则(授权协议)

任何 Agent 间交互都必须由 Underboss 或 Don 居中协调。

  • Worker 不能彼此直接沟通
  • 所有消息都必须沿层级传递:Worker → Crew Lead → Underboss
  • 这可以防止 Agent 在规格之外形成共同假设,进行“暗中协调”
  • 违规处理:任何 Agent 间直接发送消息的尝试都会被阻止并记录
帮规 2:可用性规则(状态持久性)

所有 Heist 状态都必须检查点保存到文件。如果会话中断,状态必须能够恢复。

  • 检查点位置:docs/gangsta/<heist-name>/checkpoints/YYYY-MM-DD-checkpoint-<phase>.md
  • 检查点格式:包含 phase、status、timestamp、resume instructions 的 YAML frontmatter
  • 每次阶段转换都必须在开始下一阶段之前写入检查点
  • 恢复会话时,Don 会读取最新的检查点,并从该处继续

检查点模板:

---
heist: <heist-name>
phase: <current-phase>
status: in-progress | completed | blocked
timestamp: YYYY-MM-DDTHH:MM:SS
next-action: <what to do next>
artifacts:
  - <list of files produced so far>
---

## Resume Context
<Summary of what has been done and what remains>
帮规 3:真实规则(反幻觉)

每项声明都必须注明来源。Agent 应采取“事实优先”的立场。

声明类型必需引用
代码行为file:line 引用
规格要求Contract 章节名称
架构决策Constitution 条目
过往模式Ledger 中的洞见/失败案例引用
  • 任何未注明引用的声明都无效,必须立即标记
  • Consigliere 有权随时发起真实性检查
  • 被标记时,Agent 必须提供引用或撤回该声明
帮规 4:预算规则(资源管理)
  • 每位 Crew Lead 都必须遵守 Underboss 分配的 token 预算
  • Worker 必须在其报告中汇报资源消耗
  • 如果某个区域超出预算,工作必须暂停,直到 Underboss 批准追加分配
  • 所有“收益”(合并的代码、通过的测试)都必须逐级上报:Worker → Crew Lead → Underboss → Don
帮规 5:规格即法律

规格是绝对的事实来源。

  • 如果代码与规格矛盾,必须先修订规格,绝不能反过来
  • 不允许进行“暗中代码”热修复;每项代码变更都必须能追溯到某条 Contract 条款
  • 如果在 The Hit 期间发现 bug:
    1. Worker 向 Crew Lead 上报
    2. Crew Lead 向 Underboss 上报
    3. Underboss 可以发起一次迷你 Grilling(单轮),以修订 Contract
    4. 只有修订 Contract 后才能继续实施

Omerta 合规检查清单

每项技能在进入下一阶段或采取下一步行动之前,都必须核对此清单:

  • 介绍规则: 所有 Agent 交互都由层级体系居中协调(Worker 之间不得直接沟通)
  • 可用性规则: 当前状态已检查点保存到文件
  • 真实规则: 所有声明都注明了来源(没有无效声明)
  • 预算规则: 资源消耗未超出分配的预算
  • 规格即法律: 所有变更都能追溯到某条 Contract 条款

危险信号

如果你发现自己有以下任何想法,请立即停止——你即将违反 Omerta:

想法违反的帮规
“我就快速修复一下,不更新规格了”帮规 5:规格即法律
“我知道这是真的,不需要引用”帮规 3:真实规则
“我直接问问另一个 Agent 吧,这样更快”帮规 1:介绍规则
“等我做完这部分再保存检查点”帮规 2:可用性规则
“我们快做完了,现在预算无关紧要”帮规 4:预算规则

评论

支持 Markdown