GitHub 项目完备性

@ aquarius-wing742026.7.10github-repo-completeness

扫已有 GitHub repo, 出 P0-P3 缺失清单, 按优先级逐项引导补齐——你点头再动手, 绝不一次性代你全生成。

官方精选AI 工程

名字/名称: GitHub 项目完备性
描述说明: GitHub 项目完备性检查与补全引导。扫描已有 repo，生成缺失清单，按优先级逐项引导用户补全。不直接生成所有内容，而是引导用户决策后再执行。 Always trigger for: repo completeness, 项目完备性, 项目完善, 项目包装, project packaging, open source ready, 开源准备, github setup, 补全项目, project health, project checklist, 项目清单. Also triggers for: "这个项目还缺什么", "帮我完善项目结构", "准备开源". Do NOT trigger when: 写代码 / 修 bug / code review；从零起草需求或 PRD（走 write-spec）； scaffold 全新空项目骨架（走脚手架类 skill）；发版 / 打包发布版本（走 release）；发布 skill 到公司库（走 tranfu-publish）；部署上线（走 coolify-deploy）。

扫已有 GitHub repo, 出 P0-P3 缺失清单, 按优先级逐项引导补齐——你点头再动手, 绝不一次性代你全生成。

什么时候用它

准备开源发布:

项目要上 GitHub / 准备开源, 想让 skill 先扫一遍, 缺什么给我个清单, 我挑重要的补。

补漏具体项:

我知道缺 README / LICENSE / CI / issue 模板, 想让 skill 按栈推荐做法一步步引导我。

全面检查仓库:

项目跑了半年, 想定期看看结构还完不完整, 哪些项漂移到 WEAK 了。

批量检查仓库:

时间紧, 直接说「全部按默认」, 让 skill 一次跑完, 最后一起审。

不接:

从零起草 PRD → write-spec; 新项目冷启动整套文档 → project-init-docs; 打 tag / 发版 → release; 部署上线 → coolify-deploy; scaffold 空项目骨架 → 走脚手架类 skill。

默认逐项确认, 绝不一次性生成——除非你明说「全部按默认」——最反常识的一点。

P0-P3 清单表: 四列 = 优先级 / 项目 / 状态 (OK / WEAK / MISSING / N/A) / 说明
逐项引导: 每项先问偏好 (哪种协议 / CI 到什么程度 / 要哪几种 issue 模板), 再动笔生成
落盘文件: 视选择可能新增 README.md / LICENSE / .gitignore / CONTRIBUTING.md / CHANGELOG.md / .github/workflows/ci.yml / .github/ISSUE_TEMPLATE/*.yml / .github/pull_request_template.md
收尾复扫: 重跑扫描确认本轮选中项已从 MISSING / WEAK 转成 OK, 汇总产物给你最终签字
绝不会做: 替你选 License 类型 / 打 tag 发版 / push 到 remote / 未经同意就把所有缺失文件都写掉

前置:

cwd 必须是 git repo 根 (git rev-parse --show-toplevel 命中且 == pwd); 不在 repo 内会停下等你确认。

相邻 skill 分工:

不接的场景:

微妙边界: