| name | knowledge-mgmt |
| description | 知识管理与自更新机制。当用户要求"记录经验"、"更新规则"、"踩坑回填"、 "更新 skill"、"知识沉淀"时触发。实现 skill-based 架构的自演进能力。
|
Knowledge Management — Self-Evolving Skills
此 skill 实现知识沉淀和自更新机制，与 Trellis 项目管理和 GitNexus 代码智能协同。
Core Principle
Activation over Storage — 记录的知识必须在任务路径上激活，否则只是"存储"而非"捕获"。
When to Use
- 任务完成后进行 AAR (After-Action Review)
- 发现新的 pitfall/gotcha
- 需要更新 skill 规则
- 知识需要跨项目复用
Task Routing
| 触发词 | 路由到 |
|---|
| "记录踩坑"、"添加 gotcha" | workflows/record-gotcha.md |
| "更新规则"、"更新 skill" | workflows/update-rules.md |
| "任务完成"、"AAR" | workflows/task-closure.md |
| "创建新 skill" | workflows/create-skill.md |
Task Closure Protocol
每次非平凡任务完成后 MUST 执行:
- 约束检查 — 原始约束是否满足？
- AAR 扫描 — 有什么值得记录的经验？
- 泛化检查 — 是否可复用于其他项目？
- 激活检查 — 新知识是否在任务路径上？
Progressive Rigor
根据压力增长，不要过早优化:
| 层级 | 结构 | 触发条件 |
|---|
| Single-file | 仅 SKILL.md | < 3 主题 |
| Folder-light | + rules/ | 3-5 主题或 1 个工作流 |
| Full | + workflows/ + references/ | ≥ 3 路由任务，有踩坑日志 |
Target Structure
skills/<name>/
├── SKILL.md # ≤100行: 入口、路由、优先级
├── rules/ # 约束规则 (永远为真)
├── workflows/ # 工作流程 (如何做任务)
├── references/ # 背景: 架构、陷阱、索引
│ └── gotchas.md # 踩坑日志 (最有价值)
└── docs/ # 可选: 提示词、报告
Generalization Rule
记录必须脱离当前项目上下文:
错误: "在 bigscreen 项目中，我们发现打包失败是因为..."
正确: "Vue 3 大屏项目打包时，如果 obfuscator 展开到 vue() 内部，会导致..."
Resources
references/progressive-rigor.md — 分层演进规则references/protocols.md — 协议参考templates/ — 技能模板
相关 Skills: project-workflow, code-intelligence
