jieran-zhang/cannbot-skills/fixer-broken-link

Step 1: 仓库检测与准备
    │
    ├── 检测仓库路径（当前目录/父目录/自动 clone）
    ├── 更新到 master 分支最新代码
    │
    ▼
Step 2: 断链扫描
    │
    ├── 扫描所有 Markdown 文件
    ├── 解析链接（相对路径、绝对路径、外部链接）
    ├── 验证链接目标是否存在
    ├── 分类断链类型
    │
    ▼
Step 3: 断链分析与分类
    │
    ├── 路径错误：修正路径
    ├── 文件不存在：删除链接或标注待补充
    ├── 外部链接：跳过（无法修复）
    ├── 链接换行：合并单行
    │
    ▼
Step 4: 自动修复（可选）
    │
    ├── 修正路径错误
    ├── 删除不存在链接
    ├── 合并换行链接
    │
    ▼
Step 5: 创建 PR（可选）
    │
    ├── 创建修复分支
    ├── 提交修改
    ├── 推送到 fork
    ├── 创建 PR 到 upstream

reports/
└── broken-link-fixer/
    ├── {repo}_broken_link_report_{timestamp}.md     # 断链扫描报告
    ├── {repo}_broken_link_fix_report_{timestamp}.md # 修复报告
    ├── issues/
    │   ├── {repo}_broken_link_high_{timestamp}.md   # 高优先级断链 Issue
    │   ├── {repo}_broken_link_medium_{timestamp}.md # 中优先级断链 Issue
    │   └── {repo}_broken_link_low_{timestamp}.md    # 低优先级断链 Issue
    └── his/

# [Documentation]: [AI 识别] {repo} README 断链问题
 
## 文档链接
 
{readme_path}
 
## 问题摘要
 
{断链数量} 处断链分布在 {文件数} 个 README 中：
 
| 断链类型 | 数量 | 可自动修复 |
|---------|:---:|:---:|
| 路径错误 | {n} | ✅ |
| 文件不存在 | {n} | ❌ |
| 外部链接失效 | {n} | ❌ |
 
## 详细问题列表
 
### 可自动修复
 
| README | 链接 | 问题 | 修复方案 |
|--------|------|------|---------|
 
### 需人工处理
 
| README | 链接 | 问题 | 建议 |
|--------|------|------|---------|
 
## 建议修复
 
1.使用 `fixer-broken-link` Skill 自动修复可修复的断链
2.手动处理需要补充文档的断链

# 扫描断链（仅报告）
python .opencode/skills/fixer-broken-link/scripts/scan_links.py --repo ops-math
 
# 扫描并自动修复
python .opencode/skills/fixer-broken-link/scripts/scan_links.py --repo ops-math --fix
 
# 修复并创建 PR
python .opencode/skills/fixer-broken-link/scripts/scan_links.py --repo ops-math --fix --create-pr
 
# 仅扫描 README
python .opencode/skills/fixer-broken-link/scripts/scan_links.py --repo ops-math --scope readme
 
# dry-run 模式
python .opencode/skills/fixer-broken-link/scripts/scan_links.py --repo ops-math --fix --dry-run

1. 扫描断链 → fixer-broken-link（仅报告）
2. 分析结果 → 确认可修复的断链
3. 自动修复 → fixer-broken-link --fix
4. 创建 PR  → 参考 gitcode-toolkit/SKILL.md 的 PR 创建工作流

.opencode/skills/fixer-broken-link/
├── SKILL.md              # 本文件
└── scripts/
    ├── scan_links.py     # 断链扫描脚本
    ├── fix_links.py      # 断链修复脚本
    └── create_fix_pr.py  # 创建修复 PR 脚本