forked from Gitlink/gitlink-cli
docs(子赛题二): 新增 README 明确交付对照赛题要求
新增 提交材料/子赛题二-Skills/README.md,逐条对照子赛题二要求: - 遵循 gitlink-cli Skills 规范(skills/README.md) - 每个 Skill 含 SKILL.md + 使用示例(examples/)+ REFERENCE.md - Claude Code 平台验证通过 + 兼容 - 演示录屏/截图 + 演示输入提示词 并列出 23 个 Skill 位置(skills/ 19 + workflow/skills 4)与智能分析型/命令操作型分类。
This commit is contained in:
parent
7352b8c765
commit
08aa94d4ef
|
|
@ -5,7 +5,7 @@
|
|||
| 子赛题 | 目录 | 状态 | 内容 |
|
||||
|--------|------|------|------|
|
||||
| 一 · CLI 能力增强 | [子赛题一-CLI能力/](子赛题一-CLI能力/) | ✅ 就绪 | [变更说明.md](子赛题一-CLI能力/变更说明.md);PR 提交至主仓库 |
|
||||
| 二 · 编写 Skills | [子赛题二-Skills/](子赛题二-Skills/) | ✅ 就绪 | [demos/](子赛题二-Skills/demos/):演示录屏 + 截图 |
|
||||
| 二 · 编写 Skills | [子赛题二-Skills/](子赛题二-Skills/) | ✅ 就绪 | [README](子赛题二-Skills/README.md)(交付对照赛题要求)+ [demos/](子赛题二-Skills/demos/) 演示录屏截图;23 个 Skill 在 `skills/` |
|
||||
| 三 · 工作流 | [子赛题三-工作流/](子赛题三-工作流/) | ✅ 就绪 | [工作流说明](子赛题三-工作流/工作流说明.md) + [架构图](子赛题三-工作流/架构图.png) + [执行脚本](子赛题三-工作流/执行脚本.sh) + [Agent 对话记录](子赛题三-工作流/Agent对话记录.md) + [demos/](子赛题三-工作流/demos/)(社区运营自动化) |
|
||||
| 四 · 辅助科研 | [子赛题四-科研/](子赛题四-科研/) | ✅ 就绪 | [使用文档](子赛题四-科研/子任务四-使用文档.md) + [科研场景应用报告](子赛题四-科研/子任务四-科研场景应用报告.md) + [场景输出结果/](子赛题四-科研/场景输出结果/) + [演示录屏/](子赛题四-科研/演示录屏/)(spark + research-fair) |
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,61 @@
|
|||
# 子赛题二 · 编写和丰富 GitLink Skills
|
||||
|
||||
本目录存放子赛题二的交付物。**核心交付是 Skill 本身**(SKILL.md + 使用示例 + Agent 平台验证),不是某个具体功能。
|
||||
|
||||
## 交付对照(赛题要求 → 我们的交付)
|
||||
|
||||
| 赛题要求 | 我们的交付 |
|
||||
|---------|-----------|
|
||||
| ① 遵循 gitlink-cli Skills 规范(参考 `skills/README.md`) | ✅ 全部 Skill 遵循统一规范;规范文档见仓库 [`skills/README.md`](../../skills/README.md) |
|
||||
| ② 每个 Skill 包含:SKILL.md + 使用示例 | ✅ 每个 Skill 目录标配 `SKILL.md`(流程+命令)+ `REFERENCE.md`(字段+算法+踩坑)+ `examples/`(真实跑的输出) |
|
||||
| ③ 至少在一个 Agent 平台上验证通过 | ✅ 已在 **Claude Code** 实测验证,AI 能读 SKILL.md 自动调用 gitlink-cli 完成任务 |
|
||||
| ④ 兼容至少一个主流 AI Agent | ✅ **Claude Code**;`scripts/setup-skills.sh` 一键把全部 Skill 装入 `~/.claude/skills/` |
|
||||
| ⑤ 提供演示录屏或截图 | ✅ 见 [`demos/`](demos/):演示录屏 + 截图 |
|
||||
|
||||
## Skill 位置
|
||||
|
||||
共 **23 个 Skill**(均为 Claude Code 可加载的标准 `SKILL.md`),分布在两处:
|
||||
|
||||
- [`skills/gitlink-*`](../../skills/) —— **19 个通用 Skill**
|
||||
- [`shortcuts/workflow/skills/gitlink-*`](../../shortcuts/workflow/skills/) —— **4 个工作流专属 Skill**(随工作流引擎归位,子赛题三调用)
|
||||
|
||||
### 智能分析型(8 个,赛题建议场景全覆盖)
|
||||
|
||||
| Skill | 场景 | 对应赛题示例 |
|
||||
|-------|------|-------------|
|
||||
| `gitlink-health` | 项目健康度报告(Issue 响应/PR 合并/活跃度评分) | 项目健康度报告 |
|
||||
| `gitlink-changelog` | 由 commit/PR 自动生成结构化 Release Notes | Release Notes 生成 |
|
||||
| `gitlink-triage` | Issue 自动分类/打标签/分配责任人 | Issue 自动分拣 |
|
||||
| `gitlink-review` | 分析 PR diff 输出结构化 Review 意见 | 智能代码审查 |
|
||||
| `gitlink-license` | 许可证合规与敏感信息检查 | 许可证合规检查 |
|
||||
| `gitlink-contributor-ranking` | 贡献者活跃度画像与排行 | — |
|
||||
| `gitlink-spark` | 科研文献-代码缺口挖掘(子赛题四) | — |
|
||||
| `gitlink-research-fair` | 科研软件 FAIR 合规体检(子赛题四) | — |
|
||||
|
||||
### 命令操作型(15 个)
|
||||
|
||||
`gitlink-issue` `gitlink-pr` `gitlink-repo` `gitlink-branch` `gitlink-commit`¹ `gitlink-release` `gitlink-ci` `gitlink-org` `gitlink-user` `gitlink-search` `gitlink-pm` `gitlink-workflow` `gitlink-multi-repo` `gitlink-init-scaffold` `gitlink-auto-merge`
|
||||
|
||||
> ¹ 命令操作型 Skill 对应子赛题一的命令模块;`gitlink-shared` 为多 Skill 共享的工具库。
|
||||
|
||||
## 一键装入 Claude Code
|
||||
|
||||
```bash
|
||||
bash scripts/setup-skills.sh
|
||||
# 把 23 个 Skill 软链到 ~/.claude/skills/,幂等可重复
|
||||
# 之后在 Claude Code 里敲 / 就能 /gitlink-triage、/gitlink-health ... 直接调用
|
||||
```
|
||||
|
||||
跨平台:Windows 用目录联接(免管理员),macOS/Linux 用软链。
|
||||
|
||||
## 演示
|
||||
|
||||
见 [`demos/`](demos/)(`子赛题二-演示.mp4` + `子赛题二-演示截图.png`)。
|
||||
|
||||
**演示中输入的提示词**:
|
||||
|
||||
```
|
||||
/gitlink-changelog 帮我更新 https://www.gitlink.org.cn/chroe/gitlink-cli 这个仓库的 release 版本
|
||||
```
|
||||
|
||||
演示流程:Claude Code 加载 `gitlink-changelog` 的 `SKILL.md` → 按文档流程自动调用 gitlink-cli 采集 commit/PR → 按类型分类(新功能/Bug修复/改进)→ 生成结构化 Release Notes → 发布到仓库 Release。全过程 AI 自主完成,无需手动拼命令。
|
||||
Loading…
Reference in New Issue