菜单
当需要提交代码、创建分支、rebase/merge、处理冲突或回滚改动时使用,提供规范的 Git 操作流程与安全红线。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | Git 工作流 |
| description | 当需要提交代码、创建分支、rebase/merge、处理冲突或回滚改动时使用,提供规范的 Git 操作流程与安全红线。 |
| version | 1.0.0 |
| category | 开发流程 |
任何 Git 写操作之前,先用 run_bash 执行以下命令了解现场,禁止凭猜测直接操作:
git status # 工作区/暂存区状态、当前分支
git diff && git diff --staged # 未暂存与已暂存的具体改动
git log --oneline -10 # 最近提交,确认基线和分支走向
补充检查:git branch -vv 看分支与上游的领先/落后;git stash list 确认有没有遗留 stash。
格式:<type>(<scope>): <subject>,subject 用祈使句、不超过 72 字符、结尾不加句号。
| type | 用途 |
|---|---|
| feat | 新功能 |
| fix | 修 bug |
| refactor | 重构(不改行为) |
| docs | 仅文档 |
| test | 仅测试 |
| chore | 构建/依赖/杂项 |
| perf | 性能优化 |
要点:
git add -p 拆分暂存。git diff --staged 复核暂存内容,确认没混入调试代码、密钥、无关文件。!(如 feat!:)并在 body 说明迁移方式。feat/<描述>、fix/<描述>、chore/<描述>,小写中划线。git fetch origin && git switch -c feat/xxx origin/main。git branch -d feat/xxx。rebase 前自检:git log --oneline @{u}..HEAD 确认哪些提交是本地独有。已推送到共享分支的提交不要 rebase。
git fetch origin
git rebase origin/main # 个人分支同步主干,保持线性历史
# 冲突时:逐个解决 → git add <file> → git rebase --continue
# 情况失控:git rebase --abort 完整回到 rebase 前
merge 用于把功能分支合回主干。无法快进且想保留合并点时用 git merge --no-ff feat/xxx。
git status 列出冲突文件(both modified)。<<<<<<<(ours)与 >>>>>>>(theirs)各自意图——不要机械保留某一侧,要合并两侧语义。git diff --check 确认无残留标记,然后 git add → continue。| 场景 | 命令 |
|---|---|
| 撤销单文件未暂存改动 | git restore <file> |
| 取消暂存 | git restore --staged <file> |
| 修改最近一次提交(未推送) | git commit --amend |
| 撤销已推送的提交 | git revert <sha>(生成反向提交,最安全) |
| 本地回退到某提交 | git reset --soft <sha>(保留改动)/ --hard(丢弃改动,先确认!) |
| 找回"丢失"的提交 | git reflog 定位 sha 后 git switch -c rescue <sha> |
reset --hard 前必须先 git stash 或确认 git status 干净,避免丢未提交工作。
git push --force 到 main/master/dev 等共享分支。个人分支需要覆盖远端时,只用 git push --force-with-lease。.env。提交前 grep 一遍:git diff --staged | grep -iE 'api[_-]?key|secret|password|token',有命中先排查。git add . 盲提交,先看 status 确认每个文件都该进。--no-verify)。git clean -fd 执行前必须先跑 git clean -nd 预览。git status && git diff # 1. 了解现场
git add -p # 2. 选择性暂存
git diff --staged # 3. 复核
git commit -m "feat(scope): xxx" # 4. 规范提交
git log --oneline -3 # 5. 确认结果
在 Forsion 的 Coding Space 里构建网页/前端应用时**必须先读**。讲清本环境的即时预览规则——importmap + esm.sh 拉任意 npm 包、可直接写 JSX/TSX(预览端自动转译)、无构建步骤、无 npm install、多文件结构、index.html 入口。写任何 web 代码前遵循本约定。
当在 Forsion Coding Space 里编写 React/前端组件、hooks、状态管理,或排查重渲染、数据获取、内存泄漏、陈旧闭包类 bug 时使用。提供 hooks 依赖数组、useEffect 竞态与清理、组件组合、状态选型(useState/Context/zustand)、数据获取三态(loading/error/取消)、列表 key、受控/非受控、memo/useMemo/useCallback 的可复制正反例(均适配 importmap+esm.sh 无构建环境)。
当需要用 Python/pandas 分析数据文件、做统计聚合或绘制图表时使用,提供标准代码模式与 run_python 使用规范。
当用户想新建 / 配置 / 修改 / 删除 Tangu 本地 Agent(Normal Agent),或想把一种好用的角色 / 工作方式沉淀成可复用的 agent 时使用。讲解 manage_agent 工具与 agent 的文件夹结构(config.toml / SOUL.md / MEMORY.md / LOG / Library)。