Repository navigation
docs(agents): 上游 PR 引入流程与台账 - #7
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概述 / 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、只落 forkmain、只允许 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
pnpm run build/bash -n scripts/install.sh等基础检查 / Passed basic checks(无代码改动)