knowledge-mgmt

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 执行:

1. 约束检查 — 原始约束是否满足？
2. AAR 扫描 — 有什么值得记录的经验？
3. 泛化检查 — 是否可复用于其他项目？
4. 激活检查 — 新知识是否在任务路径上？

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