Files
willtools-demo/QNA/README.md
T
will 8e6ee31596
ci / test (push) Successful in 6m18s
WillTools 2026-09-09 -- clean snapshot of the development repo for review
History-free snapshot of the private development repository at cbe45c5
(2026-09-09). Code, docs and public catalogue only; no plant or job
knowledge layers, no client or job names (tools/scrub.py clean). The
intro deck is left out of this snapshot because its slide images could
not be checked for job drawings.
2026-09-09 08:32:15 -05:00

53 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# QNA — 有啥不明白的,写在这儿
这个文件夹只有一个用途:**你随手记下没搞懂的问题,我看到了就回答。**
不用等到我在旁边。想到了就写,反正记下来的问题总比忘掉的强。
---
## 怎么问
打开 `questions.md`,在最下面加一段:
```markdown
## Q: transfer length 那个 33.2 in 是怎么来的?
```
`## Q:` 开头,一行说清楚就行。要贴代码、贴报错、贴一段 job JSON 都可以,
跟在下面就是了。**不用管格式,不用管排版。**
写完存盘。就这样,没有别的步骤。
## 怎么得到回答
我会在问题下面直接补一段:
```markdown
**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` 里那两行删掉就行。