Skip to content

armgit / peach

Public Imported from GitHub
0

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

docs(agent): 明确提交对应的CI结果与发布候选边界

longmeidao0b2ee4e2e726
diff --git a/.claude/skills/peach-issue-delivery/SKILL.md b/.claude/skills/peach-issue-delivery/SKILL.md
index 163a1105c..d977ddd31 100644
--- a/.claude/skills/peach-issue-delivery/SKILL.md
+++ b/.claude/skills/peach-issue-delivery/SKILL.md
@@ -5,7 +5,7 @@ description: Peach 收集或汇总用户反馈、代码交付、issue 与 PR、
# 反馈、Issue 交付与验证
-最后复核:2026-10-28
+最后复核: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)。
## 反馈收集与汇总
@@ -39,6 +39,7 @@ description: Peach 收集或汇总用户反馈、代码交付、issue 与 PR、
## 验证与关闭
- 分别确认代码合并、CI 结果、修复产物发布和 issue 验收;每项结论只使用对应证据。
+- 汇总的发布状态绑定候选提交和实际制品;标签已打或版本段已改不能批量转为「已发布」。发布失败保留已合入状态,成功后只推进候选真正包含的修复。
- 问题依赖特定硬件、部署环境或报告者确认时,通用测试、CI 通过和镜像发布不能代替该验证。必要验证未完成时保持 issue 开放;修复产物可供测试时使用 `status:needs-verification`。
- 尚需验证的 issue,在 PR 正文中用独立的 `Refs #编号` 行关联,跨仓库使用 `Refs owner/repo#编号`。此格式也供项目看板识别实现关联。
- 检查 PR 正文、提交消息以及合并时采用的消息,避免用 `Fixes`、`Closes`、`Resolves` 等关键词触发尚需验证的 issue 自动关闭。
diff --git a/.claude/skills/peach-worktree/SKILL.md b/.claude/skills/peach-worktree/SKILL.md
index 3378f5b19..31b750510 100644
--- a/.claude/skills/peach-worktree/SKILL.md
+++ b/.claude/skills/peach-worktree/SKILL.md
@@ -5,8 +5,8 @@ description: Peach 代码任务开工,以及创建、提交、集成或回收
# 工作树与集成交付
-最后复核:2026-10-28
-证据来源:工作树入口、交付门槛、集成与回收事故、用户确认的存量生效判据。
+最后复核:2026-10-29
+证据来源:工作树入口、交付门槛、集成事故、用户确认的存量生效判据及 0.51.0 发版复盘。
## 开工与职责
@@ -21,11 +21,15 @@ description: Peach 代码任务开工,以及创建、提交、集成或回收
1. 在当前工作树准备独立 venv,按 `docs/TESTING.md` 安装锁定依赖,不复制 venv 或修改正在服务的环境。
2. 行为修改先列失败路径与影响域,通过正式入口定向验证;新增或改名测试核对域登记,不能以文件存在代替覆盖。
3. 冻结改动后运行一次 `auto`;未知影响、实际依赖和共享设施用 `full`。环境、编码、源码定位、记录复用和补测契约统一见 `docs/TESTING.md`,不逐域循环重复公共用例。
-4. `ready` 前纳入当前 `master` 并验证最终内容。提交、声明与记录齐全后取得 `ready` 的实际结果。
+4. `ready` 前纳入当前 `master` 并验证最终内容;主线前移后交 `auto` 复用有效记录,不默认重跑全量。提交、声明与记录齐全后取得 `ready` 的实际结果。
5. 协调者执行 `integrate --branch <分支>`,等成功退出并核对主线提交,再做适用重启和运行核验。锁忙交入口等待,不手工 merge 绕过,不把分支交接当成验收完成。
主检出 master 的直接提交与手工 merge 由 hook 拒收。发布先完成 `docs/TESTING.md`「每次发版检查」的依赖升级批次,再通过 `scripts/release_tag.py` 定版、打标签与发布;更新清单不代表升级完成。发布时机采用 `release_due.py` 及集成入口的同一判据,不额外重复检查。
+推送后核对分支头 SHA 与工作流运行,使用 `gh run watch --exit-status` 等待结果并继续已授权的合入;不拿旧 PR 状态或 Release 成功代替 Test。失败先取日志和制品,同提交本地通过只能说明尚未复现,重试只限失败作业并保留首败原因;不同失败反复出现时先定位,不循环重试到绿。
+
+发版候选固定提交、清单和已验收产物。其他普通提交继续留在主线,不因主线前移重新选发布头;必须纳入的修复由发布入口重定候选并补验实际影响。标签存在、Release 创建、制品公开和镜像推送分别核验后才更新反馈发布状态。
+
## 修复的升级生效范围
- 替换代码或资源并正常刷新、重启即可生效的修复,跑对应行为回归,不强制增加迁移或新装、升级双轨检查。
diff --git a/docs/TESTING.md b/docs/TESTING.md
index c458cdcae..555c038ab 100644
--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@@ -203,9 +203,9 @@ ffmpeg 起不来是事实,但它不该挡住一次只改文档的 `checks`。
## 定向调试与局部记录
-Windows 的 `-Focus` 接受 Python 模块、类、方法或仓库相对路径,可传数组;macOS/Linux 对每个选择器重复传 `--focus`。入口准备隔离依赖并核对源码。选择器不存在、浏览器路径超出 `frontend/e2e` 或与分片混用时拒绝执行。浏览器用例只收单个 `frontend/e2e/*.test.ts` 文件,不收目录;要跑全部 e2e 时把文件逐个列进数组。
+Windows 的 `-Focus` 接受 Python 模块、类、方法或仓库相对路径,可传数组;通过 `pwsh -File` 调用时也接受一个逗号分隔参数。macOS/Linux 对每个选择器重复传 `--focus`。入口统一去重,拒绝空项并核对源码及隔离依赖。选择器不存在、浏览器路径超出 `frontend/e2e` 或与分片混用时拒绝执行。浏览器用例只收单个 `frontend/e2e/*.test.ts` 文件,不收目录;要跑全部 e2e 时把文件逐个列进数组。
-浏览器冒烟逐个文件执行,一个文件失败仍跑完其余文件,最后把各失败文件的输出与日志路径一起报出;一轮全量就能看到所有 e2e 失败,修完再起下一轮。
+浏览器冒烟逐个文件执行,一个文件失败仍跑完其余文件,最后把各失败文件的输出与日志路径一起报出;一轮全量就能看到所有 e2e 失败。搜索建议、键盘列宽调整和嵌套弹层的失败输出另保留当时的输入、焦点、弹层、等待态与无障碍树,原异常作为 cause 保留。取证不延长等待、不重试交互,也不忽略运行期错误。
定向调试 Python 回归: