BYOAO Guide

常见场景

11 min read

常见场景

展示如何在日常中使用 BYOAO 的真实场景。每个场景在上下文中介绍相关技能。

1. 第一次 Cook — 编译你的笔记

时机： 刚创建知识库，已有一些笔记（导入的或新写的）。

步骤：

  1. 确保知识库在 Obsidian 中打开且 CLI 已启用
  2. 打开 Agent Client 面板
  3. 运行 /prep 丰富笔记的 frontmatter
  4. 运行 /cook 从笔记中编译知识
  5. 审查变更摘要
  6. 按 Cmd+G 查看图谱

预期结果：

  • 为跨笔记提到的人物、项目和产品创建实体页面
  • 为方法、规则和决策创建概念页面
  • 检测到的矛盾被标记等待审查
  • INDEX.base 和 log.md 已更新
  • 摘要显示：“创建了 5 个实体页面，3 个概念页面。标记了 1 个矛盾。”

小贴士：

  • 先在几个核心笔记上运行（用 /cook "主题名"）看看效果
  • 随时重新运行 /cook — 它是增量的（只处理新增/修改的笔记）
  • /cook 之后，运行 /health 检查问题

2. Cook 后整理 — 重新组织知识库

时机： 已运行 /prep，笔记有了 frontmatter，但文件散落在混乱的目录中（采纳已有知识库时常见）。

步骤：

  1. 确保已运行 /prep（agent 需要 type 元数据来决定文件归属）
  2. 运行 /organize 查看目录重组建议
/organize                    # 分析整个知识库
/organize dry-run            # 预览变更但不执行
/organize scope=Projects/    # 聚焦特定文件夹
  1. 审查前后对比摘要 — agent 按操作分组（如 “将 12 个会议笔记移到 Meetings/”）
  2. 批准或调整 — 可以全部接受、全部拒绝或逐个选择
  3. Agent 使用 obsidian move 执行每次移动，自动更新所有 wikilinks

预期结果：

  • 文件按 frontmatter 元数据整理
  • 完整的文件组保持在一起（如 sprint 文件夹中的关联文件不会被拆散）
  • 所有 wikilinks 和反向链接自动更新 — 无断裂引用

小贴士：

  • 先用 dry-run 看看会发生什么变化
  • 用 scope= 逐个文件夹整理，掌控更精细
  • Agent 不会在收益不明确时移动文件 — 默认保守策略

3. 每周回顾 — 保持知识库更新

时机： 写了一周的笔记，想整合到知识库中。

步骤：

  1. 运行 /cook 将本周笔记编译为知识
  2. 运行 /health 审计 agent 页面
/cook
/health

/health 报告什么：

  • 孤立页面（没有连接任何内容）
  • 断裂的 wikilinks（链接到不存在的笔记）
  • 陈旧内容（过时的 agent 页面）
  • Frontmatter 违规
  • 标签分类漂移

后续行动：

  • 孤立页面：决定是否需要连接或归档
  • 断裂链接：修复链接或创建缺失的页面
  • 陈旧内容：下次 /cook 运行时会更新

4. 追踪想法 — 我的思维如何演变的？

时机： 想了解某个概念在笔记中随时间的发展轨迹。

例子： 你几个月来一直在思考 “API 限流”，想看完整脉络。

步骤：

/trace topic="rate limiting"

你会得到：

  • 提及 “rate limiting” 的每条笔记的时间线
  • 识别出的阶段：发现 → 调研 → 决策 → 实施
  • 标记的转折点：“在阅读 System Design Doc 后，你的方法发生了变化”
  • 未闭合的线索：“你探索了令牌桶方案但六月后没有后续”

适用场景：

  • 做决策前 — 看看你已经探索过什么
  • 写复盘时 — 追踪项目的演变
  • 帮新人了解 — “这个决策是这样做出的”

5. 桥接两个主题 — 发现隐藏联系

时机： 怀疑两个主题有关联但说不清楚。

例子： 你分别在做 “支付处理” 和 “用户引导”。它们在知识库中有联系吗？

步骤：

/connect from="payment processing" to="user onboarding"

你会得到：

  • 共同笔记 — 同时讨论两个主题的笔记
  • 共同人物 — 参与两个领域的人
  • 图谱路径 — 两个主题如何通过中间笔记连接（最多 3 跳）
  • 强度评估 — 强、中、弱连接
  • 建议操作 — 具体要链接的笔记、要创建的 hub notes

适用场景：

  • 跨团队协作 — “我的工作和你的有什么联系？”
  • 战略思考 — “这些项目的共同点是什么？”
  • 写作 — “我需要解释 A 和 B 的关系”

如果没找到连接： 这也是有用的结果。说明这两个主题在你的笔记中还没有交集 — 也许应该有，也许不需要。

6. 生成想法 — 接下来该做什么？

时机： 知识库已有大量内容，想获得有创意、可行动的建议。

步骤：

/ideas
/ideas focus="infrastructure"   # 聚焦特定领域

你会得到：

  • 综合想法 — 将两条已有线索组合成新东西
  • 缺口想法 — 知识库暗示需要但尚不存在的东西
  • 连接想法 — 两个应该沟通的人/项目
  • 放大想法 — 将小想法扩大规模
  • 质疑想法 — 挑战知识库中默认的假设

每个想法引用 2+ 条笔记，并附具体下一步。

适用场景：

  • 季度规划 — “我的知识库揭示了什么机会？”
  • 感觉卡住时 — 让知识库建议该做什么
  • 跨领域创新 — 找到不同领域的交集

7. 质疑信念 — 我的想法对吗？

时机： 要做重大决策，想用自己的历史来验证。

例子： 你认为 “我们应该迁移到微服务架构”。

步骤：

/challenge belief="我们应该迁移到微服务架构"

你会得到：

  • 笔记中的支持证据（先公平评估）
  • 反证：矛盾、立场随时间的变化
  • 信念依赖的未陈述假设
  • 缺失的视角（谁的观点不在？）
  • 置信评级：强 / 中 / 弱 / 被反驳

适用场景：

  • 重大决策前 — “我的知识库支持这个吗？”
  • 解决分歧 — “我自己的笔记怎么说的？”
  • 复盘 — “当时的选择对吗？“

8. 检测漂移 — 我做到了我说要做的吗？

时机： 想对比计划和实际执行。

步骤：

/drift                         # 最近 30 天
/drift period=60d              # 最近 60 天
/drift focus="API 迁移"        # 聚焦特定项目

你会得到：

  • 每个意图被分类为：对齐、延迟、漂移、放弃或涌现
  • 模式检测：优先级置换、范围蔓延、目标放弃
  • 涌现工作被识别（未计划但重要的）
  • 需要思考的问题（描述性的，不带评判）

适用场景：

  • Sprint/月末 — “我执行了吗？”
  • 季度回顾 — “我的精力实际去了哪里？”
  • 感觉不堪重负时 — “什么在消耗我的注意力？“

9. 采集网页内容 — 从浏览器到知识库

时机： 在网上阅读文章、研究论文、技术文档或任何与工作相关的内容时。

准备： 为浏览器安装 Obsidian Web Clipper。模板配置参见快速上手 → Web Clipper。

步骤：

  1. 找到一篇值得保存的文章或网页
  2. 高亮关键段落（可选 — 高亮内容会保留在剪藏中）
  3. 点击 Web Clipper 图标 → 剪藏到知识库
  4. 网页以 Markdown 格式保存到 Clippings/ 文件夹，自动带有 frontmatter
/cook
  1. 下次 /cook 运行时，AI 会读取你的剪藏和自有笔记
  2. 剪藏内容中的实体、概念和关联被编译到知识库中

预期结果：

  • 剪藏的文章与手写笔记一样被当作源材料处理
  • 文章中提到的人物、公司和概念会生成实体/概念页面
  • 编译页面的 sources 字段链接回原始剪藏
  • 剪藏内容与已有知识之间的矛盾会被标记

小贴士：

  • 在 Web Clipper 中为不同网站设置自动匹配规则（文章、论文、食谱等）
  • 大胆剪藏 — /cook 是增量的，新剪藏会在下次运行时处理
  • 使用高亮标记最重要的段落；重新访问网页时高亮仍然可见

建立节奏

以下节奏效果不错：

频率操作技能
每天写日记，记录会议和想法—
浏览时将有用的文章和参考资料剪藏到知识库Web Clipper
每周编译笔记和剪藏，审计健康/cook + /health
cook 后按需整理目录结构/organize
好奇时追踪某个主题的演变/trace
每季度生成想法，回顾漂移/ideas + /drift
重大决策前压力测试假设/challenge
需要时桥接正在做的两个主题/connect

目标不是每天运行所有技能。自由写作，每周编译，每季度反思。

Backlinks