技能 contracts
🤝

contracts

安全 🌐 網路存取📁 檔案系統存取⚙️ 外部命令

管理多代理合约接口

多代理工作流需要并行任务之间清晰的接口。该技能提供完整的生命周期系统,用于创建、跟踪和解析代理任务之间的合约。

支援: Claude Codex Code(CC)
⚠️ 68
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「contracts」。 Create a contract for a payment service with charge and refund methods

預期結果:

  • Contract: payment-gateway
  • Provider: payment-service
  • Consumers: checkout, refunds
  • Methods: charge(amount, token), refund(chargeId)
  • Breaking change: None detected

正在使用「contracts」。 What contracts does task-002 consume?

預期結果:

  • task-002 consumes: user-repository (consumer role)
  • Contract version: 1
  • Status: active
  • Provider: task-001

正在使用「contracts」。 A task is blocked because the contract needs a new required field

預期結果:

  • Impact: 3 consumers use this contract
  • Recommendation: Extend (backward compatible)
  • New field added as optional initially
  • Version incremented to 2

安全審計

安全
v5 • 1/16/2026

This is a documentation-only skill containing a protocol specification for multi-agent contract management. The static scanner flagged documentation patterns (JSON examples, workflow stage names, markdown code delimiters) as security issues. All 53 findings are false positives triggered by non-executable content. No network calls, file writes, or command execution exist in this skill.

2
已掃描檔案
321
分析行數
3
發現項
5
審計總數
審計者: claude 查看審計歷史 →

品質評分

38
架構
100
可維護性
85
內容
21
社群
100
安全
83
規範符合性

你能建構什麼

定义系统接口

创建合约,定义微服务或模块之间如何相互交互

协调并行任务

管理并发部署或构建任务之间的依赖关系

管理多代理通信

定义多个 AI 代理如何共享数据并相互调用函数

試試這些提示

创建简单合约
为用户仓库创建一个合约,包含通过 ID 获取用户和保存用户数据的方法
检查破坏性变更
检查向此合约添加必填字段是否会对消费者造成破坏性变更
解析受阻任务
任务因合约不完整而受阻。评估影响并建议是修改还是扩展合约
设计 API 合约
设计完整的 API 合约,包括请求格式、响应格式和错误代码

最佳實務

  • 在生成并行实现者任务之前定义合约
  • 对每次合约变更进行版本控制,绝不编辑历史记录
  • 显式列出所有消费者并跟踪每个合约的使用者

避免

  • 修改合约而不递增版本号
  • 为同一接口创建包含多个提供者的合约
  • 未先阅读合约就直接开始实现

常見問題

哪些工具支持此技能?
Claude、Codex 和 Claude Code 都通过 Read、Write 和 Glob 工具支持此技能
我可以创建多少个合约?
没有硬性限制。每个合约都会成为 memory/contracts 目录中的一个 JSON 文件
我可以将此与现有代码一起使用吗?
可以。将合约与实现分开定义。现有代码可以实现合约接口
我的数据安全吗?
是的。此技能仅管理 memory/contracts 目录中的合约元数据。不访问外部数据
如果合约冲突怎么办?
Contract-Resolver 代理会评估影响并在修改、扩展或拒绝选项之间做出决定
这与 API 规范有什么不同?
合约专注于代理任务边界和依赖关系,而不仅仅是数据格式

開發者詳情

檔案結構

📄 SKILL.md