docs: add agent self-check rules (read-back, final-artifact verification)

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