Files
will 25592fa6c2
ci / test (push) Successful in 6m14s
WillTools 2026-09-09 -- clean snapshot of the development repo for review
History-free snapshot of the private development repository at 77a82eb.
Code, docs and the public catalogue only: no plant or job knowledge
layers, no client, job or producer names (tools/scrub.py clean against
the widened term list; a second word-level grep clean). The intro deck is
left out because its slide images cannot be checked for job drawings.
2026-09-09 08:35:15 -05:00
..

QNA — 有啥不明白的,写在这儿

这个文件夹只有一个用途:你随手记下没搞懂的问题,我看到了就回答。

不用等到我在旁边。想到了就写,反正记下来的问题总比忘掉的强。


怎么问

打开 questions.md,在最下面加一段:

## Q: transfer length 那个 33.2 in 是怎么来的?

## Q: 开头,一行说清楚就行。要贴代码、贴报错、贴一段 job JSON 都可以, 跟在下面就是了。不用管格式,不用管排版。

写完存盘。就这样,没有别的步骤。

怎么得到回答

我会在问题下面直接补一段:

**A**(2026-08-22):ACI 318 的 ℓt = f_se·db/3 ……

答案就跟在问题下面,一个文件从上往下读就是一份记录 —— 不用在两个文件之间来回翻。


说清楚一件事:我不是 24 小时在线

盯这个文件夹的是 tools/qna_watch.py:它是当前 agent 会话里的一个后台任务, 一有改动就退出并叫醒我去读、去做,做完再重新布防。只有这个会话开着的时候才有效。 终端关了、电脑重启了,就没人看了 —— 那之后写进来的问题会一直躺在 questions.md 里,等下次会话开始时 watcher 一启动就会把积压的改动先报出来, 我读一遍,照样会答,只是没那么快。

所以:积压是正常的,丢掉是不会的。 下次开工的时候直接跟我说一句「看下 QNA」,我就把没答的都补上。

别在这儿写客户名和项目名

跟仓库里别的地方一个规矩(见 CLAUDE.md 第 3 节):不写业主名、不写工程名、 不写模型文件名。产品编号不算 —— design number、piece mark、五金件料号都可以照写。

保险起见,questions.md 本身是 gitignore 掉的,不会被 push 上去。 只有这份 README 进仓库,因为它是约定,不是内容。 哪天你想把问答记录也存进版本库,把 .gitignore 里那两行删掉就行。