SuperAPI AI 工具集

add-doc-updater

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:为指定的 Claude 技能添加一套可自我维护的文档流水线,自动下载上游文档、将 Markdown 处理为适合 AI 消费的形式、把链接转换为本地导航形式,并在两次更新之间强制冷却期。

主要能力:基于内置模板 references/doc-updater-template.md 生成 Python 同步脚本;通过 5 阶段编排流程(收集变量、实现、代码审查、质量门禁、测试验证、集成)逐步推进,每阶段设质量门禁;失败时回退到实现阶段并携带错误上下文重试。

使用方式:以目标技能路径作为参数调用。阶段 0 需收集 6 个模板变量:SKILL_NAME、DOC_SOURCE_URL(须为可下载的 tar.gz 或 zip 文档归档)、DOC_PATH_IN_ARCHIVE、LOCAL_DOC_DIR、DOC_DESCRIPTION、COOLDOWN_DAYS(默认 7)。随后替换模板占位符,委派 @python-cli-architect 实现脚本,经 @python-code-reviewer 审查,再依次执行 ruff format、ruff check、mypy、pyright、uv run prek run --files 等质量门禁,最后完成 7 项验证测试与集成(更新 SKILL.md 执行协议、.gitignore、集成测试)。

适用场景:需要让 Claude 技能持续同步上游文档、减少手工维护的场合。

限制:文档源必须是可下载的 tar.gz 或 zip 归档;脚本路径、冷却天数等细节依赖用户输入;具体收费、平台支持范围等资料暂未提供。