From 9b326f3b4b80150d317a1cdf7df956f83bab14dd Mon Sep 17 00:00:00 2001 From: dsh Date: Sat, 7 Nov 2026 11:49:00 +0800 Subject: [PATCH] AGENTS.md: read the docs before touching anything --- AGENTS.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index dffc968..be17888 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,13 @@ # 给接手的 agent 的话 +> **动手之前,先把这份文件从头读完**,再看 `README.md`、`SPEC.md` +> (`C:\Users\peng0\git\r8asm_rev-fork\SPEC.md`)和 `asm/lib.r8asm` 里的宏注释。 +> 这条不是客套:上一轮我没先读,把「位移-加法乘法器比重复加法快」当成新发现又推了一遍, +> 而下面「乘法器」「指令集语义」两节其实已经把要命的地方都写了 —— +> `dp` 净位移、`flb` 吃条件、`rol` = 10 次 `ror`、乘法成本 ∝ `MUL` 的值、 +> 位串行要的跨格移位该怎么拼。**尤其把「已经确认走不通的」那节看完**, +> 别把别人踩过的坑再踩一遍;想推翻某条结论,先照它写的验证方法实测一遍再改文字。 + 这个文件是给下一个会话(或者下一个 agent)看的交接说明。内容都是这个仓库里**实测过**的结论, 不是推测;每条后面基本都跟着一次失败的尝试,别再踩。