cs-learn 启动必读 开始任何判断或动作前，先读取 ；缺失则视为骨架不完整，提示先补齐或运行 ，不要回退到外部 AI 入口文件。 每次做 feature 或修 issue 都会留下 spec 文件。但 spec 记录的是"做了什么"和"怎么做的"， 不会记录"踩了什么坑"和"发现了什么更好的做法" 。没有沉淀的团队总在重复解决同一个问题。 两条轨道： - 坑点轨道 （pitfall）：记录问题 / 根因 / 解法，防止下次再掉进同一个坑 - 知识轨道 （knowledge）：记录最佳实践 / 工作流改进 / 可复用模式 两者都写入 （共享目录见 第 1 节"归档类文档"）。本技能产出 frontmatter 带 ，命名 。 --- 什么时候触发 | 情境 | 说明 | |---|---| | 完成 feature 工作流 | 主动问"要记录这次的学习点吗？" | | 完成 issue 工作流 | 主动问"要把这个坑记录下来吗？" | | 用户主动 | "记录一下"、"沉淀知识"、"learning"等 | | 解决了一次性难题 | 不在 feature / issue 内但花了大量时间才解决的工程问题 | 主动推荐一句话即可，用户说"不用了"立刻跳过——重复推可能让用户觉得 AI 在加戏。 --- 两条轨道各写什么 坑点 ：调试过的 bug / 绕过的配置陷阱 / 环境问题…