MyKnowledge

创建知识库、管理项目文档、记录需求、整理个人知识。Create knowledge bases, manage project docs, track requirements, and organize personal knowledge.

MyKnowledge Skill

概述

MyKnowledge 是一个通用的知识库管理 Skill，帮助用户：

• 创建标准化的知识库目录结构
• 管理需求生命周期（创建、更新、归档）
• 维护 PROJECT-STATUS.md 项目状态快照
• 导出/导入知识库（跨用户分享、备份迁移）
• 支持个人知识管理和项目文档管理

关于存储路径的说明：本 Skill 默认将知识库存储在 ~/.myknowledge/ 目录下。这是用户明确授权的知识库存储路径，不是系统配置文件。本 Skill 只会访问用户明确授权的路径，不会访问其他系统配置文件。

首次使用引导

1. 检测初始化状态

加载本 Skill 时，首先检查 skill-state.yaml：

• 存在 → 跳过引导，正常使用
• 不存在 → 执行首次引导（约 1 分钟）

2. 首次引导流程

步骤 1：欢迎与介绍

text

AI：👋 欢迎使用 MyKnowledge！

我是你的智能知识库助手，可以帮你：
1. 自动整理项目资料
2. 记录要做的事情
3. 跟踪任务进度
4. 自动帮你做记录（可选）

步骤 2：平台确认

text

AI：你使用什么 AI 助手？
[CodeBuddy] [WorkBuddy] [OpenClaw] [其他] [帮我检测]

步骤 3：自动记录设置

text

AI：是否开启「自动记录」？

当你说的事情比较复杂时（如"分析数据"），
我会自动帮你创建记录。

1 — 开启（推荐）：自动帮你创建记录
2 — 关闭：你来手动控制

💡 随时可以说"开启/关闭自动记录"修改

步骤 4：保存配置

创建 skill-state.yaml 记录用户选择，包含：

• 平台类型
• 自动记录开关
• 引导完成标记

重要：引导只在首次使用时显示，之后不再出现。

步骤 5：引导结束

text

AI：🎉 设置完成！记住这几句话：
• "创建知识库" - 开始新项目
• "项目进展如何？" - 查看状态
• "继续之前的项目" - 恢复工作
• "导入知识库" - 导入别人分享的知识包
  （说"导入知识库"然后提供对应的知识文件给我即可）

✅ 引导已完成，下次不再显示
💡 如需重新查看，说"重新初始化"

使用模式

模式 1：主动使用

用户显式请求创建知识库（默认走全局，不询问类型）：

text

用户：创建知识库
AI：（自动创建到 ~/.myknowledge/global/{项目名}/）
     📁 已创建知识库「{项目名}」
     
用户：在当前目录创建知识库
AI：（在项目目录创建 .myknowledge/）

模式 2：自动检测

AI 检测到复杂任务时自动创建知识库并告知用户：

text

用户：帮我分析这个销售数据
AI：（检测到复杂任务）
    🔇 已自动创建知识库「销售数据分析」和需求 REQ-20260608-001

复杂任务检测规则：

• 关键词（满足 3 个及以上触发）：分析、统计、挖掘、开发、设计、调研、整理、清洗、项目
• 任务特征：多步骤操作、需要长期跟踪、涉及数据或文档

知识库结构

全局知识库

text

~/MyKnowledge/global/
├── README.md
├── requirements/
├── public/
├── archive/
└── PROJECT-STATUS.md

项目知识库

text

{project-path}/.myknowledge/
├── README.md
├── requirements/
├── public/
├── archive/
└── PROJECT-STATUS.md

核心功能

1. 创建知识库

text

输入：
- 类型（全局/项目）
- 名称（可选）

输出：
- 完整的知识库目录结构
- 初始化的 PROJECT-STATUS.md

2. 创建需求

text

输入：
- 需求标题
- 需求描述

输出：
- 需求目录 requirements/REQ-YYYYMMDD-XXX/
- 需求文档 README.md
- 更新的 PROJECT-STATUS.md

3. 更新需求状态

支持状态流转：

• Created → In Progress → Review → Done
• Created → Cancelled

4. 导出/导入知识库

text

用户：导出项目「销售分析」
AI：打包为 myknowledge-export-销售分析.zip
    → 包含项目状态 + 需求索引 + 安装引导

用户：导入知识库
AI：解压到全局知识库 → 同名项目提供覆盖/重命名/对比选项

5. 会话恢复

text

用户：继续 xxx 项目
AI：读取 PROJECT-STATUS.md...
    恢复项目状态，继续工作

平台适配

OpenClaw（Hook 事件驱动）

通过 Hook 在消息到达时主动触发检测，不依赖 AI 是否注意到：

• message:received → 检测任务复杂度
• 更可靠地自动创建知识库和记录需求（操作后告知用户）
• 详细配置参考：hooks/openclaw/hook-guide.md

注意：OpenClaw 的 Hook 模式是"后台运行（操作后告知）"，并非"无感知"。首次检测到大任务时会询问用户是否开启自动记录。

CodeBuddy/WorkBuddy（意图识别）

通过 description 匹配和 Prompt 逻辑：

• AI 自动判断是否需要创建知识库
• 操作前会提示用户确认

Claude（意图识别）

通过意图识别检测复杂任务，AI 自动判断是否创建知识库（操作前提示用户）。

⚠️ Hook 支持取决于具体 Claude 环境，默认通过意图识别工作。如有 Hook 需求，参考 hooks/claude/README.md。

文件说明

文件/目录	用途
SKILL.md	本文件，Skill 主入口
settings.yaml	Skill 配置
core/	核心功能（主逻辑、模板）
modules/	可选模块（懒加载：管理、更新、错误处理、智能任务追踪）
one-time/	一次性配置（首次引导、安装源检测）
hooks/	平台 Hook（OpenClaw、Claude）
test/	测试套件（开发用，AI 忽略）

AI 助手注意：test/ 目录仅供开发和测试使用，正常响应用户请求时请忽略。

用户支持

AI 助手注意：遇到以下情况时，引导用户查看对应文档（都在 Skill 目录下）。

用户遇到...	引导查看
常见使用问题	FAQ.md — 按主题分类的问答（智能任务追踪、平台差异、备份等）
踩坑了	docs/PITFALLS.md — 19 个真实使用坑及正确做法
不知道怎么用	README.md — 快速开始 + 使用场景 + 高手技巧
需要重新初始化	说"重新初始化 MyKnowledge"即可重置

依赖

• 文件系统操作能力
• 模板渲染能力
• （可选）OpenClaw Hook 支持

许可证

Apache License 2.0