用途:cs-trick 面向问题给出经过验证的正确做法,回答“要做 X,标准做法是什么”。它把可复用的编程模式、库用法、技术技巧沉淀为处方性参考库,产物写入 .codestable/compound/,命名 YYYY-MM-DD-trick-{slug}.md,frontmatter 带 doc_type: trick。
三种类型:pattern 用于设计模式、架构模式、编程惯用法;library 用于某个库或框架的用法、配置与常见坑;technique 用于具体操作技巧、工具用法、命令配方。查询时按“代码怎么组织”“库 API 怎么用”“这类操作怎么做”分别对应三类。
使用方式:启动前先读 .codestable/attention.md,缺失则提示补齐或运行 cs-onboard。工作流分阶段:识别类型(最多两个问题确定 type 与 topic);查重叠与意图分流(含“改/更新/修订”或指向旧文档则走更新流程,否则用搜索工具查 topic);代码调查(必做,用 Grep 等搜索代码仓并读取关键文件,记录路径与片段);提炼要点(一次一个问题,已能从代码看到的不再问);起草并交用户 review;归档新建或写回更新;最后做可发现性检查,必要时提示用 cs-note 追加到 attention.md。
搜索工具示例:python .codestable/tools/search-yaml.py --dir .codestable/compound --filter doc_type=trick --filter type=library --filter framework~={库名};也可按 language、status 筛选或加 --query 查重叠。
限制:只归档已验证的做法,不归档“也许应该这样做”;Phase 2 代码调查不可跳过,示例优先用项目真实代码;用户说不清原理时写“原理待补充”,不编造;只读写 doc_type: trick 的文档。共享路径、命名与归档规则见 .codestable/reference/shared-conventions.md,完整搜索语法见 .codestable/reference/tools.md。