diff --git a/AGENTS.md b/AGENTS.md index 8cd2cc3..277b613 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,12 +4,20 @@ ## 协作方式(用户定案,最高优先级) +> 与全局 `~/.dsh/AGENTS.md` 同步;外部 Agent(如 Codex)不加载全局文件,故此处保留全文。 + - **设计先给最小版**:任何 UI/文案/方案先交「最少元素」版本给用户拍板,确认后再增量; 默认克制——没有存在理由的元素不放;不一次搭「完整版」再返工。 - **长任务拆 checkpoint**:每个可验收阶段完成后停下汇报,等用户确认再进下一段; 不一口气跑完长任务。 - **对外动作永远先审**:发布、评论、给观众的内容、任何公开操作,一律先给用户过目, 用户不点头不执行。 +- **改完必读回**:每次编辑后读回改动处的完整行/段落,确认无残留、无断尾 + (教训:改一半的 URL 留下旧尾巴,被复审抓为发布阻断)。 +- **验收用最终产物,不用中间信号**:任何交付物(tgz、命令、文档、UI)的验收动作必须是 + 「解包 / 复制 / 实跑用户路径」;「构建成功」「bundle 里有字符串」「退出码 0」不算验收。 +- **发布前自跑最终产物清单**:干净目录安装、最终包逐文件核对、双资产哈希、关键行逐字 + grep —— 先自查再报告,不等外部复审来抓。 ## 边界