技能 contracts
🤝
contracts
安全 🌐
网络访问📁
文件系统访问⚙️
外部命令
管理多代理合約介面
多代理工作流程需要在並行任務之間建立清晰的介面。此技能提供完整的生命週期系統,用於建立、追蹤和解決代理任務之間的合約。
支持: Claude Codex Code(CC)
1
下载技能 ZIP
2
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
3
开启并开始使用
测试它
正在使用“contracts”。 為支付服務建立合約,包含 charge 和 refund 方法
预期结果:
- Contract: payment-gateway
- Provider: payment-service
- Consumers: checkout, refunds
- Methods: charge(amount, token), refund(chargeId)
- Breaking change: None detected
正在使用“contracts”。 task-002 消耗哪些合約?
预期结果:
- task-002 消耗: user-repository (消費者角色)
- 合約版本: 1
- 狀態: active
- 提供者: task-001
正在使用“contracts”。 任務因合約需要新的必要欄位而受阻
预期结果:
- 影響: 3 個消費者使用此合約
- 建議: 擴展(向後相容)
- 新欄位最初設為可選
- 版本遞增至 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
审计总数
风险因素
🌐 网络访问 (1)
📁 文件系统访问 (1)
⚙️ 外部命令 (26)
SKILL.md:20-24 SKILL.md:24-30 SKILL.md:30-32 SKILL.md:32-38 SKILL.md:38-44 SKILL.md:44-47 SKILL.md:47-49 SKILL.md:49-52 SKILL.md:52-54 SKILL.md:54-64 SKILL.md:64-66 SKILL.md:66-69 SKILL.md:69-70 SKILL.md:70-87 SKILL.md:87-88 SKILL.md:88-89 SKILL.md:89-98 SKILL.md:98-100 SKILL.md:100-103 SKILL.md:103-105 SKILL.md:105-108 SKILL.md:108-110 SKILL.md:110-113 SKILL.md:113-115 SKILL.md:115-121 SKILL.md:121-126
审计者: claude 查看审计历史 →
质量评分
38
架构
100
可维护性
85
内容
21
社区
100
安全
83
规范符合性
你能构建什么
定義系統介面
建立合約來定義微服務或模組之間的互動方式
協調並行任務
管理並行部署或建置任務之間的依賴項
管理多代理通訊
定義多個 AI 代理如何共享資料並呼叫彼此的函數
试试这些提示
建立簡單合約
為使用者儲存庫建立合約,包含依 ID 取得使用者及儲存使用者資料的方法
檢查重大變更
檢查將必要欄位新增至此合約是否會對消費者造成重大變更
解決受阻的任務
任務因合約不足而受阻。評估影響並建議應該修改還是擴展合約
設計 API 合約
設計完整的 API 合約,包含請求格式、回應格式和錯誤碼
最佳实践
- 在產生並行實作任務之前先定義合約
- 每次合約變更都要版本化,切勿編輯歷史記錄
- 明確列出所有消費者並追蹤每個合約的使用者
避免
- 修改合約時不遞增版本號
- 為同一介面建立多個提供者的合約
- 未先閱讀合約就直接實作
常见问题
哪些工具支援此技能?
Claude、Codex 和 Claude Code 都透過 Read、Write 和 Glob 工具支援此技能
我可以建立多少個合約?
沒有限制。每個合約都會成為 memory/contracts 目錄中的 JSON 檔案
我可以與現有程式碼一起使用嗎?
可以。將合約與實作分開定義。現有程式碼可以實作合約介面
我的資料安全嗎?
可以。此技能僅管理 memory/contracts 目錄中的合約中繼資料。不會存取外部資料
如果合約衝突怎麼辦?
合約解析代理會評估影響並決定修改、擴展或拒絕選項
這與 API 規格有何不同?
合約專注於代理任務邊界和依賴項,而不僅僅是資料格式