Run any Skill in Manus with one click

Get Started

github-doc-maintainer

Stars1

Forks0

UpdatedMarch 23, 2026 at 09:55

全自动检索 GitHub 热门仓库，分析并维护项目文档，自动提交 PR。用于发现文档问题（死链、typo、过时内容等）并自动修复提交。当用户需要批量维护开源项目文档、自动提 PR 修复文档问题时触发此技能。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

wnzzer

wnzzer/openclaw-skills

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

11 files

SKILL.md

readonly

name	github-doc-maintainer
description	全自动检索 GitHub 热门仓库，分析并维护项目文档，自动提交 PR。用于发现文档问题（死链、typo、过时内容等）并自动修复提交。当用户需要批量维护开源项目文档、自动提 PR 修复文档问题时触发此技能。

GitHub 文档维护助手

全自动检索 GitHub 热门仓库，发现并修复文档问题，自动提交 PR。

工作流程

1. 检索 → 2. 分析 → 3. 修复 → 4. 提交 PR

1. 检索热门仓库

使用 scripts/fetch_repos.py 检索仓库：

# 按 star 数排序（默认）
python3 scripts/fetch_repos.py --language go --min-stars 1000 --limit 50

# 按最近趋势
python3 scripts/fetch_repos.py --trending --language python --since weekly

# 按 topic 搜索
python3 scripts/fetch_repos.py --topic documentation --min-stars 100

输出：/tmp/gh_repos_YYYYMMDD_HHMMSS.json

2. 分析文档问题

使用 scripts/analyze_docs.py 分析仓库文档健康度：

# 分析已检索的仓库列表
python3 scripts/analyze_docs.py --input /tmp/gh_repos_*.json --workers 5

# 只检查 README
python3 scripts/analyze_docs.py --input repos.json --readme-only

检测的问题类型：

死链（404 链接）
拼写错误（常见 typo）
过时的 badge/shield
失效的 anchor 链接
图片加载失败

输出：/tmp/doc_issues_YYYYMMDD_HHMMSS.json

3. 生成修复

使用 scripts/generate_fixes.py：

python3 scripts/generate_fixes.py --input /tmp/doc_issues_*.json --output ./fixes/

生成结构：

./fixes/
├── owner_repo/
│   ├── README.md.fixed      # 修复后的文档
│   ├── fixes.json           # 修复详情
│   └── pr_description.md    # PR 描述模板

4. 选择修复项（可选）

使用 scripts/select_fixes.py 交互式选择要提交的修复：

# 交互式选择
python3 scripts/select_fixes.py --input ./fixes/

# 自动选择全部
python3 scripts/select_fixes.py --input ./fixes/ --auto-select all

# 自动选择指定项
python3 scripts/select_fixes.py --input ./fixes/ --auto-select "1,3,5"

选择方式：

all - 选择全部
none - 取消全部
1,3,5 - 选择第 1、3、5 项
1-5 - 选择第 1 到 5 项
-2 - 排除第 2 项（先选全部再排除）

5. 自动提交 PR

使用 scripts/submit_prs.py：

# 需要配置 GH_TOKEN 环境变量
export GH_TOKEN="ghp_xxxxxxxx"

# 批量提交（确认模式）
python3 scripts/submit_prs.py --input ./fixes/ --confirm

# 全自动模式（无需确认）
python3 scripts/submit_prs.py --input ./fixes/ --auto

PR 流程：

Fork 目标仓库
创建修复分支 (doc-fix-YYYYMMDD)
提交修改
创建 PR（使用模板描述）

完整自动化命令

一键执行全流程：

# 全自动模式（无需确认，提交所有）
python3 scripts/auto_maintain.py \
  --language go \
  --min-stars 1000 \
  --limit 20 \
  --auto

# 交互式选择模式（推荐）
python3 scripts/auto_maintain.py \
  --language go \
  --min-stars 1000 \
  --limit 20 \
  --select

# 干跑测试（不实际提交）
python3 scripts/auto_maintain.py \
  --language go \
  --min-stars 1000 \
  --limit 20 \
  --dry-run

配置

GitHub Token

需要 Personal Access Token（classic）：

public_repo - 访问公共仓库
repo - 如果需要访问私有仓库

export GH_TOKEN="ghp_xxxxxxxx"

速率限制

GitHub API 限制：

未认证：60 请求/小时
已认证：5000 请求/小时

脚本会自动处理速率限制和重试。

自定义规则

编辑 references/check_rules.json 添加自定义检查规则：

添加特定的 typo 映射
配置忽略的链接模式
自定义 badword 检测

注意事项

礼貌原则：批量 PR 注意频率，避免 spam
- 已内置速率限制：每天最多 10 个 PR，同一仓库 7 天冷却期
小步快跑：一次 PR 只修复一个明确问题
测试先行：首次使用加 --dry-run 检查
遵守规范：遵循目标项目的贡献指南
敏感项目：大型项目（如 torvalds/linux）建议手动提交

最佳实践

避免被标记为 Spam

不要频繁向同一仓库发送 PR（已自动限制）
不要只修复一个标点符号
避免修改测试文件或生成的文档
尊重 .github/CONTRIBUTING.md 中的特殊要求

查看优化建议

cat OPTIMIZATION.md

依赖

pip install requests urllib3 beautifulsoup4 pyspellchecker

或运行：

pip install -r scripts/requirements.txt

More from this repository

same repository

compress

wnzzer/openclaw-skills

Compress text semantically with iterative validation, anchor checksums, and verified information preservation.

2026-03-231

ddg-search

wnzzer/openclaw-skills

Web search without an API key using DuckDuckGo Lite via web_fetch. Use as a fallback when web_search fails with missing_brave_api_key error, or whenever you need to search the web and no search API is configured. Provides titles, URLs, and snippets for research queries. Zero dependencies — works with just the built-in web_fetch tool.

2026-03-231

eastmoney-financial-data

wnzzer/openclaw-skills

东方财富金融数据查询工具。支持行情数据（股价、资金流向、估值）、财务数据（财报、股东结构、高管信息）、关系与经营数据。通过自然语言查询，如"东方财富最新价"、"贵州茅台市盈率"。当用户需要查询股票、基金、指数、板块等金融数据时使用此skill。需要先配置apikey才能使用。

2026-03-231

eastmoney-financial-search

wnzzer/openclaw-skills

东方财富资讯搜索工具。基于东方财富妙想搜索能力，用于获取金融相关的新闻、公告、研报、政策、交易规则、事件分析、影响解读等时效性信息。支持个股资讯、板块新闻、宏观分析等。当用户需要搜索金融资讯、了解市场动态、查看研报解读时使用此skill。需要先配置apikey才能使用。

2026-03-231

eastmoney-select-stock

wnzzer/openclaw-skills

东方财富智能选股工具。支持基于自然语言查询筛选股票，包括行情指标、财务指标等条件；可查询指定行业/板块内的股票；支持A股、港股、美股。当用户需要选股、筛选股票、按条件查找股票时使用此skill。需要先配置apikey才能使用。

2026-03-231

file-compression

wnzzer/openclaw-skills

Compress files to reduce storage and transfer size. Use this skill when users ask to shrink PDFs or images, optimize upload/share size, or balance quality and size. Supports PDF compression and image compression with Python-first workflows plus Node.js fallback when Python dependencies are unavailable.

2026-03-231

name	github-doc-maintainer
description	全自动检索 GitHub 热门仓库，分析并维护项目文档，自动提交 PR。用于发现文档问题（死链、typo、过时内容等）并自动修复提交。当用户需要批量维护开源项目文档、自动提 PR 修复文档问题时触发此技能。

GitHub 文档维护助手

全自动检索 GitHub 热门仓库，发现并修复文档问题，自动提交 PR。

工作流程

1. 检索 → 2. 分析 → 3. 修复 → 4. 提交 PR

1. 检索热门仓库

使用 scripts/fetch_repos.py 检索仓库：

# 按 star 数排序（默认）
python3 scripts/fetch_repos.py --language go --min-stars 1000 --limit 50

# 按最近趋势
python3 scripts/fetch_repos.py --trending --language python --since weekly

# 按 topic 搜索
python3 scripts/fetch_repos.py --topic documentation --min-stars 100

输出：/tmp/gh_repos_YYYYMMDD_HHMMSS.json

2. 分析文档问题

使用 scripts/analyze_docs.py 分析仓库文档健康度：

# 分析已检索的仓库列表
python3 scripts/analyze_docs.py --input /tmp/gh_repos_*.json --workers 5

# 只检查 README
python3 scripts/analyze_docs.py --input repos.json --readme-only

检测的问题类型：

死链（404 链接）
拼写错误（常见 typo）
过时的 badge/shield
失效的 anchor 链接
图片加载失败

输出：/tmp/doc_issues_YYYYMMDD_HHMMSS.json

3. 生成修复

使用 scripts/generate_fixes.py：

python3 scripts/generate_fixes.py --input /tmp/doc_issues_*.json --output ./fixes/

生成结构：

./fixes/
├── owner_repo/
│   ├── README.md.fixed      # 修复后的文档
│   ├── fixes.json           # 修复详情
│   └── pr_description.md    # PR 描述模板

4. 选择修复项（可选）

使用 scripts/select_fixes.py 交互式选择要提交的修复：

# 交互式选择
python3 scripts/select_fixes.py --input ./fixes/

# 自动选择全部
python3 scripts/select_fixes.py --input ./fixes/ --auto-select all

# 自动选择指定项
python3 scripts/select_fixes.py --input ./fixes/ --auto-select "1,3,5"

选择方式：

all - 选择全部
none - 取消全部
1,3,5 - 选择第 1、3、5 项
1-5 - 选择第 1 到 5 项
-2 - 排除第 2 项（先选全部再排除）

5. 自动提交 PR

使用 scripts/submit_prs.py：

# 需要配置 GH_TOKEN 环境变量
export GH_TOKEN="ghp_xxxxxxxx"

# 批量提交（确认模式）
python3 scripts/submit_prs.py --input ./fixes/ --confirm

# 全自动模式（无需确认）
python3 scripts/submit_prs.py --input ./fixes/ --auto

PR 流程：

Fork 目标仓库
创建修复分支 (doc-fix-YYYYMMDD)
提交修改
创建 PR（使用模板描述）

完整自动化命令

一键执行全流程：

# 全自动模式（无需确认，提交所有）
python3 scripts/auto_maintain.py \
  --language go \
  --min-stars 1000 \
  --limit 20 \
  --auto

# 交互式选择模式（推荐）
python3 scripts/auto_maintain.py \
  --language go \
  --min-stars 1000 \
  --limit 20 \
  --select

# 干跑测试（不实际提交）
python3 scripts/auto_maintain.py \
  --language go \
  --min-stars 1000 \
  --limit 20 \
  --dry-run

配置

GitHub Token

需要 Personal Access Token（classic）：

public_repo - 访问公共仓库
repo - 如果需要访问私有仓库

export GH_TOKEN="ghp_xxxxxxxx"

速率限制

GitHub API 限制：

未认证：60 请求/小时
已认证：5000 请求/小时

脚本会自动处理速率限制和重试。

自定义规则

编辑 references/check_rules.json 添加自定义检查规则：

添加特定的 typo 映射
配置忽略的链接模式
自定义 badword 检测

注意事项

礼貌原则：批量 PR 注意频率，避免 spam
- 已内置速率限制：每天最多 10 个 PR，同一仓库 7 天冷却期
小步快跑：一次 PR 只修复一个明确问题
测试先行：首次使用加 --dry-run 检查
遵守规范：遵循目标项目的贡献指南
敏感项目：大型项目（如 torvalds/linux）建议手动提交

最佳实践

避免被标记为 Spam

不要频繁向同一仓库发送 PR（已自动限制）
不要只修复一个标点符号
避免修改测试文件或生成的文档
尊重 .github/CONTRIBUTING.md 中的特殊要求

查看优化建议

cat OPTIMIZATION.md

依赖

pip install requests urllib3 beautifulsoup4 pyspellchecker

或运行：

pip install -r scripts/requirements.txt