AI GitHub — Repo 展示层管家

让你的 GitHub repo 页面像个能用的产品，不像随手 push 的脚本。

定位

做什么：repo 在 github.com 上的展示层——README + 描述 + topics + 视觉。 不做什么：git 操作（commit / branch / PR / merge）、Actions / Pages 部署。那些用 claude-skill-git / claude-skill-github-best-practices / claude-skill-github-pages-deployer。

核心赌注：好 README + 卖点描述 + 准 topics 决定 repo 能否被搜到 + 第一屏是否看得下去。SKILL.md 写得再好，repo 主页空荡，新用户 3 秒就关。

触发

下列任意触发：

"完善 / 润色 / 美化 [repo] 展示 / README"
"把 README 改成 X 风格"（X 是另一个 repo / skill）
"加 / 完善 GitHub 标签 / topic"
"改 / 写个 GitHub 描述"
"polish 我的 GitHub" / "rebrand 这个 repo"
"GitHub 页面太空" / "看起来不像个项目"
/ai-github

不触发的反例：

"帮我写个 commit message" → 用 Claude-Skill-Git-Commit-Message
"创建 PR" → 用内置 gh pr create 或 claude-skill-github-best-practices
"部署 GitHub Pages" → 用 claude-skill-github-pages-deployer

三件套（+ 两个可选附加步）

┌─ ⓪ Bootstrap（可选，cwd 不是 git repo 或 GitHub 上没 repo 时启用）─┐
│  git init + 首次 commit + gh repo create --source=. --push        │
│  默认 public，repo 名取 cwd basename，描述 / topics 留给 ②③ 来填   │
└──────────────────────────────────────────────────────────────────┘
              ↓
┌─ ① README 重写 ──────────────────┐
│  pull 参考 repo README + 镜像结构  │
│  填本 repo 内容（读 SKILL.md/code）│
│  badges + 它是什么 + 为什么 + ...  │
└──────────────────────────────────┘
              +
┌─ ② Description 润色 ─────────────┐
│  bare 分类 → 卖点一句话           │
│  公式：[受众] + [一句触发] → [输出]│
│        + [价值/卖点]              │
└──────────────────────────────────┘
              +
┌─ ③ Topics 加 10-15 个 ───────────┐
│  6 类分布：                       │
│  生态 / 受众 / 用途 / 源 / 技术 / 语言│
└──────────────────────────────────┘
              +
┌─ ④ LICENSE 补全（可选，README 提了 License 但 repo 缺文件时启用）─┐
│  默认 MIT，年份 = 当年，holder = git config user.name             │
│  其它 license（Apache-2.0 / GPL / BSD）需用户明示                  │
└──────────────────────────────────────────────────────────────────┘
              ↓
       commit + push + gh repo edit

工作流（6 步 + 2 可选附加步）

Step 0：Bootstrap — 建新 repo（可选）

何时触发：

cwd 不在 git repo（git rev-parse --is-inside-work-tree 报错）→ 整套从 0 开始
cwd 是 git repo 但无 origin remote → 只需建 GitHub repo + push
cwd 是 git repo 且有 origin，但 gh repo view <owner>/<name> 404 → remote URL 指向不存在的 repo，需建

步骤：

# 1. 检测状态
git rev-parse --is-inside-work-tree 2>&1      # not a git repository → 需 init
git remote get-url origin 2>&1                # no such remote → 需建 GitHub repo
gh repo view <owner>/<name> 2>&1              # GraphQL: Could not resolve → repo 不存在

# 2. git init（仅当不是 git repo）
git init -b main
git add -A
git commit -m "init: <repo-name> v1$([newline][newline])Co-Authored-By: ..."

# 3. 建 GitHub repo + 推
#   --source=. 把当前目录作为源；--push 自动 push；--description 先占位（②会改）
gh repo create <repo-name> --public --source=. --remote=origin --push \
  --description "<占位描述，Step 4 会覆盖>"

默认值：

repo-name = cwd basename（如 socratic-dialogue）。用户指定优先。
--public：默认公开，私有需用户明示。
branch = main。
description 占位：用 SKILL.md 第一行 description 或 cwd 名做临时占位，Step 4 会覆盖。

触发本步的用户原话：

"把这个推到 GitHub"
"推到我们的 GitHub 上"
"建个 repo + 三件套全做"
"新 skill 上 GitHub"

做完进 Step 1（此时 repo 已存在 + 已 push，后续流程正常跑）。

Step 1：确认目标 repo + 参考风格 repo

目标 repo：

默认 = gh repo view --json owner,name（cwd 内）
用户明确指定 → 用指定 repo
cwd 不在 git repo → 询问

参考 repo（README 风格模板）：

用户指定 → 用指定（如"按 ai-short-drama-skill 写"）
没指定 → 列用户已有的同 owner repo 选最像的；或推默认风格（见 references/readme-style-guide.md）

Step 2：抓两边内容

目标 repo：

Read 本地 SKILL.md（或主代码文件）—— 提取功能列表 / 工作流 / 触发词 / 限制
Read 现有 README（如有）—— 看哪些段缺
gh repo view <owner>/<name> --json description,repositoryTopics —— 看现状
Glob examples/ —— 有 example 就 surface

参考 repo：

gh api repos/<owner>/<name>/contents/README.md --jq .content | base64 -d —— 拿原文
拆解结构：每段标题、有无 badges、对比表、ASCII 图、文件结构示例、版本史

Step 3：起草新 README

镜像结构 + 填本 repo 内容。Section 套路（按 ai-short-drama / pm-daily-brief 实证）：

标题 + tagline（一行，含价值主张）
引用句（quote 块，"一句『X 触发』 → Y 输出"）
Badges（Skill / License / PRs Welcome）
它是什么：具象触发示例 → bullet 列输出 → punchline（"不是 X，是 Y"）
为什么做它：对比表（市面通病 vs 本 skill 改进）—— 整篇最有说服力的段
安装：两法（Windows PowerShell + macOS/Linux）
用法：触发词列表 + ASCII 流程图
核心流程速览：每步 3-5 行
输出模板（如适用）
文件结构：tree 块
自定义：编号 5 项（路径 / 数据源 / 语言 / 二进制 / 加源）
为什么是 skill 不是脚本（如适用）
已知限制：bullet 4-6 条
版本历史：v1 → v2 → v3，每版列关键改进
贡献：列重点方向 4-5 条
致谢：上游灵感 / 工具链
License：MIT 链接

写作铁律：

中文为主（除非 repo 用英文社区），技术术语保留英文
信息密度高，禁止"令人激动""革命性"形容词
对比表 ≥ 8 行才有说服力，少了砍掉
触发示例必须具象，不写"一句话需求"
版本史每版列关键改进而非"修了 bug"

详见 references/readme-style-guide.md。

Step 4：起草 GitHub 描述

裸分类描述（bad）：

AI产品经理每日情报简报 Claude Code skill

卖点描述（good）：

AI 产品经理每日情报简报 Claude Skill — 一句『今天有啥新的』 → 三源融合（PH/GH/HN）+ 用户画像加权 + TL;DR 60 秒摘要 + Top 3-5 深读 + 全列表 [跟进/关注/噪音] triage，中文 Markdown/PDF 双输出

公式：

[名称] [类别] — [触发短语] → [核心输出 + 关键卖点 1-3 个] + [产物形态]

详见 references/description-formula.md。长度上限 350 字符（GitHub 限制），中文超 100 字基本到顶。

Step 5：起草 Topics（10-15 个）

6 类分布（每类 1-3 个）：

类	例	必有？
生态	`claude-skill` `claude-code` `anthropic`	必
受众	`ai-product-manager` `developer` `designer`	推
用途/动作	`daily-brief` `code-review` `repo-management`	必
数据源/集成	`producthunt` `github-api` `webfetch`	视情况
技术	`prompt-engineering` `llm` `markdown-to-pdf`	推
语言/区域	`chinese` `english`	视情况

topic 命名规范：全小写 + 连字符。GitHub 自动归一。

详见 references/topic-taxonomy.md。

Step 6：应用 + commit + push

# 1. 写 README
# (Edit / Write)

# 2. commit
git add README.md
git commit -m "$(cat <<'EOF'
docs: rewrite README in <reference-repo> style

<2-3 sentence summary>

Co-Authored-By: ...
EOF
)"

# 3. push
git push origin HEAD

# 4. 改描述
gh repo edit <owner>/<name> --description "<新描述>"

# 5. 加 topics
gh repo edit <owner>/<name> \
  --add-topic <topic1> \
  --add-topic <topic2> \
  ...

验证：gh repo view <owner>/<name> --json description,repositoryTopics

Step 7：补 LICENSE（可选）