pace-knowledge

Obsidian 知识库笔记管理规则

管理 Obsidian Vault 中 thoughts/ 和 knowledge/ 目录的笔记创建与维护。

Vault 路径：由 PACE_VAULT_PATH 环境变量指定的 Vault 路径

spec.md 的 project-summary 是项目元描述，不是 knowledge/thoughts 笔记的 L0 summary 字段。

SessionStart 自动注入：SessionStart hook 会自动扫描 thoughts/ 和 knowledge/ 目录中与当前项目相关的笔记（通过 frontmatter projects 字段匹配），将 L0 摘要注入到会话上下文中。注入按 kind 分配独立名额：相关知识段 wiki 最多 3 条、knowledge 最多 2 条，未成熟想法段 thoughts 最多 3 条；startup 与 compact 恢复使用同一套名额。

状态体系说明：knowledge/thoughts 笔记使用 discussing/concluded/archived 状态标记（frontmatter status 字段），与 task.md 的 checkbox 状态标记（[ ]/[/]/[x]）是两套独立的含义系统，各自在自身文件类型内使用。

---

thoughts/ 笔记

用途：酝酿中的想法、方案讨论、可行性验证——尚未成熟到进入 PACE 执行阶段。

仓库内 plugin/hooks/templates/knowledge-note.md 是 knowledge/thoughts 笔记的参考模板；实际创建仍按本 skill 的字段要求写入 Obsidian vault。

模板

---
status: discussing
projects: [项目名]
tags: [标签1, 标签2]
summary: "一句话摘要，Home.md 仪表盘显示用"
created: YYYY-MM-DDTHH:mm:ss+08:00
updated: YYYY-MM-DDTHH:mm:ss+08:00
---

# 标题

## 摘要

<!-- L1：关键结论/想法，300-500 tokens -->

- 结论 1
- 结论 2

## 详情

<!-- L2：完整分析过程、对比、推理链 -->

状态流转

状态	含义	流转条件
discussing	酝酿中，尚无定论	创建时默认
concluded	已有结论，可执行或归档	讨论收敛、方案确定
archived	已过时或已被执行吸收	关联 CHG 完成 / 内容过时

规则

• summary 必填，不超过 80 字
• projects 至少关联一个项目名（对应 projects/ 下的目录名）
• 更新内容时同步更新 updated 时间戳
• Home.md 仪表盘查询 status = "discussing" 的笔记

---

knowledge/ 笔记

用途：跨项目可复用的经验、模式、最佳实践——从项目 findings 中提炼的知识沉淀。

模板

---
status: concluded
projects: [来源项目1, 来源项目2]
tags: [标签1, 标签2]
summary: "一句话摘要，Home.md 仪表盘显示用"
created: YYYY-MM-DDTHH:mm:ss+08:00
updated: YYYY-MM-DDTHH:mm:ss+08:00
sources:
  - 来源项目/findings
---

# 标题

## 摘要

<!-- L1：关键结论，300-500 tokens -->

- 结论 1
- 结论 2

## 详情

<!-- L2：完整内容、代码示例、对比表格 -->

规则

• summary 必填，不超过 80 字
• sources 标注知识来源（哪个项目的 findings）
• status 通常为 concluded（已验证的知识）
• 知识过时时更新内容或改 status 为 archived
• Home.md 仪表盘显示所有非 README 的 knowledge/ 笔记