# personal-knowledge skill

**Repository Path**: codeliudelong/personal-knowledge-skill

## Basic Information

- **Project Name**: personal-knowledge skill
- **Description**: 写完需求，写完bug，一键沉淀知识。组织清晰，超好用！
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-29
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人知识库落库系统

一套跨 agent（CodeBuddy / Claude Code / Codex）通用的个人知识沉淀方案。写完需求或修完 bug 后，一键将对话中的技术知识和踩坑经验归档到本地结构化知识库。

## 目录结构

```
darrenKnowledge/
├── README.md               # 本文件
├── install.sh              # 安装脚本（软链接）
└── skills/
    └── personal-knowledge/     # skill 本体
        ├── SKILL.md            # 技能指令
        └── references/         # 模板文件
            ├── tech_entry_template.md
            ├── pitfall_entry_template.md
            └── index_template.md
```

## 安装

```bash
./install.sh
```

脚本会将 `skills/` 下的 skill 通过软链接安装到各 agent 的用户目录：

- `~/.codebuddy/skills/` — CodeBuddy
- `~/.claude/skills/` — Claude Code

修改仓库中的 skill 文件即可在所有 agent 中即时生效，无需重新安装。

## 使用方式

在任意 agent 对话中输入：

```
/personal-knowledge
```

Skill 会分析当前对话上下文，自动识别：

| 类型 | 说明 | 典型场景 |
|------|------|---------|
| **技术类** | 使用了什么技术/方案，适用场景是什么 | 需求开发、功能实现完成后 |
| **踩坑类** | 遇到的问题、原因、解决方法、注意事项 | Bug 修复完成后 |

## 知识分类

按平台自动分类到对应目录：

| 平台 | 目录 | 触发关键词 |
|------|------|-----------|
| 鸿蒙 | `harmonyos/` | ArkTS, ArkUI, Stage模型 等 |
| Android | `android/` | Kotlin, Jetpack, Gradle 等 |
| iOS | `ios/` | Swift, SwiftUI, Xcode 等 |
| 前端 | `frontend/` | React, Vue, TypeScript 等 |
| 后端 | `backend/` | Go, Spring, Node.js, 数据库 等 |
| 通用 | `general/` | 跨平台或不明确 |

每次归档后会自动更新 `INDEX.md` 总索引，方便后续检索。

## 安全策略

所有代码示例均为脱敏后的 demo 代码：

- ❌ 公司内部包名、类名、接口 URL
- ❌ 真实业务逻辑代码
- ❌ 内网地址、密钥、Token
- ✅ 通用占位名（`MyComponent`、`api.example.com` 等）

## 示例工作流

```
用户: （修复了一个 RecyclerView 滑动崩溃的 Android bug）

用户: /personal-knowledge

Agent: 已识别以下可沉淀的知识:
  1. [Android/踩坑类] RecyclerView 快速滑动时 IndexOutOfBoundsException
     原因: notifyItemRemoved 后未等动画结束就更新数据
     方案: 使用 DiffUtil + ListAdapter 替代手动 notify
  2. [Android/技术类] DiffUtil 在列表更新中的应用

Agent: （自动创建 android/pitfall_recyclerview_index_out_of_bounds.md
       和 android/tech_diffutil_list_update.md，
       并更新 INDEX.md）
```