mcpField
G
github-release-assistant

github-release-assistant

github.com/mavcui开发19360 次安装33 周前更新
代码仓库

关于 github-release-assistant

一项根据仓库信息和简要配置生成中英文 README 的技能。它会与用户检查生成的差异,并在收到请求时指导完成经确认的 Git 提交和推送。

主要功能

  1. 01从仓库文件收集项目信息
  2. 02询问缺失信息或配置
  3. 03生成中英文 README 文件
  4. 04检查并完善生成的差异
  5. 05Git 操作前要求确认

适用场景

  1. 01创建双语项目文档
  2. 02根据仓库信息更新 README
  3. 03准备并确认推送文档更改

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mavcui/agent-skills-hunter --skill github-release-assistant

安装后在 Claude Code 中输入/github-release-assistant确认已加载。

详细介绍

GitHub 发布助手

概述

根据仓库信息和一个小型配置文件,按照简洁的“Redmax 风格”布局,生成精炼的中英文 README 文件。生成 README.md 和 README.zh.md,之后还可指导用户完成规范的 Git 提交和推送。

工作流

  1. 从 config.json、README.md、PROJECT_STRUCTURE.md、requirements*.txt 和 docs/ 收集仓库信息。
  2. 询问缺失的信息,或让用户填写 release_assistant.json(参见 assets/release_config.example.json)。
  3. 运行生成脚本以编写 README 文件。
  4. 与用户一起检查差异,并根据需要完善内容。
  5. 如有需要,在明确确认后暂存、提交并推送更改。

快速开始

  • 在仓库根目录中创建或编辑 release_assistant.json(可选,但建议填写)。
  • 运行: python3 /Users/cuizhanlin/.codex/skills/github-release-assistant/scripts/generate_release_readme.py --project-root <repo> --language both --overwrite
  • 检查 README.md 和 README.zh.md。

Git 工作流(提交 + 推送)

  • 运行 git status 和 git diff 以展示更改。
  • 在运行 git add、git commit 和 git push 前征求确认。
  • 提议一条简洁的提交信息(例如:docs: add bilingual README),并等待批准。

资源

  • 脚本:scripts/generate_release_readme.py。
  • 模板:assets/readme_template_en.md、assets/readme_template_zh.md。
  • 配置示例:assets/release_config.example.json。
  • 风格参考:references/redmax_style.md。
  • 大纲指南:references/readme_outline.md。

评论

支持 Markdown