diff --git a/提交材料/README.md b/提交材料/README.md index 0a36401..c9d7240 100644 --- a/提交材料/README.md +++ b/提交材料/README.md @@ -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) | diff --git a/提交材料/子赛题二-Skills/README.md b/提交材料/子赛题二-Skills/README.md new file mode 100644 index 0000000..451cab1 --- /dev/null +++ b/提交材料/子赛题二-Skills/README.md @@ -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 自主完成,无需手动拼命令。