爪代理协议（CAP）技能
人工智能代理通过爪代理协议与个人数据交互的生产级技能。
 ](https://github.com/jfleagl12/claw-agent-protocol)
概述
这 爪代理协议（CAP）技能 使任何AI代理都能以结构化、安全和高效的方式与用户的个人数据进行交互。该技能为跨多个来源组织、查询和管理个人数据提供了一个全面的框架。
什么是CAP？
CAP是一种轻量级 模型上下文协议（MCP）服务器 它充当用户数据源（Gmail、谷歌日历、Notion、Slack等）和人工智能代理之间的实时翻译层。代理可以使用单个一致的接口，而不是处理数十种不同的API和数据格式。
为什么是这个技能？
该技能通过提供以下功能将通用AI代理转换为专业的个人数据助理：
- 规范模式：所有来源的数据结构一致
- 查询模式：常见用例的预构建查询示例
- 安全指南：处理敏感数据的最佳做法
- 实用脚本：用于数据验证、导出和查询构建的生产就绪工具
- 30+用例：展示CAP能力的真实场景
特性
📚 综合文档
- 技能.md：核心概念和使用说明的主要切入点
- 架构参考：所有5个机框（身份、通信、日历、文档、任务）的完整规范模式
- 查询示例：50多种带过滤器和参数的查询模式
- 安全指南：数据敏感级别、权限和安全处理实践
- 用例：从每日简报到项目管理的30种常见场景
🛠️ 生产就绪公用设施
generate_briefing.py：将CAP数据格式化为可读的每日简报validate_cap_data.py：根据规范架构要求验证数据export_cap_data.py：将数据导出为CSV、JSON或Markdown格式build_query.py：从自然语言生成CAP查询
🔒 安全第一设计
- 敏感等级分类（S1、S2、S3）
- 权限范围和有时限的授予
- 用于敏感操作的人工控制门
- 审计日志记录和数据来源跟踪
安装
面向Manus AI用户
- 下载
.skill文件来自发布页面 - 在Manus中，转到设置→ 技能
- 点击“添加技能”并选择下载的文件
- 该技能将自动可用
对于其他人工智能代理，如Clawdbot、Moltbot、OpenClaw：
- 克隆此存储库或下载技能目录，或将此存储库链接复制并粘贴到您的Openclaw ai代理，并告诉他们添加技能
- 放置
claw-agent-protocol代理技能文件夹中的目录 - 确保您的代理人能够阅读
SKILL.md文件并执行Python脚本
快速开始
一旦你安装了该技能并连接了CAP服务器，你就可以开始在OpenClaw代理中使用这些提示。只需复制并粘贴这些命令，无需编码。
示例1：获取每日简报
复制此提示：
Give me my daily briefing using CAP发生了什么： 您的代理将获取今天的日历事件、到期任务和最近的通信，然后将其格式化为可读的摘要。
______________________________________________________________________
示例2：查找本周到期的高优先级任务
复制此提示：
Show me all high-priority tasks due this week from my CAP data发生了什么： 您的代理将查询您的任务货架，并在未来7天内返回所有待处理的高优先级项目。
______________________________________________________________________
示例3：检查特定人员的未读电子邮件
复制此提示：
Show me unread emails from john@example.com using CAP发生了什么： 您的代理将查询您的通信架，并返回该发件人的所有未读电子邮件。
______________________________________________________________________
示例4：获取本周的日历事件
复制此提示：
What's on my calendar this week? Use CAP to get the events发生了什么： 您的代理将获取未来7天内所有已确认的日历事件。
______________________________________________________________________
示例5：查找标记有特定主题的所有笔记
复制此提示：
Find all my notes tagged with "project-alpha" using CAP发生了什么： 你的代理人会在你的文档架上搜索带有该标签的笔记。
______________________________________________________________________
示例6：获取客户端通信历史记录
复制此提示：
Show me all communications with Acme Corp from the last 30 days using CAP发生了什么： 您的代理将查询您的身份架（查找Acme Corp联系人）和通信架（获取最新消息/电子邮件）。
______________________________________________________________________
示例7：列出所有被阻止的任务
复制此提示：
What tasks are currently blocked? Check CAP发生了什么： 您的代理将查询您的任务货架，查找状态为“已阻止”的项目，并向您显示卡住的项目。
______________________________________________________________________
示例8：查找本月与特定人员的会议
复制此提示：
Show me all meetings with sarah@example.com this month from CAP发生了什么： 您的代理将查询按与会者电子邮件筛选的日历架。
______________________________________________________________________
示例9：获取所有VIP联系人
复制此提示：
Show me all contacts tagged as VIP in CAP发生了什么： 您的代理将在您的身份架上查询带有“vip”标签的人员/组织。
______________________________________________________________________
示例10：在所有文档中搜索
复制此提示：
Search my CAP documents for anything related to "quarterly budget"发生了什么： 您的代理将使用knowledge_search工具查找所有提及该主题的文档、笔记和文件。
______________________________________________________________________
示例11：每周计划会议
复制此提示：
Help me plan next week. Show me my calendar, pending tasks, and any upcoming deadlines from CAP发生了什么： 您的代理将汇总来自多个货架（日历、任务）的数据，为您提供全面的每周概览。
______________________________________________________________________
示例12：将任务导出到文件
复制此提示：
Export all my pending tasks from CAP to a markdown file发生了什么： 您的代理将查询您的任务架，并使用导出脚本创建一个可以下载的格式化markdown文件。
______________________________________________________________________
专业建议
- 具体说明时间范围：“本周”、“下个月”、“过去30天”
- 明确提及CAP：这有助于你的经纪人知道如何使用这项技能
- 组合货架：要求提供交叉引用的数据，如“会议和相关电子邮件”
- 使用标签：如果标记数据，则可以在提示中按标记进行筛选
- 要求出口：您的代理可以将数据导出为CSV、JSON或Markdown格式
建筑
claw-agent-protocol/
├── SKILL.md # Main skill instructions (104 lines)
├── LICENSE # MIT License
├── README.md # This file
├── references/
│ ├── schema.md # Canonical schema definitions (118 lines)
│ ├── query_examples.md # Query patterns and filters (232 lines)
│ ├── security.md # Security best practices (297 lines)
│ └── use_cases.md # 30 common scenarios (466 lines)
└── scripts/
├── generate_briefing.py # Daily briefing formatter (48 lines)
├── validate_cap_data.py # Schema validator (299 lines)
├── export_cap_data.py # Data exporter (306 lines)
└── build_query.py # Natural language query builder (255 lines)总计2146行生产级代码和文件
CAP货架
CAP将个人数据组织到5个规范书架中：
| 货架 | URI | 描述 |
|---|---|---|
| 身份 | cap://identity | 人员、组织、联系人 |
| 通讯 | cap://comms | 消息、电子邮件、帖子 |
| 日历 | cap://calendar | 活动、可用性、会议 |
| 文档 | cap://docs | 笔记、文件、片段、书签 |
| 任务 | cap://tasks | 任务、项目、里程碑 |
每个货架都有一个一致的模式，其中包含通用元数据（id、时间戳、来源、置信度、灵敏度）。
用例
该技能支持30多种常见用例，包括：
个人生产力
- 每日简报生成
- 每周计划协助
- 任务优先级
- 会议准备
- 电子邮件分类
客户与关系管理
- 客户沟通历史
- 后续提醒
- 关系强度分析
- 会议日程优化
- 可交付成果跟踪
知识管理
- 交叉引用搜索
- 会议笔记整合
- 文档版本跟踪
- 研究线程重构
- 知识差距识别
时间和可用性
- 时间审计
- 聚焦时间保护
- 可用性共享
- 超限检测
- 旅行计划整合
项目和团队协调
- 项目状态仪表板
- 依赖关系映射
- 团队工作负载平衡
- 里程碑跟踪
- 生成站立报告
个人生活管理
- 家庭日历协调
- 健康预约跟踪
- 财务截止日期管理
- 个人目标跟踪
- 数字生活审计
安全与隐私
此技能实现了安全最佳实践：
- 数据敏感级别：S1（公共），S2（内部），S3（敏感）
- 权限范围界定：每个机框的读/写权限
- 有时限的资助：敏感操作的临时访问权限
- 循环中的人类：破坏性行为需要确认
- 审计日志：仅附加关键操作的日志
- 数据世系：源系统的完全可追溯性
需求
- Python 3.10+
- 访问CAP MCP服务器
- MCP兼容的AI代理（OpenClaw、Claude Desktop等）
贡献
欢迎投稿！这项技能旨在由社区扩展和改进。
如何做出贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
贡献领域
- 其他实用程序脚本
- 更多用例示例
- 新数据源的连接器实现
- 改进的查询模式
- 增强的安全功能
- 文档改进
许可证
此技能根据MIT许可证获得许可。看 许可证 了解详情。
作者
杰森·弗莱格尔 -首席人工智能官
CAP由Jason Fleagle创建。Jason是首席人工智能官兼增长顾问，与全球品牌合作，帮助他们成功采用和管理人工智能。他也是一名作家、企业家和顾问，专门从事技术、营销和增长。他帮助数据人性化，因此组织做出的每一个增长决策都植根于清晰度和信心。Jason帮助领导了500多个人工智能项目和工具的开发和交付，并经常举办培训研讨会，帮助公司了解和采用人工智能。凭借在数字营销、内容战略和技术方面的深厚背景，他将技术专长与商业敏锐度相结合，创造出可扩展的解决方案。他也是一名内容创作者，制作关于人工智能、创业和增长的视频、研讨会和思想领导力。他继续探索如何充分利用人工智能，改善人与人之间的联系，同时平衡家庭、商业和创造性追求。
致谢
- 受模型上下文协议（MCP）标准的启发
______________________________________________________________________
建于❤️ 由AI代理社区的高级软件工程师和AI架构师担任。