前言¶
项目文档、需求记录和个人笔记如果散落在聊天窗口、临时 Markdown 和各个目录里，Agent 很难在多次会话之间接上上下文。常见做法是手写目录规范或用 Notion 一类协作工具，但对「只想在本机用 Markdown 管清楚、又让 AI 能按同一套结构读写」的开发者，往往要多维护一层约定。
下面介绍 SkillHub 社区 Skill MyKnowledge（坐标 @user_48539314/my-knowledge，当前版本 1.4.89）。它通过标准 SKILL.md 引导 Agent 创建知识库目录、跟踪需求状态、维护项目快照，并把数据落在用户授权的本地路径，而不是依赖云端 API。
这是什么¶
MyKnowledge 是面向 Agent 的通用知识库管理 Skill，由社区发布者 user_48539314（SkillHub 页面标注作者 CoderMoray）维护，分类为 knowledge-management，来源为 community。官方简介为：创建知识库、管理项目文档、记录需求、整理个人知识（英文：Create knowledge bases, manage project docs, track requirements, and organize personal knowledge）。
Skill 标签标明 requires_api_key=false，不依赖外部 API Key。实现形态是 Prompt + 本地文件操作：Agent 按 Skill 内模板与配置在磁盘上读写 Markdown 与 YAML，默认用户数据目录为 ~/.myknowledge/（与 Skill 安装目录分离，便于升级覆盖 Skill 本身）。
核心功能¶
以下能力均来自 Skill 主文档 SKILL.md 与 settings.yaml 中的说明。
标准化知识库目录¶
支持两种落盘方式：
- 全局知识库：
~/.myknowledge/global/{project-name}/ - 项目知识库：
{project-path}/.myknowledge/
每个知识库包含 README.md、requirements/、public/、archive/ 以及 PROJECT-STATUS.md 等项目状态快照文件；模板路径在 settings.yaml 的 directory_structure 中定义。
需求生命周期¶
需求 ID 格式为 REQ-{date}-{seq}（配置项 requirement_management.id_format）。状态流转包括：Created → In Progress → Review → Done，以及 Created → Cancelled。Agent 可创建需求目录、更新 PROJECT-STATUS.md，并将已完成需求归档到 archive/。
智能任务追踪（可选）¶
首次引导会询问是否开启「自动记录」。开启后，当用户任务被判定为「复杂任务」（例如关键词命中达到阈值，默认 min_keyword_count: 3）时，Agent 可自动创建知识库与需求记录；用户也可随时用「开启/关闭自动记录」切换。OpenClaw 等支持 Hook 的环境另有 hooks/openclaw/ 下的事件驱动说明；Cursor、Claude Code 等主要通过意图识别与 Skill 描述触发。
导出、导入与会话恢复¶
支持将项目打包为 zip 导出，并通过「导入知识库」从 zip 恢复；支持「继续 {项目名}」读取 PROJECT-STATUS.md 恢复上下文。Skill 明确不做联网同步、多用户实时协作或自动执行任意 shell 命令，边界见 Skill 包内 README.md 的「能力边界」表。
安装与启用¶
MyKnowledge 基于通用 SKILL.md 格式。在 SkillHub 上安装时，页面给出的 AI 提示为：根据 SkillHub 安装文档 安装 @user_48539314/my-knowledge。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装或仅安装 CLI（示例为文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装 MyKnowledge 到当前 Agent 的 skills 目录¶
SkillHub 文档要求：安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认装到 ./skills/ 可能不会被加载。常用路径如下（摘自 skillhub.md）：
| Agent / 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令示例（命名空间与 SkillHub 搜索结果一致）：
skillhub install my-knowledge --namespace user_48539314 --dir ~/.cursor/skills/
也可使用坐标形式：
skillhub install @user_48539314/my-knowledge --dir ~/.cursor/skills/
Skill 包内 README.md 写明：更新时重新执行安装命令即可覆盖 Skill 版本，用户数据在 ~/.myknowledge/ 下，不会因 Skill 升级而删除。
3. 首次运行¶
加载 Skill 后，若不存在 skill-state.yaml（默认路径见 settings.yaml 中的 user_data.state_file：~/.myknowledge/config/skill-state.yaml），会执行约一分钟的首次引导：确认平台、是否开启自动记录，并写入配置。之后可说「重新初始化」重置引导。
安装或升级 Skill 后，按你所用客户端要求重启或重新加载 skills（SkillHub 安装文档对「需重启」有通用提醒）。
典型用法¶
经过上面的安装与首次引导，日常交互以自然语言「固定命令」为主；modules/commands/main.md 提供了速查表，下面是与官方示例一致的可复现说法。
创建知识库¶
全局默认（不指定工作区时）：
用户：创建知识库
绑定当前项目目录：
用户：在当前目录创建知识库
需求与状态¶
用户：新建需求 销售数据分析
用户：REQ-20261023-001 进行中
用户：项目进展如何
用户：继续 销售分析
导出与导入¶
用户：导出项目 销售分析
用户：导入知识库
导入时按 Skill 说明提供知识包文件，同名项目可选择覆盖、重命名或对比。
自动记录开关¶
用户：开启自动记录
用户：关闭自动记录
用户：调整检测灵敏度
复杂任务示例（来自 SKILL.md）：用户说「帮我分析这个销售数据」，在开启追踪且判定为复杂任务时，Agent 可自动创建知识库与需求编号，并告知用户。
适用场景与注意¶
适合谁：希望用 Markdown 在本地维护项目文档与需求清单、并让 Cursor / Claude Code / Codex / OpenClaw 等 Agent 在同一套目录规范下续写和汇总状态的个人开发者或小团队（单机文件，非实时协作）。
使用注意：
- 路径授权：Skill 声明只访问用户明确授权的路径；默认知识库在
~/.myknowledge/，项目级为.myknowledge/。备份与同步需自行用 git 或复制目录，Skill 不提供云端同步。 - 平台差异：OpenClaw 可走 Hook；其他环境依赖意图识别，复杂任务自动创建前可能需用户确认（
complex_task_detection.require_confirmation: true）。 - 文档入口：常见问题见 Skill 目录内
FAQ.md，踩坑说明见docs/PITFALLS.md。 - 社区指标：截至资料抓取时，SkillHub 显示评分 100000、下载 943、安装计数 0；页面与 API 入口见文末链接，指标会随时间变化。
结尾¶
MyKnowledge 把「知识库目录 + 需求状态 + 项目快照」固化成 Agent 可执行的本地工作流，适合不想绑云端、又希望会话可恢复的场景。安装与坐标以 SkillHub 为准：
- API 入口：https://api.skillhub.cn/user_48539314/my-knowledge
- SkillHub 页面：https://www.skillhub.cn/skills/user_48539314/my-knowledge
- 安装说明：https://skillhub.cn/install/skillhub.md
许可证：Apache License 2.0（见 Skill 内 SKILL.md）。
