MyKnowledge Skill

概述

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

• 创建标准化的知识库目录结构
• 管理需求生命周期（创建、更新、归档）
• 维护 PROJECT-STATUS.md 项目状态快照
• 支持个人知识管理和项目文档管理

首次使用引导

1. 检测初始化状态

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

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

2. 首次引导流程

步骤 1：欢迎与介绍

AI：👋 欢迎使用 MyKnowledge！

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

步骤 2：平台确认

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

步骤 3：自动记录设置

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

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

[开启] - 自动记录（推荐）
[关闭] - 手动控制

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

步骤 4：保存配置

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

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

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

步骤 5：引导结束

AI：🎉 设置完成！记住这 3 句话：
• "创建知识库" - 开始新项目
• "项目进展如何？" - 查看状态
• "继续之前的项目" - 恢复工作

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

使用模式

模式 1：主动使用

用户显式请求创建知识库：

用户：创建知识库
AI：请选择类型：
     [全局知识库] - 位于 ~/MyKnowledge/global/
     [项目知识库] - 位于当前项目目录

模式 2：静默使用（自动检测）

AI 自动检测复杂任务，静默创建知识库：

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

复杂任务检测规则：

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

知识库结构

全局知识库

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

项目知识库

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

核心功能

1. 创建知识库

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

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

2. 创建需求

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

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

3. 更新需求状态

支持状态流转：

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

4. 会话恢复

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

平台适配

OpenClaw（完全静默）

通过 Hook 实现事件驱动：

• message:received → 检测任务复杂度
• 自动创建知识库和记录需求
• 详细配置参考：hooks/openclaw/hook-guide.md

CodeBuddy/WorkBuddy（意图识别）

通过 description 匹配和 Prompt 逻辑：

• AI 自动判断是否需要创建知识库
• 复杂任务自动记录

Claude（意图识别）

通过意图识别检测复杂任务，AI 自动判断是否创建知识库。

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

文件说明

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

用户支持

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

依赖

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

许可证

Apache License 2.0