关于 omerta
Omerta 是 Gangsta Agents Family 的治理技能,规定 Agent 间的沟通、文件检查点、事实引用、预算管理和按规范执行变更的要求。
主要功能
- 01按层级中介 Agent 沟通
- 02将会话状态保存为文件检查点
- 03要求声明附带来源引用
- 04跟踪 Token 预算
- 05确保变更遵循规范
适用场景
- 01协调不同 Agent 角色的工作
- 02在会话中断后恢复任务
- 03依据项目来源核查声明
- 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:
- Worker 向 Crew Lead 上报
- Crew Lead 向 Underboss 上报
- Underboss 可以发起一次迷你 Grilling(单轮),以修订 Contract
- 只有修订 Contract 后才能继续实施
Omerta 合规检查清单
每项技能在进入下一阶段或采取下一步行动之前,都必须核对此清单:
- 介绍规则: 所有 Agent 交互都由层级体系居中协调(Worker 之间不得直接沟通)
- 可用性规则: 当前状态已检查点保存到文件
- 真实规则: 所有声明都注明了来源(没有无效声明)
- 预算规则: 资源消耗未超出分配的预算
- 规格即法律: 所有变更都能追溯到某条 Contract 条款
危险信号
如果你发现自己有以下任何想法,请立即停止——你即将违反 Omerta:
| 想法 | 违反的帮规 |
|---|---|
| “我就快速修复一下,不更新规格了” | 帮规 5:规格即法律 |
| “我知道这是真的,不需要引用” | 帮规 3:真实规则 |
| “我直接问问另一个 Agent 吧,这样更快” | 帮规 1:介绍规则 |
| “等我做完这部分再保存检查点” | 帮规 2:可用性规则 |
| “我们快做完了,现在预算无关紧要” | 帮规 4:预算规则 |
评论
支持 Markdown