gitlink-stale

陈旧 Issue/PR 清理的 GitLink AI Agent Skill。检测久未更新的开放 Issue 与 PR，按陈旧度分级，生成清理建议清单，帮助维护者控制积压。

GitLink 智能化服务开源项目贡献赛 子赛题二（编写和丰富 GitLink Skills） 参赛作品。作者：Ct201314

它解决什么

仓库 Issue/PR 越积越多，维护者难以判断哪些该清理。gitlink-stale 自动化它：

• 扫描所有开放 Issue/PR，按”最近更新距今”分四级：🟢活跃 / 🟡留意 / 🟠陈旧 / 🔴僵尸
• 列出需要处理的陈旧/僵尸项，按停滞时长排序
• 给出分级处理建议与关闭命令

安装与使用

作为 Agent Skill：把 SKILL.md 与 scripts/ 放入 Agent 技能目录。

直接运行：

python scripts/stale.py --owner Gitlink --repo gitlink-cli

目录结构

gitlink-stale/
├── SKILL.md
├── scripts/  glapi.py + stale.py
├── references/  api-reference.md + grading.md
├── examples/  真实清理报告
├── tests/test_stale.py（16 用例）
├── requirements.txt
└── LICENSE

真实验证

在 Gitlink/gitlink-cli 上运行，27 个开放项分级（活跃 20 / 留意 6 / 陈旧 1）， 识别出 1 个停滞 60 天的陈旧 Issue 并给出处理建议。产物见 examples/。

python -m pytest tests/ -q   # 16 passed

设计要点

• 四级分级：用直观的红绿灯等级，维护者一眼分清轻重缓急。
• 相对时间估算：兼容 GitLink 返回的”N天前/N个月前”格式。
• 只读 + 建议：只生成清理清单，关闭操作由维护者确认执行，不擅自写远程。

许可证

Mulan PSL v2，与 gitlink-cli 主仓库保持一致。