repo-style-skill-builder

repo-style-skill-builder 是一个 Codex skill，用来把一个 GitHub 仓库研究成一个可复用的风格 skill。

它的目标不是只生成一份分析报告，而是完成一整套闭环：

1. 抓取仓库的完整证据集
2. 联合分析 issues、commits、代码、测试和文档
3. 提炼 maintainer 可迁移的项目治理风格
4. 基于这些证据生成新的风格 skill

这份 skill 是一组配套发布物中的“生成器”：

• 生成器：repo-style-skill-builder
• 示例生成结果：kxn-project-governance-style
• 示例证据来源仓库：kxn/codex-remote-feishu

也就是说，这个仓库负责“如何从一个 repo 提炼并生成风格 skill”；kxn-project-governance-style 则是它针对 kxn/codex-remote-feishu 生成出来的示例结果。

最小输入可以只有一个 GitHub 仓库链接，例如：

https://github.com/<owner>/<repo>

当只提供 repo URL 时，这个 skill 的预期行为是：

• 克隆仓库
• 抓取全量 issues
• 导出全量 commits
• 提取相关代码、测试和文档
• 物化本地工作区 artifacts
• 建立证据矩阵与风格抽象
• 生成一个新的可复用风格 skill

这个发布仓库把 repo 级文档放在根目录，把真正的 skill payload 放在 skill/ 下面。这样仓库可以有 README 和 LICENSE，同时不污染 skill 本体目录。

repo-style-skill-builder/
  README.md
  LICENSE
  .gitignore
  skill/
    repo-style-skill-builder/
      SKILL.md
      agents/openai.yaml
      references/

把下面这个目录复制到你的 Codex skills 目录中：

skill/repo-style-skill-builder

例如：

mkdir -p "$HOME/.codex/skills"
cp -R skill/repo-style-skill-builder "$HOME/.codex/skills/"

安装完成后，可以直接这样调用：

用 $repo-style-skill-builder 对这个仓库做端到端分析，提炼 maintainer 的项目治理风格，并生成一个可复用的风格 skill。

也可以直接给一个仓库链接：

这是 GitHub 链接：https://github.com/<owner>/<repo>
你自己先抓全量 issues、commits 和代码，再分析作者怎么管理项目，最后生成一个风格 skill。

如果你发现生成出来的 style skill 有问题，优先按下面的规则处理：

• 如果问题出在 skill 本体内容：
  • 例如 SKILL.md 主体结构
  • 风格主轴
  • 最小输入契约
  • 推荐输入模板
  • references/ 结构
  • agents/openai.yaml
  • 这类问题应先修改 repo-style-skill-builder
  • 然后重新生成目标 skill 验证
• 如果问题出在发布包装层：
  • 例如 repo 根目录 README.md
  • .gitignore
  • LICENSE
  • GitHub description
  • 这类问题可以直接改目标 repo，不必回到 builder

一句话原则：

• 会影响未来所有同类生成结果的问题，先改 builder
• 只影响当前这个发布仓库外壳的问题，直接改发布 repo

MIT，见 LICENSE。