feat: add Agent First skill and update READMEs#80
Merged
Conversation
- Add skills/SKILL.md with agent-oriented Skill definition (scope, capabilities, typical queries, quick start) - Add skills/references/firstdata-register.md with token registration, challenge verification, and MCP configuration - Update README.md/README.en.md/README.ja.md: add Agent First branding, Skill badge, Agent Skill row in core advantages table, dual-path Quick Start (Agent auto-onboarding + manual MCP config), consolidate platform configs into single universal JSON + reference table
Collaborator
firstdata-dev
left a comment
firstdata-dev
left a comment
There was a problem hiding this comment.
✅ LGTM. Agent First 方向很棒——让 AI Agent 成为一等公民用户。README 精简效果显著（15 个平台配置块合为 1 个通用 JSON），可读性大幅提升。SKILL.md 结构清晰。建议合并。
mingcha-dev
approved these changes
Mar 23, 2026
Contributor
mingcha-dev
left a comment
mingcha-dev
left a comment
There was a problem hiding this comment.
🔍 明察 QA — PR #80
5 个文件，+341/-1296（大幅精简 README）
- skills/SKILL.md 新增 ✅
- skills/references/firstdata-register.md 新增 ✅
- 三语 README 重构：15 个平台配置块 → 1 个通用 JSON + 参考表 ✅
- 无敏感词 ✅
Agent First 方向很好 👍 LGTM
Flatten metadata fields by removing the unnecessary openclaw hierarchy level.
- Restore metadata.openclaw nesting per spec requirement - Add requires.env declaration for FIRSTDATA_API_KEY - Add emoji field - Rewrite Quick Start with explicit MCP config and transparent service info
mingcha-dev
approved these changes
Mar 23, 2026
Contributor
mingcha-dev
left a comment
mingcha-dev
left a comment
There was a problem hiding this comment.
🔍 明察 QA — PR #80
验证结果
API Endpoint 可达性 ✅
| Endpoint | Method | Response | 状态 |
|---|---|---|---|
/api/agent/register |
POST | 422 (缺字段) | ✅ 在线 |
/api/agent/verify |
POST | 422 (缺字段) | ✅ 在线 |
/mcp |
POST | 401 (需 auth) | ✅ 在线 |
SKILL.md 格式检查 ✅
- frontmatter 格式正确（name/description/version/metadata）
- primaryEnv: FIRSTDATA_API_KEY ✅
- requires.bins: curl ✅
firstdata-register.md 检查 ✅
- 注册→验证两步流程文档完整
- Rate limits 明确（10 RPS / 5000 daily）
- Error handling 表格覆盖全面
- MCP 配置双路径（MCPorter CLI + 手动 JSON）
README 变更检查 ✅
- 三语 README 结构对齐（Agent First 标识 + Skill badge + 快速开始重构）
- 15 个平台配置块精简为 1 个通用 JSON + 平台参考表（大幅减少冗余 👍）
- 内部链接 skills/SKILL.md → 新增文件路径正确
⚠️ 小建议（不阻塞）
- SKILL.md 写 "1000+ global data sources" 但实际目前 292 个，建议改为 "290+ sources" 或 "hundreds of sources" 更准确
mcp_server_url返回的是https://mcp.firstdata.deepminer.com.cn但手动配置写的是https://firstdata.deepminer.com.cn/mcp，两个域名是否都可用？
通过 ✅ Agent First 方向非常好！
firstdata-dev
approved these changes
Mar 23, 2026
Collaborator
firstdata-dev
left a comment
firstdata-dev
left a comment
There was a problem hiding this comment.
老板的 Agent First 品牌升级 PR！SKILL.md 标准化 + README 三语重构 + Agent 自注册流程文档。LGTM ✅
- Add ClawHub badge linking to clawhub.ai/ningzimu/firstdata - Replace verbose agent onboarding steps with `clawhub install` command - Update skill file paths from skills/SKILL.md to skills/firstdata/SKILL.md
2 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
skills/SKILL.md：面向 Agent 的标准化 Skill 定义，包含 Scope、Capabilities、Typical Queries、Quick Start 和 Community 章节skills/references/firstdata-register.md：Agent 自动注册、challenge 激活、MCP 配置（MCPorter CLI + 手动 JSON）的完整流程文档Test plan
skills/SKILL.mdfrontmatter 格式正确skills/references/firstdata-register.md中的 API endpoint URL 正确make check确认不影响现有数据源验证