用途:在知识库中创建带标签的笔记,用于捕获知识、想法与思考。当用户提出“create note”“capture thought”“save this”“document idea”“write note”“jot down”“quick note”等请求时使用。
前置条件:需确认 Notes 实体已启用,检查是否存在 .claude/data/notes/meta.yaml(分片模式)或 .claude/data/notes/records.yaml(旧版)。若未找到,建议通过 secondbrain-init 或 secondbrain-entity 启用。
主要流程:
- 收集信息:标题、内容(可来自对话)、可选标签。
- 生成基于日期的 ID:格式 YYYY-MM-DD-<title-slug>,例如 2026-01-15-kubernetes-deployment-patterns。
- 创建笔记文档:文件名为 docs/notes/YYYY-MM-DD-<slug>.md,含 frontmatter(id、title、created、tags、status)与 Summary、Content、References、Related 等分段。
- 更新记录:向当月分片 .claude/data/notes/YYYY-MM.yaml 添加条目,并确保当月已在 meta.yaml 的 shards 列表中注册。
- 侧边栏:不要手动把笔记加入 VitePress 侧边栏,笔记会由 docs/notes/index.md 上的 EntityTable 组件自动列出。
- 确认创建:输出 ID、标题、标签、文件路径。
标签:用于组织与发现笔记,常见维度包括技术(kubernetes、react、python)、领域(architecture、security、performance)、类型(howto、reference、research)、项目(project-x、migration、refactor)。状态值有 active(当前有效)与 archived(不再最新但保留)。
提示:标题要具体;补充上下文说明重要性;多链接相关笔记与外部资源;标签保持一致;定期归档不再相关的笔记。
扩展资料:references/note-formats.md 提供更详细的笔记模板与格式模式。
限制:资料未提供安装方式、收费、价格、平台、支持的语言版本或具体集成细节,相关内容暂未提供。