Git 发布

通过单个工作流，将当前项目推送到 GitHub 远程仓库。

工作流

请按以下顺序执行各步骤：

步骤 1：解析远程仓库 URL

在执行其他任何操作之前，先确定对应的 GitHub 仓库 URL。

1. 读取位于 references/repo-map.json（相对于本 skill 所在目录）的仓库映射文件。该文件将本地项目路径映射到其对应的 GitHub URL。

2. 将当前工作目录（即用户希望推送的项目）与映射文件中的键进行比对。

3. 若找到匹配项：直接使用已存储的 URL，并告知用户：“检测到该项目对应的仓库：，直接使用。”

4. 若未找到匹配项：请用户提供 GitHub 仓库 URL。支持以下格式：

   • https://github.com/user/repo.git
   • git@github.com:user/repo.git
   • https://github.com/user/repo

   若用户尚未提供 URL，请提示：“请提供 GitHub 仓库地址（例如 https://github.com/user/repo.git）：”

步骤 2：检查并按需初始化 Git

运行 git status 检查当前目录是否为 Git 仓库。

若当前目录不是 Git 仓库：

1. 运行 git init
2. 运行 git add . 将所有文件加入暂存区
3. 运行 git commit -m "Initial commit"
4. 运行 git remote add origin 添加远程仓库
5. 运行 git branch -M 将当前分支重命名为检测到的分支名

若当前目录已是 Git 仓库：

1. 检查是否存在名为 origin 的远程仓库：
   • 运行 git remote get-url origin
   • 若返回的 URL 与用户提供的不一致，询问用户是否更新
   • 若不存在 origin 远程仓库，则运行 git remote add origin

步骤 3：处理未提交的变更

使用 git status --porcelain 检查是否存在未提交的变更。

若存在未提交的变更：

1. 运行 git diff --cached 查看已暂存的变更
2. 运行 git diff 查看未暂存的变更
3. 暂存全部变更：git add .
4. 分析暂存的变更内容，并基于 diff 生成提交信息。该提交信息应满足：
   • 遵循约定式提交（Conventional Commits）格式：type(scope): brief summary
   • 类型（type）可选值包括：feat（新功能）、fix（缺陷修复）、chore（维护任务）、docs、refactor、style、test
   • 标题长度不超过 50 个字符
   • 正文部分需列出受影响的文件及具体变更内容
5. 运行 git commit -m ""

若不存在未提交的变更：直接进入推送步骤。

步骤 4：推送到 GitHub

1. 检测当前分支：git branch --show-current
2. 优先尝试常规推送：git push -u origin
3. 若推送因连接错误失败（例如 “Could not connect to server”、“Failed to connect”、超时、网络不可达），检查远程 URL 是否使用 HTTPS 协议：
   • 运行 git remote get-url origin 查看当前 URL。
   • 若 URL 以 https:// 开头，则最多重试 3 次，每次重试之间加入短暂停顿。
   • 若全部 3 次 HTTPS 重试均失败，则自动切换为 SSH 协议：
     • URL 转换示例：https://github.com/user/repo.git → git@github.com:user/repo.git
     • 运行 git remote set-url origin git@github.com:user/repo.git
     • 再次尝试使用 SSH 推送。
   • 若远程仓库已使用 SSH 协议但连接仍失败，则最多重试 3 次，之后向用户报告错误。
4. 若因其他原因推送失败（例如历史记录分叉、非快进式更新等），向用户展示错误信息，并询问：“普通推送失败，是否使用强制推送？这可能会覆盖远程仓库的历史。(y/n)”
   • 若用户同意：执行 git push -u origin --force
   • 若用户拒绝：中止流程并汇报当前状态

步骤 5：保存映射关系并确认成功

推送成功后：

1. 保存映射关系 — 更新 references/repo-map.json，记录当前项目路径及其 GitHub URL，以便后续对该项目的推送无需再次询问 URL。需先读取该文件，添加或更新对应条目，再写回。键为项目目录的绝对路径，值为远程 URL。

2. 确认成功 — 向用户汇报以下信息：

   • 远程 URL
   • 被推送的分支
   • 被推送的提交信息

参考文件

• references/repo-map.json — 本地路径到 GitHub URL 的映射表。首次用于解析远程 URL；每次成功推送后需更新。

自我演进机制

每次执行本 Skill 后：

1. 评估输出是否达成预期目标：通过 / 失败。
2. 若执行失败，分析失败原因，并将“失败案例 + 改进建议”追加至 diary/YYYY-MM-DD.md。
3. 若某条改进建议在最近三次执行中被重复提及，则将其提炼为正式规则，并提交 PR 修改本 SKILL.md。