Zer4tul
d1a746a8cb
- docs/agent-api-reference.md (473 lines): complete HTTP API reference for all 12 endpoints - docs/agent-onboarding-guide.md (272 lines): ssh_cli and http_pull workflows, Forgejo integration - skill/SKILL.md (281 lines): universal agent skill, platform-agnostic, curl-based examples All content in English. No code changes.
1.9 KiB
1.9 KiB
1. API 参考文档
- 1.1 创建
docs/agent-api-reference.md - 1.2 列出所有公开端点（~12 个），每个包含：HTTP 方法、URL、请求体、响应体、错误码、curl 示例
- 1.3 认证部分：http_pull token、webhook HMAC-SHA256 签名
- 1.4 错误码汇总：401/403/404/400/500，每个附触发场景
- 1.5 通用说明：base_url、Content-Type、字符编码、分页（如有）
2. Agent 接入指南
- 2.1 创建
docs/agent-onboarding-guide.md - 2.2 两种执行模式对比表（ssh_cli vs http_pull）
- 2.3 ssh_cli 模式完整工作流：配置 host → CLI 安装 → 自动调度 → PR 工作流
- 2.4 http_pull 模式完整工作流：register → heartbeat → dequeue → execute → complete/receipt
- 2.5 Forgejo 集成说明：Issue → Task、分支命名、PR 生命周期
- 2.6 结构化 prompt 格式说明（ssh_cli 模式下 Agent 收到的 prompt 结构）
- 2.7 常见问题 FAQ
3. 通用 Agent Skill
- 3.1 创建
skill/SKILL.md（YAML frontmatter + Markdown body） - 3.2 Quick Start：最简接入示例（3 步以内）
- 3.3 Instructions：详细 API 调用流程（register → heartbeat → dequeue → execute → complete）
- 3.4 Examples：每种操作的 curl 示例
- 3.5 Guidelines：错误处理、重试策略、认证规则
- 3.6 执行模式选择指南：Agent 如何判断自己用 ssh_cli 还是 http_pull
- 3.7 Forgejo 工作流说明（分支命名、PR 创建、webhook 触发）
- 3.8 验证：Skill 内容与 API 参考文档一致、curl 示例可执行
4. 验证
- 4.1 API 参考文档覆盖所有已实现端点
- 4.2 curl 示例基于 arm0 实例可执行
- 4.3 Skill 格式符合标准规范（YAML frontmatter + Markdown body）
- 4.4 Skill 不包含任何平台特定语法
- 4.5 接入指南与当前代码实现一致