Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

docs(workflow): 按独立验收目标归并相关 PR

longmeidao5f1c6e6d38c5
diff --git a/.claude/skills/peach-issue-delivery/SKILL.md b/.claude/skills/peach-issue-delivery/SKILL.md
index d977ddd31..4c7e1f68e 100644
--- a/.claude/skills/peach-issue-delivery/SKILL.md
+++ b/.claude/skills/peach-issue-delivery/SKILL.md
@@ -6,7 +6,7 @@ description: Peach 收集或汇总用户反馈、代码交付、issue 与 PR、
# 反馈、Issue 交付与验证
最后复核:2026-10-29
-证据来源:用户确认的维护者 PR 流程、issue 沟通与验收约定、用户指明「收集反馈汇总」须触发本技能并覆盖 Discussions、Codex 反馈汇总会话中用户对优先级与修复批次的要求、[issue #95](https://github.com/peach-mitao/peach/issues/95)、[PR #96](https://github.com/peach-mitao/peach/pull/96)、[项目看板状态判据](../../../scripts/project_board.py)。
+证据来源:用户确认的维护者 PR 流程、相关修复合为一个 PR 的要求、反馈来源与优先级约定、[issue #95](https://github.com/peach-mitao/peach/issues/95)、[PR #96](https://github.com/peach-mitao/peach/pull/96)、[项目看板状态判据](../../../scripts/project_board.py)。
## 反馈收集与汇总
@@ -20,7 +20,8 @@ description: Peach 收集或汇总用户反馈、代码交付、issue 与 PR、
## Issue 与 PR 范围
- 维护者自己的代码与社区贡献都经 PR;小修、文档和测试可直接提 PR。复杂缺陷、新功能、默认行为或架构变化先有 issue,复用已有问题记录,不重复建单。已在对话确认的方向沿用,将目标和取舍留在 issue,不重复审批。
-- PR 围绕一个明确目标,相关修复可分提交;无关目标分别评审。交付批次可包含多个 PR,共享组合验证,不把一个批次限制成一个任务或一个 PR。
+- PR 按可独立验收的目标分组。同一目标的实现、测试、升级补修和解除该交付 CI 失败所需的修复,默认放在同一个 PR,按可单独描述与回退的改动分提交;不按工具、工作者、文件类型或单条警告拆 PR。
+- 无关目标分别评审;只有需要独立交付、发布或回退,或确需隔离产品授权、维护归属与实际冲突时才拆 PR,并在说明中写明理由。批次可包含这些独立目标的多个 PR,统一组合验证与集成。
- 提交保持 `type(scope): 描述`,实现与测试原子提交。PR 记录目标、实际改动、影响面、验证及适用的升级生效方式,具体格式见 [贡献约定](../../../CONTRIBUTING.md)。
- 在主线合入前完成 PR 审阅与必要验证;本地组合树可用于统一验收。平台不可写时保存分支、PR 说明和验证回执,明确远端 PR 未完成,不以事后补单替代合入前审阅。
diff --git a/.claude/skills/peach-worktree/SKILL.md b/.claude/skills/peach-worktree/SKILL.md
index abc855a5f..7490ca297 100644
--- a/.claude/skills/peach-worktree/SKILL.md
+++ b/.claude/skills/peach-worktree/SKILL.md
@@ -39,7 +39,7 @@ description: Peach 代码任务开工,以及创建、提交、集成或回收
## 多分支一起合入
-由一个协调会话统一测试与集成。先协调各任务停止本批次的测试、ready、integrate 与重试,核对最终提交;不停止无关任务。
+由一个协调会话统一测试与集成;工作树或工作者数量不决定 PR 数,按[交付范围](../peach-issue-delivery/SKILL.md#issue-与-pr-范围)归并,同一目标先汇入一个交付分支再提 PR。先协调各任务停止本批测试、ready、integrate 与重试,核对最终提交,保留无关任务。
在专用集成工作树按无冲突、有冲突、自己的顺序合入最终提交。源码冲突只在双方保留项已明确且能全部保留时解,否则中止本次冲突合并,交原任务更新分支。
`web/dist` 冲突保留集成侧,源码合齐后统一构建。最后提交声明整批 README 影响,跑一轮 `auto` 再 ready、integrate。
全站尺寸、字号、命名或控件语义变化须检查全部相关浏览器用例;小改按影响选测。时序超时先用 `agent_worktree.py processes` 排查本任务重叠运行,不在相同失败状态反复全量。
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d530d39db..6eb6e2865 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -63,7 +63,7 @@ GitHub 的字段与模板机制见 [Issue types](https://docs.github.com/en/issu
1. 不用 `git add .`、`git add -A`、目录路径或通配符,只暂存这次改动的文件。
2. 实现和它的测试放在同一个提交里。
-3. 一个 PR 围绕明确目标,在「影响面」表里说明数据层、API、页面、契约、测试和文档的实际影响,不适用的写明原因。相关任务可以按逻辑分提交、同批交付并共享验证;无关需求拆开评审。
+3. 一个 PR 对应可独立验收的目标。同一目标的实现、测试及必要的 CI、升级补修放在同一个 PR,按逻辑分提交并共享验证;无关需求独立评审,确需拆分时说明独立交付或隔离的理由。在「影响面」表里说明数据层、API、页面、契约、测试和文档的实际影响,不适用的写明原因。
### 变更性质与行为边界