branching-workflow
Skill2 starsChanged 35 days agoMITView on GitHub
每次提交/推送代码前,必须先询问 Rick 是新建分支还是用当前分支、走 PR 还是直推;不得擅自决定分支策略。AI agent 只负责 review PR 并加 comment,合并由人工执行或收到明确指令。
- Commits and pushes
1 other project uses a version of this.
Adopted by
Most recently taken up by
- 0xUrsanomics/utopia-ostheir own version, first seen Nov 1, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- 0xUrsanomics/utopia-os★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository21 other files it gives its agents.
- android-camera-devSkill
- android-device-debuggingSkill
- arch-dev-workflowSkill
- async-job-sse-upload-devSkill
- edge-offline-pipeline-devSkill
- frontend-dev-workflowSkill
- git-identitySkill
- installer-bundle-designSkill
- installer-preflightSkill
- installer-target-executionSkill
- mqtt-device-gateway-devSkill
- ohos-media-devSkill
- onvif-rtsp-devSkill
- open-source-contributionSkill
- redis-stream-rpcSkill
- robot-camerasSkill
- skill-distillationSkill
- skill-refreshSkill
- subagent-parallel-devSkill
- ui-responsive-listSkill
- user-facing-errorsSkill
The file
Files
Git 分支策略确认规范
所有代码改动在提交之前,必须先向 Rick(研发本人)确认分支策略,禁止擅自决定。
执行要求
提交前必问(二选一,让 Rick 明确选择):
- 新建分支(给出建议的分支名,如
feat/xxx、fix/xxx、docs/xxx)+ 是否创建 PR - 继续用当前分支(默认直推还是也要 PR,同样要确认)
推荐话术:
这个改动准备提交了:新建分支
feat/xxx走 PR,还是直接提交到当前分支master?- 新建分支(给出建议的分支名,如
- 禁止的擅自行为:
- 未经询问就
git checkout -b新分支 - 未经询问就直推
master/主干分支 - 未经确认就
gh pr create或合并 PR - 强推(
--force)历史重写类操作——即使 Rick 要求过重写,执行前也要再次复述影响范围确认
- 未经询问就
- PR 流程(Rick 选择走 PR 时):建分支 → 按规范提交 → push →
gh pr create(标题/描述完整)→ 等 Rick review 合并,不要自行 merge。
PR Review 与合并权限
- 职责边界:agent 只 review + comment,不合并。对仓库的 OPEN PR 主动给出审查意见——approve / request-changes(他人 PR)或 comment(本人账号 PR,GitHub 不允许自审生效),意见必须落成 PR 上的 comment,不只在会话里说。
- 合并权限属于研发:默认人工合并;agent 仅在收到包含"merge/合并"的明确指令时才可执行合并。CI 变绿、review 通过、任务延续等都不构成合并授权。
- review 检查项:CI 状态、embed.go 登记(新增技能目录)、README 技能表、frontmatter 规范(name 与目录一致)、项目名泄漏、与既有技能重复度。
- 结果呈现:review 完成后,在会话中以列表/表格汇总每个 PR 的简要信息——编号、标题/分支、review 结论、遗留项、CI 状态——并为每个 PR 附上可点击的链接(
https://github.com/<org>/<repo>/pull/<N>),方便研发直接打开处理。 - 定期/自动化 review:会话开始时检查仓库有无待处理的 OPEN PR,有则主动发起/刷新 review;并向研发建议建立定期或自动化 review 机制(如定时唤起的 review 工作流),由研发决定是否启用。
3a. 叠加分支遇上 squash 合并:上游 PR 若以 squash 方式合入(master 出现单个 (\\#N) 后缀提交、无原始 commit),叠加其上的分支必须重建——旧 commit SHA 全部不在 master 历史里,直接推送会显示 conflict/重复提交:
- 换基底:
git rebase --onto master <旧基底> <分支>(旧基底 = 原 PR 的最后一个原声 commit) - 顺带去重(同一修复已进上游)的 commit 用 cherry-pick 挑拣重建,丢弃已合并项
- 重建后
push -f更新 PR,mergeable 复核
- 例外:连续多个小改动属于同一任务且 Rick 已明确过策略(例如"接下来的改动都走 PR"),沿用已确认的策略即可,无需每次重复询问;但任务切换或涉及主干直推时必须重新确认。
- 与
git-identity技能配合:提交身份永远是 Rick 本人(Rick <linuxsuren@users.noreply.github.com>)。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

