Skip to content

armgit / peach

Public Imported from GitHub
0

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

docs(agent): 测试期间静默等待并统一汇报结果

longmeidao3f076ed35bb6
diff --git a/.claude/skills/peach-worktree/SKILL.md b/.claude/skills/peach-worktree/SKILL.md
index 639e68ab3..8c5e8ceb2 100644
--- a/.claude/skills/peach-worktree/SKILL.md
+++ b/.claude/skills/peach-worktree/SKILL.md
@@ -6,7 +6,7 @@ description: 在用户说并行、工作树、暂存、提交、ready、集成
# 并行 worktree 与提交边界
最后复核:2026-10-20
-证据来源:[开发约定](../../../AGENTS.md)、`README.md`、ADR-0015、ADR-0017、本机工作树与沙箱工具记录、用户于 2026-10-20 确认的测试进度汇报约定。
+证据来源:[开发约定](../../../AGENTS.md)、`README.md`、ADR-0015、ADR-0017、本机工作树与沙箱工具记录、用户于 2026-10-20 确认的进度播报成本与汇报约定。
## 是否委派与何时使用
单一功能域、局部改动或预计 30 分钟内完成的任务,由协调者在自己的隔离工作树直接完成;只有任务可独立并行、需要隔离环境,或长跑过程能明确缩短总耗时才委派。
@@ -26,7 +26,7 @@ description: 在用户说并行、工作树、暂存、提交、ready、集成
两者契约相同:优先当前树 venv,缺失时从 Git common directory 定位主项目 venv,强制 `PYTHONPATH=<当前工作树>/src`,
核对 `peach.__file__` 后运行标准库 `unittest`。禁止手工拼接 venv 路径或调用 pytest。
测试入口固定 `PYTHONIOENCODING=utf-8`,覆盖标准输出、错误输出及子进程;其他 Python CLI 使用 `-X utf8`。
- 安装依赖和构建完成后再验证;测试期间不改变环境。主检出与隔离工作树均默认自动选测。测试进度用百分比表示,注明已完成/总量及用例、分片或批次口径;总量未知时明确说明,不按耗时估算。
+ 安装依赖和构建完成后再验证;测试期间不改变环境。主检出与隔离工作树均默认自动选测。例行进度播报与频繁日志轮询会消耗 token;测试期间静默等待,完成或确需用户处理的阻塞时统一汇报,用户追问时再提供进度。
PowerShell 读 UTF-8 日志显式加 `-Encoding utf8`;编码在输出端固定,不能只给读取端指定编码。
记录绑定完整代码内容、依赖环境和范围,24 小时有效;失败撤销对应范围,运行中改动只保留未受影响的完整批次文件结果。
用 `-Focus` / `--focus` 先验证相关 Python 或浏览器用例,调试不签记录;冻结改动后只运行一次 `auto`,不另写逐域循环。失败先定向修复,再让 `auto` 复用未受影响的记录,详见 `docs/TESTING.md`。