| name | session-practice-learner |
| description | session 收尾自动提炼经验并路由到 skill/rule/agent。触发条件：session 收尾、用户明确纠偏、稳定实践/重复错误/harness 资产缺口暴露。关键字：session 收尾、纠偏、经验落盘、知识沉淀、skill 更新、rule 更新、agent 更新、ESLint 规则新增。文件类型：.trae/skills/**、.trae/rules/**、.trae/agents/**、AGENTS.md、.eslintrc.*。使用场景：每次 session 结束前判断是否有长期可复用知识，落盘到最合适的资产或输出 No-op。 |
Session Practice Learner
在 session 即将结束时运行，完成"提炼 → 路由 → 落盘"全流程，无需分步调用。
触发时机
- Session 收尾，回顾本轮的改动与决策
- 用户明确说"以后都应该这样做"
- 同类错误在本轮多次出现，已值得总结
- 某个改动背后体现了稳定的新实践，而非局部修补
Step 1 — 提炼学习点
从以下材料中归纳本轮的学习点：
- 用户的纠偏、补充要求、对最终方案的确认
- 最终落地文件和关键实现方式
- 本轮中间的失败尝试或返工记录
- 构建 / 测试 / review 结果
每条学习点输出：
### <标题>
- Type: Hard Rule | Reusable Practice | Role Gap | One-off Context
- Evidence: <支撑证据>
- Why It Matters: <对未来的价值>
- Scope: <适用范围>
- Confidence: high | medium | low
质量门槛：没有证据的结论不输出；只涉及一次性上下文的标为 One-off Context，不进入后续步骤。
Step 2 — 路由落点
对每条 Hard Rule 或 Reusable Practice，按下表选落点：
| 落点 | 选它的条件 |
|---|
rule | 本质是"必须/应该遵守的长期约束"；可用 MUST/SHOULD 表达；违反会带来稳定风险或返工 |
skill | 本质是"怎么做一件事"的执行说明；有清晰触发条件和典型输入；更像 checklist、playbook、实施模板 |
agent | 需要长期存在的职责边界；有独立输入/输出/决策门槛；不是一句规则或一个 skill 能覆盖的职责 |
eslint | 规范描述的是可被 AST 静态检测的代码结构问题；有现成 ESLint 规则可配置，或结构固定到可以写自定义规则 |
no-op | 只适用于本轮上下文；只是个体偏好；没有稳定触发条件或验收标准 |
已有资产的处理：先检查现有 .trae/skills/、.trae/rules/、.trae/agents/、.eslintrc.js，如果已有资产能覆盖但表达不足，优先更新现有资产，而不是新增。只有确认现有资产已完整时才落到 no-op。
一条学习点可以同时拆成多个落点组合，例如 rule + eslint（文字约束 + 自动拦截）。
每条输出：
### <标题>
- Decision: rule | skill | agent | eslint | no-op | update:<existing-file>
- Why: <理由>
- Rejected Alternatives: <排除了哪些落点及原因>
- Target Files: <建议写入的文件路径>
Step 3 — 落盘
根据 Step 2 的决策直接写文件，不需要用户逐条确认（置信度 low 的除外，先征询意见）。
写 rule
- 路径：
.trae/rules/<rule-name>.md
- 文件不超过 80 行：rule 只写约束本身，不写操作说明；操作说明另建 skill
- 只有需要影响所有 session 默认行为的约束才设
alwaysApply: true
- 正文用 MUST / SHOULD / SHOULD NOT 组织，每条约束一行，不写散文
- 不包含示例代码；如需举例，链接到对应 skill 或 docs
写 skill
- 路径：
.trae/skills/<skill-name>/SKILL.md
- 文件不超过 200 行：超出说明职责过宽，应拆分或抽 docs/
- frontmatter 必填字段：
name：kebab-case，与目录名一致description：一句话，必须同时说明做什么和何时调用（作为 AI 路由依据）
- 正文必须包含以下章节（可合并，但不可缺）：
- 触发时机：明确列出哪些场景下应调用此 skill，避免模糊描述
- 输入：调用者需要提供什么上下文或材料
- 步骤：执行流程，有序编号
- 输出 / 质量门槛：产出物格式，或判断执行是否合格的标准
- 不在 SKILL.md 里堆砌大段示例代码；示例放
docs/ 子目录并通过链接引用
写 agent
- 路径：
.trae/agents/<agent-name>.md
- 文件不超过 150 行：agent 定义职责边界，不是操作手册
- 必须包含以下章节：
- 主体职责（一句话 + 简短说明）：这个 agent 存在的唯一理由是什么
- 触发时机：在哪个阶段、由谁、在什么条件下调用
- 输入：需要哪些上下文、文件、结论
- 流程：核心决策步骤，3-7 步为宜
- 输出格式：产出物的结构或模板
- 禁止事项：明确列出不该做的事，防止职责蔓延
- 边界说明：与现有 agent / skill 的职责分界，避免重叠
- 只有职责稳定且反复出现时才新建 agent；一次性任务用 skill
落到 eslint
调用 /coding-standards-lint skill，输入本条学习点作为待检查的规范条目，由该 skill 判断：
- 若有现成 ESLint 规则：直接在
.eslintrc.js 的 rules 中补充或调整配置
- 若需要自定义规则：按
.trae/skills/coding-standards-lint/docs/custom-rule-guide.md 的"新增规则三步走"，在 eslint-rules/ 中创建规则文件并注册
更新现有资产
直接 Edit 对应文件，在变更摘要里注明改了哪些部分及原因。
最终输出
## Session Learnings 落盘摘要
### 已写入
- [rule] .trae/rules/xxx.md — <一句话说明>
- [skill] .trae/skills/xxx/SKILL.md — <一句话说明>
- [agent] .trae/agents/xxx.md — <一句话说明>
- [eslint] .eslintrc.js rules / eslint-rules/xxx.js — <规则名及作用>
- [update] .trae/skills/yyy/SKILL.md — <改了什么>
### 跳过
- <标题> — One-off Context / 已被现有资产完整覆盖 / 置信度低待确认
