SuperAPI AI 工具集

docs-watch

通用与其它

查看项目

更新于 10-15 17:32

技能介绍

用途:检测镜像到 skills/celopedia-skill/references/ 的事实是否与其实时来源发生漂移,并将所有发现(机械修正与模糊/高风险标记)汇总为每次运行一个提交到 celo-org/celopedia-skills:main 的可评审 PR,供人工批准、编辑或关闭。

主要能力:检查 Docs sitemap(curl -s https://docs.celo.org/llms.txt 对应 docs-map.md)、合约地址(docs.celo.org 的 core-contracts、token-contracts、l1-contracts、uniswap-contracts 对应 contracts.md)、网络信息(network-overview 对应 network-info.md)、生态/TVL(curl -s https://api.llama.fi/protocols | jq '[.[] | select(.chains[]? == "Celo")]' 对应 ecosystem.md)、资助计划(celopg.eco/programs 对应 grants-funding.md)、MiniPay 文档(docs.minipay.xyz 页面树、submit-your-miniapp.html、best-practices.html、deeplinks.html 对应 minipay-docs-map.md、minipay-requirements.md、minipay-common-mistakes.md)。对差异分三类:no action 不提及;reference update 机械且无歧义的事实变化直接改参考文件;needs review 模糊或高风险(合约地址不符、链 ID / 手续费币种地址变化等)不编辑,只写入 PR 正文的 Needs review 部分。

使用方式:读取 .claude/skills/docs-watch/snapshot.md 快照,抓取各来源并与快照和参考文件比对、分类。有漂移时:从 main 建分支如 docs-watch/<YYYY-MM-DD>,应用机械修改,若有参考文件变更则 patch 提升 skills/celopedia-skill/SKILL.md 的 version,更新快照,推送分支后用 gh pr create --repo celo-org/celopedia-skills --base main --head <branch> --title "docs-watch: weekly refresh — <date>" --body "..." 开一个 PR(PR 正文即报告)。来源不可达时:另建 blocked 分支,仅改 snapshot.md 中 Last attempt 行,开标题 docs-watch: blocked — <date> 的信息性 PR。全部可达且无动作时:不开 PR、不提交,仅最后简短总结。MiniPay 部分将结构事实(页面增删改名、deeplink 变化)直接更新 minipay-docs-map.md,而清单政策(支持/强制代币、SLA、依赖安全策略、提交表单 URL 或字段、白名单规则、最小视口、性能门槛)永不自动编辑,只描述变化对比。

适用场景与限制:用于保持“硬编码参考”层与实时来源一致;live-data-sources.md 已定义优先级(实时 API > 官方文档 > 硬编码参考 > 生态目录),本技能不替代其他地方实时查询。绝不为 needs review 项猜测合约地址或链参数。资料未提供具体版本号、运行环境、价格与频率等细节。