| name | commit-push |
| description | Create a git commit and optionally push to origin/master for the NyaaChat-MCP project. Trigger when the user explicitly asks to commit, push, "提交", "推送", or "上传到 GitHub". Follows the repo's Conventional Commits style, never auto-commits without an explicit request, and refuses destructive operations (force-push, --no-verify, --amend on pushed commits, git config changes). |
commit-push
为 NyaaChat-MCP 项目执行 git commit 以及可选的 git push origin master。远端仓库：https://github.com/NyaaCaster/NyaaChat-MCP.git。
触发条件
只在用户明确要求时调用，例如：
- "帮我提交"、"commit 一下"、"提交这些改动"
- "推送到 GitHub"、"push 到远端"、"上传"
- 显式调用
/commit-push
严禁在用户没有明确要求的情况下自动 commit 或 push——哪怕本轮对话刚改完一堆代码。
提交信息风格（必须遵守仓库现有约定）
仓库历史采用 Conventional Commits（英文）：
| 类型 | 含义 |
|---|
feat: | 新功能或现有功能的增强 |
fix: | bug 修复 |
chore: | 构建、配置、辅助脚本等非业务改动 |
docs: | 仅文档变动（README、注释除外） |
refactor: | 不改变行为的重构 |
init: | 仅初始化提交时使用 |
写作规则：
- 主语全部使用英文（CLAUDE.md 明确：提交信息按英文惯例）。
type: 后跟空格和小写起首的简短描述。- 多项改动可用逗号合并到一行：
feat: file attachments, paste support, favicon。
- 主语短小（≤ 72 字符）；如需详述，在空行后写正文。
- 不附加
Co-Authored-By 行——仓库历史中所有提交都没有，保持一致。
参考的提交风格示例（项目相关）：
init: scaffold MCP server with Streamable HTTP transport
feat: add get_current_time via timeapi.io
feat: add get_weather via QWeather, with country/province alias resolution
feat: require Bearer token auth on /mcp endpoint
chore: split README into integration / roleplay / technical sections
fix: namespace listen vars as MCP_HOST/MCP_PORT to avoid .env collision
标准流程
1. 提交前侦查（并行执行）
git status # 不要用 -uall
git diff # 已暂存 + 未暂存
git diff --cached # 仅已暂存
git log --pretty=format:"%h %s" -n 5
目标：
- 看清将要进入提交的全部改动。
- 确认风格与最近 5 条 commit 一致。
- 发现意外文件（见下方"绝不提交"）。
2. 暂存
- 始终按文件名显式
git add <file> <file>，禁止 git add -A / git add . / git add -u。
- 如果用户已经手动
git add 过，直接沿用，不要重复加。
3. 起草提交信息
- 按上节风格起草，先看
git log 确保动词、大小写、用词与近邻提交协调。
- 描述聚焦"为什么"和"带来什么"，而不是逐文件罗列"动了什么"。
- 多行信息必须用 HEREDOC 传入，避免 PowerShell/Bash 的引号转义出错：
git commit -m "$(cat <<'EOF'
feat: short subject line
Optional body explaining the why.
EOF
)"
4. 推送（仅在用户要求时）
- 默认目标：
origin master（仓库唯一活跃分支）。
- 推送前必须与用户二次确认，特别是包含：构建配置、Dockerfile、
docker-compose.yml、依赖锁文件、大量删除的提交。
- 标准命令：
git push origin master。
- Windows / Session 0 已知坑：若
git push 报 could not read Username / wincredman / A specified logon session does not exist，是 Claude Code 跑在 Session 0、DPAPI/Git Credential Manager 取不到凭据所致——不要在 credsStore / git config 上纠缠。直接用 windows-user-session-runner skill 把 git push origin master 包进 schtasks /it（用户交互会话 Session 1）执行。
- 推送完成后跑一次
git status 验证本地与远端一致。
绝不提交（pre-check 清单）
如 git status 显示这些文件出现在暂存区或未跟踪区，先停下来询问用户，不要自动加入：
.env、.env.*（含 MCP_API_KEY 与 QWeather 凭证；已被 .gitignore 排除，例外是 .env.example）.claude/settings.local.json（本机 Claude Code 设置，已 gitignore）.doc/（内部参考文档，已 gitignore）- 任何含 token / API key / 密码字面值的文件
node_modules/、dist/、build/、*.log（均已被 .gitignore 排除）- 大体积二进制（> 5 MB），除非用户确认
- 含 IDE 配置、临时调试代码、个人路径的文件
绝不做的操作
未经用户显式书面同意前：
- ❌
git push --force / --force-with-lease 到 master
- ❌
git commit --amend（尤其是已推送的提交）
- ❌
git reset --hard / git checkout . / git clean -fd
- ❌
git rebase（任何形式）
- ❌
--no-verify、--no-gpg-sign（绕过 hook / 签名）
- ❌ 修改
git config（用户名、邮箱、远端、hooks 等）
- ❌ 删除分支 / 标签
遇到 pre-commit hook 失败，不要用 --amend 修复——先解决 hook 报的问题，重新 git add 后新建一个 commit。
创建 Pull Request（如适用）
本项目当前是单分支直推流；如用户要求改用 PR 流程：
- 新建特性分支：
git checkout -b feat/<short-name>
- 提交、推送：
git push -u origin feat/<short-name>
- 用
gh pr create 创建 PR，标题用 Conventional Commits 风格，body 使用 HEREDOC。
- PR body 不附加 "🤖 Generated with Claude Code" 之类的水印——与仓库无水印的提交风格一致。
给用户的最终汇报
成功 commit / push 后，简短汇报：
- 提交哈希前 7 位和主语
- 是否已推送、本地与远端状态是否一致
- 任何被跳过的文件以及原因
