---
name: gitlink-newcomer-guide
version: 1.0.0
description: "新人引导：为 good-first-issue 自动添加引导评论，降低新贡献者参与门槛。当项目收到新贡献者或标记了 good-first-issue 时触发。"
metadata:
  requires:
    bins: ["gitlink-cli"]
  cliHelp: "gitlink-cli issue --help"
---

# gitlink-newcomer-guide（新人引导）

**CRITICAL — 开始前必须先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md)，其中包含认证、权限处理和 API 注意事项。**
**CRITICAL — 所有 Shortcuts 在执行写入/删除操作前，务必先确认用户意图。**

## 说明

本 Skill 帮助项目维护者为新贡献者创建友好的入门体验。自动识别标记为 good-first-issue 的 Issue，并为其添加结构化的引导评论，降低新贡献者的参与门槛。

## 依赖的 Shortcuts

| Shortcut | 用途 |
|----------|------|
| `issue +list` | 获取标记了 good-first-issue 的 Issue |
| `issue +view` | 查看 Issue 详细内容 |
| `issue +comment` | 添加引导评论 |
| `label +list` | 查看可用标签 |
| `repo +info` | 获取仓库基本信息 |

## 工作流程

```
1. issue +list                       → 获取所有打开的 Issue
2. 筛选含 good-first-issue 标签的 Issue
3. issue +view --number {id}        → 查看 Issue 详情
4. 分析 Issue 内容                    → 判断适合的引导信息
5. issue +comment --body "..."      → 添加引导评论
6. 可选：issue +update               → 分配 mentor
```

## 引导评论模板

根据 Issue 类型选择合适的引导评论：

### Bug 类 Issue

```markdown
你好！欢迎参与贡献 🎉

这个 Issue 被标记为 **good first issue**，非常适合作为你的第一个贡献。

## 如何开始

1. 在评论区留言"我想认领这个 Issue"，我们会把你添加到 Assignee
2. 查看 [CONTRIBUTING.md](../CONTRIBUTING.md) 了解开发环境搭建
3. Fork 本仓库并创建你的功能分支
4. 修复问题后提交 Pull Request

## 需要帮助？

- 如果对问题描述有疑问，可以在下方留言
- 在开发过程中遇到任何问题，也欢迎随时提问

祝你编码愉快！
```

### 功能需求类 Issue

```markdown
你好！欢迎参与贡献 🎉

这个 Issue 被标记为 **good first issue**，适合作为你了解本项目的起点。

## 实现思路

1. 建议先阅读相关模块的源代码，了解现有实现
2. 可以参考已有的类似功能实现
3. 记得添加对应的单元测试

## 提交流程

1. Fork 仓库并创建分支
2. 实现功能并编写测试
3. 确保 `go test ./...` 全部通过
4. 提交 Pull Request，描述你的改动

如有任何问题，随时留言！
```

### 文档类 Issue

```markdown
你好！欢迎参与贡献 🎉

感谢你对改进文档的兴趣！

## 文档贡献指南

1. 文档位于项目中的 `docs/` 目录下
2. 使用 Markdown 格式编写
3. 修改后请预览效果，确保格式正确
4. 提交 Pull Request，描述你的改动

## 注意事项

- 保持文档风格一致
- 中英文之间保留空格
- 代码块请标注语言类型

期待你的贡献！
```

## 使用示例

```bash
# 1. 查找所有标记了 good-first-issue 的 Issue
gitlink-cli issue +list --owner myuser --repo myrepo --state open --format json

# 2. 查看某个 Issue 的详细内容（判断类型）
gitlink-cli issue +view --owner myuser --repo myrepo --number 10 --format json

# 3. 查看仓库可用标签
gitlink-cli label +list --owner myuser --repo myrepo

# 4. 添加引导评论
gitlink-cli issue +comment --owner myuser --repo myrepo --number 10 --body "你好！欢迎参与贡献..."

# 5. 可选：将 Issue 标记为已分配
gitlink-cli issue +update --owner myuser --repo myrepo --number 10
```

## 注意事项

- 添加引导评论前，先检查该 Issue 是否已有引导评论（避免重复）。
- 如果 Issue 已经被 Assignee 认领，不需要再添加引导评论。
- 不要修改 good-first-issue 标签，由项目维护者管理。
- 引导评论建议使用温和、鼓励的语气。
