项目知识

知识放在仓库的 .tw/：overview.md、glossary.md、rules/、decisions/、lessons/，与代码一起评审；.tw/local/ 是被 Git 忽略的本机目录。命令都是 python3 <本技能目录>/scripts/tw.py <命令>，下文简写为 tw。

开工前

1. 用用户的原始要求读取：tw brief --task "<要求>" [--path <文件或目录>] [--symbol <符号>]。查明真实入口后，带上 --path 再读一次。
2. 按读到的约束实施。要重新采用“放弃过的做法”或已拒绝的决策时，先写出新理由并告知用户。
3. 需要全文时用 tw read <条目或文档编号>；tw read --list 列出已登记的原文。

完成后

可复用的结论按种类写：

• 修复了根因不明显的缺陷：写 lesson，尽量绑定守护测试。
• 做了难以逆转、缺少背景会让人意外、确有取舍的选择：写或改写 decision。决定改变时，旧做法连同放弃原因移入“放弃过的做法”。
• 改变了必须保持的行为或契约：新增或改写 rule。
• 项目已登记原文（config.json 的 documents）时，直接改原文，条目引用它。