Exec ClawHub Publish Doctor
Stabilize ClawHub publishing with preflight checks, safer publish commands, and post-publish verification that tolerates temporary registry states.
Quick workflow
- 1. Run preflight checks:
-
scripts/clawhub_preflight.sh
- 2. If login/browser issues appear, follow
references/error-map.md. - Publish with retry-aware verification:
-
scripts/clawhub_publish_safe.sh <skill_path> <slug> <name> <version> [changelog]
- 4. For GitHub search failures like
Unknown JSON field, use:
-
scripts/gh_search_repos_safe.sh "<query>" [limit]
- 5. If errors persist, classify with
references/error-map.md before escalating.
Standard commands
Preflight
CODEBLOCK0
Login (token-based, headless-safe)
CODEBLOCK1
Safe publish
CODEBLOCK2
Manual inspect
CODEBLOCK3
Safe GitHub repo search (schema-aware)
CODEBLOCK4
Rules
- - Prefer token login in server/headless environments.
- Treat
inspect errors right after publish as potentially transient for a few minutes. - Verify with both CLI (
clawhub inspect) and web URL (/skills/<slug>). - For
gh search repos --json failures, prefer fullName over unsupported aliases like nameWithOwner, or run scripts/gh_search_repos_safe.sh. - Use canonical URLs:
- Skill:
https://clawhub.ai/skills/<slug>
- Owner/slug:
https://clawhub.ai/<handle>/<slug>
- User profile (if available): INLINECODE15
Resources
- -
references/error-map.md: quick diagnosis for common failure signatures. - INLINECODE17 : dependency + environment checks.
- INLINECODE18 : publish + retry verification wrapper.
- INLINECODE19 : resilient
gh search repos wrapper with JSON-field mismatch fallback.
Exec ClawHub Publish Doctor
通过预检检查、更安全的发布命令以及容忍临时注册表状态的发布后验证，稳定ClawHub发布流程。
快速工作流程
- 1. 运行预检检查：
- scripts/clawhub_preflight.sh
- 2. 如果出现登录/浏览器问题，请参考references/error-map.md。
- 使用带重试感知的验证进行发布：
- scripts/clawhub
publishsafe.sh <技能路径> <标识符> <名称> <版本> [更新日志]
- 4. 对于类似Unknown JSON field的GitHub搜索失败，使用：
- scripts/gh
searchrepos_safe.sh <查询> [限制数量]
- 5. 如果错误持续存在，在升级前使用references/error-map.md进行分类。
标准命令
预检
bash
bash scripts/clawhub_preflight.sh
登录（基于令牌，无头环境安全）
bash
clawhub login --token
clawhub whoami
安全发布
bash
bash scripts/clawhubpublishsafe.sh ./my-skill my-skill My Skill 1.0.0 初始版本
手动检查
bash
clawhub inspect my-skill --json
安全的GitHub仓库搜索（模式感知）
bash
bash scripts/ghsearchrepos_safe.sh safe-exec skill 15
规则
- - 在服务器/无头环境中优先使用令牌登录。
- 将发布后立即出现的inspect错误视为可能几分钟内暂时性的。
- 同时使用CLI（clawhub inspect）和网页URL（/skills/<标识符>）进行验证。
- 对于gh search repos --json失败，优先使用fullName而非不支持的别名如nameWithOwner，或运行scripts/ghsearchrepos_safe.sh。
- 使用规范URL：
- 技能：https://clawhub.ai/skills/<标识符>
- 所有者/标识符：https://clawhub.ai/<用户名>/<标识符>
- 用户个人资料（如可用）：https://clawhub.ai/users/<用户名>
资源
- - references/error-map.md：常见故障特征的快速诊断。
- scripts/clawhubpreflight.sh：依赖项+环境检查。
- scripts/clawhubpublishsafe.sh：发布+重试验证封装。
- scripts/ghsearchrepossafe.sh：具有JSON字段不匹配回退的弹性gh search repos封装。
