paperclip

用途

Paperclip 技能用于操作 Paperclip 的“智能体公司”控制平面，覆盖对 companies（公司）、agents（智能体）、projects（项目）、workspaces（工作区）、issues（议题）、company skills（公司技能）、routines（例程）、heartbeats（心跳）、artifacts（工件）和 integrations（集成）的检查、配置与故障排查。

该技能被明确界定为“操作员指南”，而不是安装或运行 Paperclip 服务、启动智能体、调用实时 API 或自行更改公司状态的许可。

主要能力

• 对请求进行分类：区分只读检查、本地安装、公司/智能体配置、任务执行、定时自动化和故障排查。
• 在变更前检查已安装的 Paperclip 版本及其 CLI 帮助、配置的 API origin、公司/项目/智能体/议题标识符和当前状态；不假设默认公司，也不在 API 可消除歧义时凭名称推断 ID。
• 通过 references/upstream-map.md 选择与请求匹配的上游 API、例程、公司技能、工件或工作流参考，并在使用 API 载荷或命令前对照已安装版本验证。
• 对变更范围作出界定：明确目标、变更内容、计划/触发器、权限边界和预期结果；只执行用户要求的操作。
• 优先使用已安装且版本支持的 paperclipai CLI；直接调用 API 时遵循已安装的 API schema 和授权规则。
• 写入后读回受影响对象，确认服务端接受的字段/状态；超时或空响应后先读取对象再重试，以避免重复写入。
• 分别报告“尝试”“接受”“已验证”三种状态；若因缺失 ID、权限、凭据或策略选择受阻，指出最小的缺失输入而非猜测。

使用方式与关键约束

• 公司是数据边界，跨公司操作必须核对公司 ID，不得复用另一公司的 ID 或凭据。
• 智能体心跳期间须保留提供的 run 标识；修改议题的请求在要求时须携带实际的 X-Paperclip-Run-Id，不得编造 run ID 或无证据声称智能体完成了工作。
• 不将 Paperclip 或其依赖作为通用技能安装的一部分；不把远程安装脚本直接管道到 shell。请求安装时，先检查官方安装程序和对应版本的说明，并将网络绑定、认证模式、数据库变更和服务暴露视为独立决策。
• 未经用户对具体操作和已知目标/策略值的请求，不创建、雇佣、唤醒或重新分配智能体，不运行心跳，不创建/启用例程，不发布工件。
• 删除、重置、替换完整的期望技能集、归档例程、轮换 webhook 密钥或更改公共/远程访问，需要针对确切目标的明确确认；在所审查的 API 契约中，例程归档是终态操作。
• 凭据应使用来自密钥管理器或现有环境的最小权限凭据，不在聊天或日志中暴露 API 密钥、webhook 密钥或提供方凭据。

常见工作流

• 智能体任务/心跳：先读取分配的议题和智能体上下文，保留验收标准和现有状态；活跃心跳中使用任务提供的 run 上下文，并在需要时于修改请求中包含其 run ID；更新后读回议题，超时后先核对实时状态再重试，如实报告 blocked 或 in_progress。
• 公司技能：区分“在公司库中安装技能”与“将技能分配给智能体”，安装本身不会让智能体使用它；先浏览内置目录，再将选定的技能键/ID/唯一 slug 同步到智能体；窄范围分配优先使用 merge 模式的 add，只有在用户明确批准更改智能体完整期望技能集后才使用 replace。
• 例程：创建或编辑前先确定其智能体、项目、时区、触发器、并发策略、补跑策略和活动门控行为；优先显式指定并发和错过运行策略，而非依赖默认值；区分暂停与归档，不将归档当作可逆暂停。
• 工件：把上传工件视为改变状态的操作；上游辅助脚本会创建议题附件，默认还会创建由附件支持的工作产物，并可能将评论绑定到外部聊天响应；实传前用 --dry-run 预览已解析设置，确认议题/公司、文件、标题、状态及是否要创建工作产物/评论；上传结果不确定时先列出附件再重试，--retry-unknown-upload 会显式接受重复文件风险，不得自动添加；保存的 Paperclip 评论不能证明外部聊天提供方已送达消息。

适用场景

适用于需要对 Paperclip 公司、智能体身份、项目、工作区、议题、心跳、例程、公司技能、工件和集成进行安全运维、检查、配置或故障排查的用户。

限制

该技能不是安装或运行 Paperclip 的许可，不授予启动智能体、调用实时 API 或自行更改公司状态的权限；不在缺少已知目标/策略值时代为执行破坏性或外部可见操作；具体命令、API 载荷与版本支持情况需以已安装版本和官方文档为准。资料中未提供具体安装命令、价格、平台支持范围等信息。