gitlink-newcomer

一个面向新贡献者引导的 GitLink AI Agent Skill。识别仓库中适合新手上手的 Issue，评估上手难度与友好度，为候选 Issue 生成个性化引导评论，并产出新手任务看板，帮助开源项目降低新人参与门槛。

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

作者：Ct201314

它解决什么

开源项目想吸引新贡献者，但新人常常面对一长串 Issue 不知从何下手；维护者也很难逐个标注哪些适合新手。gitlink-newcomer 把这件事自动化：

• 自动从开放 Issue 中识别适合新手的任务（综合标签、关键词、描述长度、讨论热度多信号）
• 为每个 Issue 打出 0-100 友好度分和难度等级（入门/较易/中等/进阶）
• 为候选 Issue 生成个性化引导评论（含上手步骤与 Fork/PR 流程）
• 汇总成一份新手任务看板，可贴到 Wiki 或 README

安装

作为 Agent Skill

把本仓库的 SKILL.md 与 scripts/ 放入你的 Agent 技能目录（Claude Code、Cursor、Kiro CLI 等兼容 Agent Skills 规范的平台），向 Agent 提出诉求即可触发，例如：

「帮我看看 Gitlink/gitlink-cli 有哪些适合新人上手的 Issue」

直接运行脚本

脚本仅依赖 Python 标准库，数据走 GitLink 公开 API，无需登录：

# 生成新手任务看板
python scripts/newcomer.py --owner Gitlink --repo gitlink-cli

# JSON 输出（含每个候选的引导文案）
python scripts/newcomer.py --owner Gitlink --repo gitlink-cli --format json

# 为单个 Issue 生成引导评论
python scripts/newcomer.py --owner Gitlink --repo gitlink-cli --issue 12

目录结构

gitlink-newcomer/
├── SKILL.md                  Skill 定义（YAML front-matter + 工作流）
├── scripts/
│   ├── glapi.py              GitLink 公开 API 客户端（自包含）
│   └── newcomer.py           新人引导分析脚本
├── examples/                 真实运行产物示例
├── tests/test_newcomer.py    单元测试（17 个用例）
├── requirements.txt
└── LICENSE

真实验证

在 Gitlink/gitlink-cli（17 个开放 Issue）上运行，正确识别出 5 个新手友好任务并生成看板，产物见 examples/。

单元测试：

python -m pytest tests/ -q   # 17 passed

设计要点

• 多信号识别：不只看标签，还结合标题/正文关键词、描述长度、讨论热度综合评分，对没有规范打标签的项目同样有效。
• 正确处理 ID 混淆：GitLink Issue 列表接口只返回全局数据库 id，本工具不会把它误当作 web 序号——发评论时用 issue +comment --number <web序号>。
• 只读安全：脚本默认只生成引导内容，不自动发布；发布评论由用户通过 gitlink-cli 确认执行。

许可证

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