项目资料整理与知识库文档沉淀

解决什么问题

在 Claude Code 里推进项目时，进度、决策、开放问题和下一步常散落在终端输出、提交记录、临时讨论和既有文档中。即使已有 Obsidian vault，也缺少低摩擦入口：会话开始不知道读哪篇项目笔记，进行中的进展未沉淀，收尾时少有人记得把阻塞、结论和 next steps 写回知识库。这个技能面向已用 Obsidian 管理资料、并希望把 Claude Code 工作流与结构化笔记连接起来的场景，用于降低手动整理成本。

工作方式

触发点分三类，但只走两条路径：

• 新会话开始：Claude Code 启动或用户打招呼时进入 Path A，只装载上下文，不启动 agent，不写 vault。
• 会话中记录：出现 “document this”“update notes”“track progress” 等指令时进入 Path B，执行完整文档整理。
• 会话收尾：出现 “wrap up”“close out”“we're done for today” 等时也进入 Path B。

执行前加载 ~/.claude/obsidian-project-assistant-config.json；首次运行询问 vault 路径并写入配置。Path A 用 git repo 名或目录名识别项目，读取对应 vault 笔记，并在存在时读取 CLAUDE.md，随后简短总结当前阶段/状态、上次记录的下一步、值得提示的决策或开放问题。它被限制为只读，避免打招呼时误改文档。

Path B 先检测上下文：优先从用户消息取项目名；否则尝试 git repo 名，如把 obsidian-project-assistant 转为 Obsidian Project Assistant；再退回目录名。若得到 src、build、test 这类泛化名称，或项目域检测有歧义，会先澄清，而不是写入错误笔记。简介会从 README.md 首段、package.json 的 description 或用户消息中提取。之后技能将 vault_path、project_name、area、description、cwd、current_date、auto_commit、auto_push、git_enabled、user_original_message 交给 obsidian-project-documentation:manager agent 写入 vault，完成后再报告结果。

适用边界与注意点

它依赖可访问的 vault 和正确配置，不是任意路径下的通用记事器。Path A 必须只读；Path B 才允许写 vault。识别失败时会在启动 agent 前询问用户，因此可能多一轮确认。git 行为由 auto_commit、auto_push、git_enabled 控制，提交失败时仍应创建或更新笔记。模板缺失时退化到基础模板或提示重装；文件操作要求绝对路径，时间戳使用当前日期。它适合持续沉淀单项目进展与交接信息，但不替代仓库结构、知识分类和团队文档规范。