qmd-knowledge

用途：该技能用于记录与检索项目知识，包括开发中发现的经验、模式、架构决策、约定，以及具体问题的笔记与解决方案，并可查询过往决策与做法，为项目积累可检索的“组织记忆”。\n\n主要能力：统一的知识管理系统，安装一次即可跨项目使用 qmd 集合管理知识；知识按项目存储在 ~/.ai-knowledges/<project-name>/ 下，分为 learnings/（时间戳 markdown，格式 YYYY-MM-DD-topic-slug.md）与 issues/（<issue-id>.md，追加式日志）。提供的 scripts/record.sh 可记录三类内容：learning、issue（可带编号）、note；记录后脚本会自动执行 qmd embed 重建索引，使新内容可被搜索。qmd MCP 服务器支持 AI 助手自主查询与更新知识库，可按集合筛选、用自然语言检索。\n\n使用方式：先做预检，确认已有 bun 或 node、git，并安装 qmd：bun install -g @tobilu/qmd。技能安装到 AI 工具的 skills 目录（OpenCode 为 $HOME/.config/opencode/skills/，Claude Code 为 $HOME/.claude/skills/，Amp 为 $HOME/.config/amp/skills/）。随后为项目建立集合：mkdir -p ~/.ai-knowledges/<project-name>/learnings 与 issues，再执行 qmd collection add ~/.ai-knowledges/<project-name> --name <project-name>、qmd context add qmd://<project-name> "..."、qmd embed。记录命令示例：$SKILL_PATH/scripts/record.sh learning "主题"；$SKILL_PATH/scripts/record.sh issue 123 "备注"；$SKILL_PATH/scripts/record.sh note "备注"。查询可用 qmd search、qmd vsearch、qmd query、qmd get，并支持 -c 指定集合与 --min-score 过滤。项目名自动检测优先级为 QMD_PROJECT 环境变量、git remote URL、git 仓库目录名、当前目录名，可用 export QMD_PROJECT=<name> 覆盖。若手动编辑知识文件，需自行运行 qmd embed 更新索引，否则新内容不会出现在搜索结果中。\n\n适用场景：开发过程中捕获新洞察与最佳实践、持续跟踪或已解决问题、回顾历史决策，以及为项目维护长期上下文。\n\n限制：资料未提供收费、价格、平台支持范围、准确率或效果数据，暂未提供；使用前需自行完成 qmd 与 MCP 服务器配置，且知识可检索性依赖嵌入索引的及时更新。