Skip to content

docs(agents): 上游 PR 引入流程与台账 - #7

Merged
graydovee merged 2 commits into
mainfrom
docs/agents-upstream-intake
Oct 19, 2026
Merged

graydovee merged 2 commits into
mainfrom
docs/agents-upstream-intake

Conversation

@graydovee

Copy link
Copy Markdown
Owner

概述 / Summary

把「上游 PR 以 fork 内 PR 形式导入 fork main」这套流程写进仓库:AGENTS.md 新增《上游 PR 引入流程》,并新增 .agents/notes/upstream-pr-intake.md 台账。

文档改动,无产品行为变化。

动机 / Motivation

上游 omdsh-dev/dsh-browser 停更期间,本 fork 需要持续把上游待合入的第三方 PR 搬进来。此前只有自研功能的四步流程(功能分支 → 承载分支 → 同步 PR omdsh-dev#121 → main),导入第三方 PR 走这条路会把别人的工作打包回上游,也缺少可审计的落地记录。因此把导入通路单独约定:一上游 PR 一 fork PR、只落 fork main、只允许 merge commit。

改动内容 / Changes

  • AGENTS.md:《分支与合入流程》补一条例外指向新章节;新增《上游 PR 引入流程》(分支命名 upstream/<n>-<slug>、merge-only、适配提交、验证门禁、PR 正文首段、合并后核对 trailer 与台账登记、不做的事);《CHANGELOG 规则》补「致谢尾注」一条(中 (感谢 @handle) / 英 (thanks @handle))。
  • .agents/notes/upstream-pr-intake.md:台账表(4 个待导入上游 PR:源 SHA、判定、分支、fork PR、merge SHA、changelog、状态)+ 分诊判据 + 完整命令清单 + 边界与失败模式。

测试 / Testing

纯文档改动,未触碰代码。CI(.github/workflows/runtime.yml)仍会跑 check:runtime / typecheck / test / build / smoke,用于确认文档分支未引入意外副作用。

影响范围 / Impact

仅影响仓库协作约定与文档;不改变 macOS / Linux / Windows 或 Chrome / Firefox 的运行时行为。

Checklist

  • 已在相关平台实测通过 / Tested on the relevant platforms(纯文档)
  • 已通过 pnpm run build / bash -n scripts/install.sh 等基础检查 / Passed basic checks(无代码改动)
  • 文档已同步更新(如需要)/ Docs updated if needed
  • 不包含无关改动 / No unrelated changes included

@graydovee
graydovee merged commit 0244cb3 into main Oct 19, 2026
1 check passed
@graydovee
graydovee deleted the docs/agents-upstream-intake branch October 19, 2026 10:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant