用途:在 Obsidian 库中管理多笔记研究项目,采用固定四阶段子目录结构,项目位于 projects/(顶层),与知识库 research/ 分离。依赖 doc-obsidian 技能(通过 notesmd-cli 做库 CRUD、qmd 搜索),此为必需前置。
目录结构:projects/{project-slug}/ 下含 _index.md(MOC:状态、组件链接、关联研究)、concept/(问题定义、威胁模型、需求)、research/(组件深挖、技术评估)、design/(架构、API 设计、数据模型)、implementation/(构建计划、代码引用、测试计划)。四阶段始终创建,空目录表示尚未开始。
每次操作前需执行 Step 0:VAULT=$(notesmd-cli print-default --path-only) 与 qmd status;任一失败即停止并提示用户先配置 doc-obsidian。
主要能力与用法:init 用于搭建新项目,将名称转为 kebab-case slug(最长 40 字符),检查是否已存在,创建四个阶段目录,加载模板与 frontmatter schema,生成 _index.md 并重新索引(qmd update && qmd embed)。add 用于添加组件笔记,识别项目与目标阶段(未指定时按内容推断,歧义则询问),生成 slug(最长 60 字符)、查重、写入带 type: project-component 的笔记并更新 _index.md 与索引。status 用于查看项目状态,未指定时列出全部项目,指定时读取 _index.md 与各阶段笔记状态并显示表格与进度。link 用于关联已有研究,可按 qmd vsearch 搜索并过滤 research/ 下分数不低于 0.3 的候选,经用户选择后在 _index.md 的 Linked Research 段落添加 wikilink,不移动文件。promote 用于将研究主题提升为项目,搜索候选、确认、运行 init 与 link,不移动已有笔记。触发均为显式命令(如 create project {name}、project status 等),不自动触发。
限制:不创建自定义阶段或跳过阶段目录;不移动已有研究笔记(只链接);项目必须有 _index.md;变更后必须重新索引;不硬编码库路径;仅在明确项目命令下响应。关于收费、价格、平台等信息暂未提供。