HARNESS

这个文件定义 jacky-brain 的知识库 harness。

这里的 harness 不是脚本或自动化系统，而是一套让人和 AI 都能稳定使用仓库的文档契约、检查点、反馈循环和维护节奏。

目标

• 让本地 Markdown 成为可靠的长期知识源。
• 让 AI Agent 知道能做什么、不能做什么。
• 让 Notion、Obsidian、GitHub 各自承担清晰角色。
• 让知识库随着使用逐步变好，而不是越用越乱。

五个组成部分

工具编排

• Obsidian：阅读、搜索、双链、回顾。
• GitHub：私有同步和版本管理。
• Notion：快速碎片捕捉和轻量阅读清单。
• Codex / Claude Code / Antigravity：整理、检索、归纳、生成模板化笔记。

护栏约束

• 本地 Markdown 是唯一可信源。
• 不提交 private/。
• 不提交密钥、账号、cookie、私人聊天、商业敏感信息。
• 不把 公众号/ 当作当前创作主线。
• 不把 Notion 变成第二套长期知识库。
• 构建与发布只走白名单管线：jacky-brain-site（Quartz 4）+ GitHub Actions + Cloudflare Pages（2026-09 起，见 AGENTS.md 硬规则）；白名单之外新增任何脚本、CI、自动发布仍需人工确认。

规则分层

规则按加载时机分层，常驻上下文保持轻（源自 Matt Pocock 的 CODING_STANDARDS.md + /code-review 模式，2026-09）：

• 常驻层 AGENTS.md：每次会话都加载，只放任务域导航和硬规则，宁缺毋滥。
• 治理层 docs/知识库治理.md：归类、类型、命名等建笔记时才查的标准。
• 复盘层本文件的检查点：review 型规则只在周/月维护和复盘时执行——review 阶段负载低，指令更容易被遵守。

复盘层的默认姿势：删比加更值得 review（源自”少写代码也是减 slop”，适配笔记库）——维护时优先处理该归档、该合并、该删的内容，其次才是新增。

反馈循环

当出现以下情况时，更新规则：

• AI 被纠正同一类问题两次。
• 某个目录开始反复放错内容。
• Notion 和本地 Markdown 出现重复维护。
• 某类笔记经常不知道该放哪。
• 隐私或同步边界出现风险。

更新位置：

• AI 行为规则：AGENTS.md。
• 日常流程：docs/使用说明.md。
• 结构和类型：docs/知识库治理.md。
• 维护检查点：docs/HARNESS.md。

可观测性

每月体检时关注：

• 新增了哪些主题。
• 哪些主题重复或分散。
• 哪些笔记没有元数据。
• 哪些文件命名不可读。
• 哪些内容可能过时。
• 哪些内容可能包含敏感信息。

人工检查点

以下操作必须先确认：

• 批量移动或重命名文件。
• 批量重写已发布文章。
• 删除内容。
• 把 Notion 大量内容导入本地。
• 修改目录体系。
• 引入新工具、脚本、插件或自动化。
• 处理可能敏感的个人内容。

每周清单

• Notion 是否有同主题碎片值得升格。
• 新增正式笔记是否有 YAML 元数据。
• 按”删比加更值得 review”：有没有该标 archived、该合并或该删的旧内容。
• 本周是否产生了 1-3 条值得沉淀的经验。

每月清单

可以让 AI 执行：

请按 docs/HARNESS.md 对这个知识库做月度体检：找重复主题、命名混乱、孤立笔记、过期信息、值得升格的材料，以及可能误提交的敏感内容。

检查结果应输出：

• 结构问题。
• 高价值主题。
• 建议升格的材料。
• 建议归档的内容。
• 需要人工确认的风险。
• 本月建议更新的规则。

成功标准

• 新内容能快速进入系统，不需要先想复杂分类。
• 高价值内容能从碎片升格为长期笔记。
• AI 能按统一规则创建、整理和维护文档。
• Obsidian 打开后能顺手浏览和回顾。
• GitHub 同步不会带入明显敏感内容。