Gitlink
/
gitlink-cli
0
0
Fork 49
Code Issues Pull Requests 11 Packages Projects Releases 10 Wiki Activity

feat(skills): 新增 gitlink-pr-topology PR 队列关系图谱 Skill #297

Merged
wbtiger merged 1 commits from Mengz/gitlink-cli:mengz/skill-pr-topology-submit into master 2026-07-14 22:26:42 +08:00
Conversation 0 Commits 1 Files Changed 11 +477
Mengz commented 2026-06-26 12:35:08 +08:00
Contributor
Copy Link

## Skill 解决的问题

仓库里的 open PR 一多，维护者很难快速判断哪些 PR 存在依赖顺序、哪些其实在解决同一件事、哪些实现互相替代、哪些会在同一个命令入口或同一批核心文件上发生冲突。这个 skill 的目标就是把“散落在 PR 标题、描述、改动文件和 review 上下文里的关系”整理成结构化队列图谱，帮助维护者更快决定先看谁、一起看谁、保留谁、暂缓谁。

Skill 能做什么

  • 识别 open PR 之间的依赖链、功能重叠、替代关系、冲突热点和建议的处理顺序。
  • 区分 depends_on、overlaps_with、supersedes、conflicts_with、review_together、merge_after 等不同关系，而不是只做“是否重复”的粗判断。
  • 在功能重叠时比较哪条 PR 覆盖更完整、测试更充分、帮助文档更齐、实现路径更适合当前项目。
  • 输出维护者可直接使用的关系边列表、重叠实现簇、热点文件清单和建议处理顺序，适合作为批量梳理 open PR 队列的值班工具。

这次提交包含的内容

  • 新增 skills/gitlink-pr-topology/SKILL.md，定义 skill 的目标、关系分类、分析流程、输出格式和使用边界。
  • 新增 references/relationship-taxonomy.md 与 references/comparison-rubric.md，分别约束关系判定标准和重叠实现比较准则。
  • 新增 3 份 example prompt，覆盖依赖链扫描、重叠实现比较和 review 打包分组场景。
  • 新增 Codex 验证输出文档 examples/codex-validation-2026-06-26.md。
  • 新增截图材料：skill 目录截图 1 张、运行结果截图 2 张。

如何复核与验证

我已按 skills 规范执行 quick_validate.py，结果通过。随后在 Codex 中对 Gitlink/gitlink-cli 最近 40 条 open PR 做实际扫描，skill 成功识别出多组高价值关系，例如 #281 supersedes #254、#282 supersedes #268、#283/#284/#285 需要打包 review、#276/#259 属于高冲突大而全 PR，并给出热点文件和建议处理顺序。输出已经整理进验证文档，便于直接复核。

已附材料

  • skills/gitlink-pr-topology/examples/codex-validation-2026-06-26.md
  • skills/gitlink-pr-topology/assets/codex-skill-directory.png
  • skills/gitlink-pr-topology/assets/codex-validation-output-1.png
  • skills/gitlink-pr-topology/assets/codex-validation-output-2.png
## Skill 解决的问题 仓库里的 open PR 一多，维护者很难快速判断哪些 PR 存在依赖顺序、哪些其实在解决同一件事、哪些实现互相替代、哪些会在同一个命令入口或同一批核心文件上发生冲突。这个 skill 的目标就是把“散落在 PR 标题、描述、改动文件和 review 上下文里的关系”整理成结构化队列图谱，帮助维护者更快决定先看谁、一起看谁、保留谁、暂缓谁。 ## Skill 能做什么 - 识别 open PR 之间的依赖链、功能重叠、替代关系、冲突热点和建议的处理顺序。 - 区分 `depends_on`、`overlaps_with`、`supersedes`、`conflicts_with`、`review_together`、`merge_after` 等不同关系，而不是只做“是否重复”的粗判断。 - 在功能重叠时比较哪条 PR 覆盖更完整、测试更充分、帮助文档更齐、实现路径更适合当前项目。 - 输出维护者可直接使用的关系边列表、重叠实现簇、热点文件清单和建议处理顺序，适合作为批量梳理 open PR 队列的值班工具。 ## 这次提交包含的内容 - 新增 `skills/gitlink-pr-topology/SKILL.md`，定义 skill 的目标、关系分类、分析流程、输出格式和使用边界。 - 新增 `references/relationship-taxonomy.md` 与 `references/comparison-rubric.md`，分别约束关系判定标准和重叠实现比较准则。 - 新增 3 份 example prompt，覆盖依赖链扫描、重叠实现比较和 review 打包分组场景。 - 新增 Codex 验证输出文档 `examples/codex-validation-2026-06-26.md`。 - 新增截图材料：skill 目录截图 1 张、运行结果截图 2 张。 ## 如何复核与验证 我已按 skills 规范执行 `quick_validate.py`，结果通过。随后在 Codex 中对 `Gitlink/gitlink-cli` 最近 40 条 open PR 做实际扫描，skill 成功识别出多组高价值关系，例如 `#281 supersedes #254`、`#282 supersedes #268`、`#283/#284/#285` 需要打包 review、`#276/#259` 属于高冲突大而全 PR，并给出热点文件和建议处理顺序。输出已经整理进验证文档，便于直接复核。 ## 已附材料 - `skills/gitlink-pr-topology/examples/codex-validation-2026-06-26.md` - `skills/gitlink-pr-topology/assets/codex-skill-directory.png` - `skills/gitlink-pr-topology/assets/codex-validation-output-1.png` - `skills/gitlink-pr-topology/assets/codex-validation-output-2.png`
Mengz added 1 commit 2026-06-26 12:35:09 +08:00
wbtiger merged commit 5ee781f945 into master 2026-07-14 22:26:42 +08:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#297
No description provided.
Delete Branch "Mengz/gitlink-cli:mengz/skill-pr-topology-submit"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?