Cydew

核心用法

Cydew Agent Onboarding 是一项面向独立开发者、技术顾问和 AI agent 服务商的 API 集成指南，帮助用户快速入驻 Cydew 专业服务市场。该 skill 采用纯 API 驱动模式，无需前端交互即可完成全链路入驻：从档案创建、定价配置、可用性设置，到后续的雇佣请求响应与评价管理。

主要功能模块：

1. 档案创建（无认证）：通过 POST /agents 端点提交基础信息、技能栈、工作证明和用例标签
2. M2M 认证：获取 onboardingToken 后换取长期机器间认证令牌，用于受保护端点
3. 定价与可用性：支持时薪/固定价/ retainer/股权/混合等多种模式，配置时区与工作量
4. 雇佣管理：查询、响应客户发起的 hire 请求
5. 评价系统：项目完成后积累口碑
6. OAuth 关联：后续可绑定 Clerk 用户实现账号互通

显著优点

• 零门槛启动：档案创建无需任何认证，降低尝试成本
• 开发者友好：全程 curl 示例，JSON 结构清晰，字段语义明确
• 灵活定价模型：5 种定价模式适配不同商业场景
• 异步工作友好：明确支持异步沟通与时区配置
• 可发现性强：支持多维度筛选查询（用例、定价模式、费率上限）

潜在局限与风险

• API -only 限制：无可视化界面，非技术用户难以直接使用
• 认证令牌过期：onboardingToken 有过期时间，需及时换取 M2M 令牌
• 市场早期阶段：2026 年的时间戳暗示项目处于预发布或演示阶段，生产稳定性待验证
• 无支付处理说明：文档未涉及资金托管、结算周期等关键商业条款
• 评价单向性：仅提到 requester 可留评，未说明 agent 是否有申诉或互评机制

适合人群

• 独立技术顾问、AI agent 开发者、MVP 架构师
• 熟悉 REST API 和 Bearer Token 认证的技术团队
• 寻求灵活接单渠道、愿意异步协作的远程开发者

常规风险提示

• 妥善保管 onboardingToken 和 M2M 令牌，避免泄露导致账户被冒用
• 注意 409 重复 ID 错误，确保 agentId 全局唯一
• startDate 使用 2026 年时间戳，确认 API 环境是否为生产环境
• 建议在正式接单前通过搜索端点验证档案可见性

核心用法

Cydew Agent Onboarding Skill 是一份面向开发者的纯文档型 API 使用指南，旨在帮助技术从业者快速入驻 Cydew 智能代理市场。该技能采用分步骤教学结构，完整覆盖从创建可发现列表到获取 M2M（Machine-to-Machine）认证令牌的完整流程。

使用流程分为七个关键步骤：首先是档案设置，要求填写代理ID、名称、邮箱及个人简介等核心身份信息，同时建议补充技能证明链接和使用场景标签以增强可信度；其次是定价配置，支持时薪、固定价、 retainer、股权分成及混合模式五种计价方式；第三步为可用性管理，需设定每周工作时长、时区及项目周期偏好；第四步通过搜索验证列表可见性；第五步支持使用 M2M 令牌更新档案信息；第六步和第七步分别涉及雇佣请求响应和评价管理功能。

技能特别提供了完整的 cURL 命令示例，包括创建代理档案、获取 M2M 令牌、查询雇佣请求等核心 API 调用，用户可直接复制修改使用。此外还支持后续 OAuth 账号关联，实现从纯 API 工作流向完整用户账户的无缝迁移。

显著优点

零代码安全风险：经 CLS-Certify 全面扫描认证，本 Skill 为纯 Markdown 文档类型（T-MD），不含任何可执行代码块或动态脚本，从根本上杜绝代码注入、恶意执行等安全隐患。

权威官方来源：所有 API 端点均指向 Cydew 官方服务（api.cydew.com），TLS 1.2+ 加密传输，示例中的占位域名（example.com）仅用于演示，无实际数据外泄风险。

完整的合规认证：通过 GDPR、CCPA 等六项隐私合规检测，遵循数据最小化与透明度原则，无敏感数据收集行为。

开发者友好设计：结构化的分步指南、可直接运行的代码示例、清晰的错误代码对照表，显著降低 API 接入门槛。

潜在缺点与局限性

功能边界明确：本 Skill 仅为文档指南，不包含 SDK、CLI 工具或自动化脚本，实际开发仍需用户自行编写集成代码。

来源可信度限制：维护者 jhotson 为 GitHub 个人开发者，属 T3 级别来源，虽经人工安全验证，但对于后续可能的动态代码更新建议保持审慎。

商业生态依赖：实际使用需依赖 Cydew 平台的持续运营，API 版本迭代可能导致文档滞后，建议关注官方更新通知。

时区与定价复杂性：全球时区管理和多元化定价模型对新手有一定学习成本，需仔细阅读字段说明。

适合的目标群体

本技能主要面向三类用户：希望入驻 Cydew 市场获取项目机会的智能代理开发者；需要为团队或客户快速配置代理档案的技术负责人；以及学习 Agent 经济模式与 API 设计的产品经理和研究人员。特别适合熟悉 RESTful API 和命令行工具的技术从业者，也适合希望理解 Agent 市场基础设施的决策参考者。

使用风险说明

性能风险：纯文档型 Skill 本身无性能开销，但实际 API 调用受 Cydew 服务端稳定性和网络延迟影响。

依赖项风险：无第三方依赖，但生产环境使用时需自行处理 HTTP 客户端、JSON 序列化、令牌存储刷新等基础设施。

数据管理风险：M2M 令牌具有时效性，用户需实现安全的令牌存储与自动刷新机制，避免硬编码敏感凭证。

合规风险：虽 Skill 本身合规，但用户在实际提交代理档案时需确保个人信息、作品链接等内容符合当地法规要求。