knowledge-baselisted

# Knowledge Base Skill 一个旨在消除认知偏差、显式化隐性知识的知识库管理工具。它结合代码扫描（ace-tool）、网络搜索和结构化文档管理，构建项目的"第二大脑"。 ## 核心理念：打破“知识诅咒” "知识诅咒"（Curse of Knowledge）是指当我们掌握某种知识后，很难想象不懂这种知识的人的状态。在软件工程中，这表现为： - 资深开发者假设新人“应该知道”某些上下文。 - 代码中充斥着特定领域的缩写和隐喻。 - 架构决策的背景被遗忘，只留下结果。 本技能通过以下方式解决此问题： 1. **显式化（Explicitness）**：强制将默会知识（Tacit Knowledge）转化为显性知识（Explicit Knowledge）。 2. **上下文对齐（Context Alignment）**：通过代码扫描提取领域术语，建立统一词汇表。 3. **认知共识（Cognitive Consensus）**：记录“为什么这样做”而不仅仅是“怎么做”。 ## 执行环境 | 路径类型 | 路径 | 说明 | |---------|------|------| | **技能目录** | `~/.pi/agent/skills/knowledge-base/` | 脚本和模板位置 | | **主脚本** | `~/.pi/agent/skills/knowledge-base/lib.ts` | 核心逻辑脚本 | | **知识库目录** | `./docs/knowledge/` | **项目根目录**下的文档存储位置 | ## 目录结构 ``` docs/knowledge/ ├── concepts/ # 领域概念与术语 (名词解释) │ ├── [Term].md # 一级文档：e.g. "DoubleEntryBookkeeping.md" │ └── auth/ # 二级分类 │ ├── User.md │ └── Session.md │ └── frontend/ # 二级分类 │ ├── responsive/ # 三级分类 │ │ └── design/ # 四级分类 │ │ └── MobileFirst.md │ └── pwa/ # 三级分类 │ └── advanced/ # 四级分类 │ └── optimization/ # 五级分类 │ └── ProgressiveWebApp.md ├── guides/ # 操作指南与最佳实践 (How-to) │ ├── [Topic].md # 一级文档：e.g. "ErrorHandlingStrategy.md" │ └── backend/ # 二级分类 │ ├── API.md │ └── Database.md │ └── frontend/ # 二级分类 │ └── css/ # 三级分类 │ └── flexbox/ # 四级分类 │ └──