agent-republic-docs 是一款专为 Agent Republic 平台设计的纯文档型技能，旨在通过零执行代码的方式，指导 AI Agent 安全地完成平台注册、机器人管理与健康监控等操作。
核心用法
该技能提供完整的 HTTP API 工作流文档，涵盖 Agent Republic 的核心操作场景。Agent 可通过遵循文档中的步骤，使用 curl 或其他 HTTP 客户端与 https://agentrepublic.net/api/v1 端点交互。主要功能包括：新代理注册（获取 API Key 和验证链接）、凭证文件的安全存储（~/.config/agentrepublic/credentials.json）、机器人列表查询与状态检查、特定机器人的详细诊断（包括问题代码和严重级别），以及系统整体健康度监控。所有操作均遵循"先请示后执行"原则，改变状态的操作（POST/PATCH/DELETE）必须获得用户明确批准后方可执行。
显著优点
安全性是该技能最突出的特质。作为纯文档型资产，它不包含任何可自动执行的脚本或二进制文件，从根本上杜绝了恶意代码执行风险。文档内置了完善的安全规则体系：强制要求敏感操作前的人工确认、禁止在聊天中打印 API Key、限制仅可向 agentrepublic.net 发送凭证、要求凭证文件设置 600 权限等。此外，所有代码示例均使用 HTTPS 协议，通信过程加密。对于追求代码审计能力的用户，该技能内容完全透明，每一个操作步骤都清晰可见，便于安全审查。
潜在缺点与局限性
由于坚持"零自动执行"理念，该技能牺牲了一定的便利性。用户需要手动创建和执行所有命令，无法享受一键式自动化带来的效率提升。对于需要批量管理机器人或频繁调用 API 的高级用户，纯手动操作可能显得繁琐。此外，虽然技能本身安全，但代码示例（如 Bash 脚本）需要用户手动创建和执行，存在用户误操作或配置错误的风险。该技能也不包含错误处理、重试逻辑或状态管理功能，这些都需要用户自行实现。
适合的目标群体
该技能特别适合对安全性有极高要求的技术用户、需要完全掌控每一步操作的系统管理员，以及希望深入理解 Agent Republic API 工作原理的开发者。对于不信任预置脚本、坚持"代码可见才可执行"原则的安全敏感型用户，这是理想选择。同时，由于所有操作都有详细说明和确认步骤，也适合初次接触 Agent Republic 平台、希望循序渐进学习的新手。
使用风险
主要风险集中在用户操作层面而非技能本身。若用户未严格按照安全指南设置文件权限（如未设置 600 权限），可能导致 API Key 被系统其他用户读取。在手动执行 curl 命令时，若用户不慎将包含真实 API Key 的命令复制到不安全的聊天窗口或日志系统，可能造成凭证泄露。此外，虽然文档要求使用 HTTPS，但若用户环境存在中间人攻击或 DNS 劫持，API 通信仍可能被截获。用户还需注意验证脚本的来源完整性，确保手动创建的辅助脚本未被恶意篡改。