personal-os

适用于 Claude Code 的个人操作系统

此技能帮助你构建一个‘大脑’：一个文本文件（Markdown 格式，可在任何编辑器中阅读）的文件夹，Claude Code 可以在其中存放你交托给它的内容，回顾已做出的决策，并为你准备后续步骤。它会逐步指导你，从最初的简单问题开始，然后提供可供你复制的模板。

阅读原则：首次使用时，请按顺序执行各个步骤。references/ 中的文件包含详细信息和模板。你可以随时查阅它们。

0. 它的用途和你能得到什么

没有记忆，每次与 Claude 的对话都会从零开始。有了大脑，对话变得可丢弃，而文件夹成为记忆：重要的内容都被写入文件，Claude 在响应前会重新读取这些文件。

完成设置后你将获得：

• 一个收件箱（inbox/），你可以将任何原始材料放入其中：会议转录、笔记、复制粘贴的电子邮件、截图。
• 一个按四个类别处理的流程：决策（附带理由）、行动（附带负责人）、新事实、未解决问题。
• 一个日志、决策日志和时间线，这些内容永远不会被重写：只能添加，不能修改。
• 主题卡片（每个项目一个文件）和由一个小脚本重新生成的综合仪表板。
• 专门的代理（摄取、董事会审查、一致性检查、文档撰写、会议准备、决策顾问）和快捷命令（/inbox、/journal……）。
• 一个变更日志文件（CHANGELOG.md），用于说明哪些内容需要报告到外部工具（如 Wiki、工单系统、演示文稿）中。

未经你的同意，不会写入任何内容：Claude 提出建议，你确认，然后它才写入。

1. 先决条件

• Claude Code 已安装并在你的机器上正常工作（终端中可使用 claude 命令）。
• 一个空文件夹，例如 ~/brain。对于这个项目，这将是 Claude 唯一有权写入的区域。
• Python 3 用于视图脚本（可选，无需安装其他任何东西）。
• 一个能打开 Markdown 文件的文本编辑器。建议使用 Git 仓库，因为它允许你回退，但并非必需。

在空文件夹中打开一个终端并运行 claude。

2. 初始访谈

Claude 会依次提出以下七个问题，每次等待你的回答。简短的回答就足够了。以下是 Claude 对每个回答的处理方式。

问题	Claude 的处理方式
1. 用一句话描述你的角色和团队？	填充 CLAUDE.md 中的‘我是谁’部分，以便 Claude 以恰当的方式与你交流。
2. 你当前正在处理的 3 到 5 个项目是什么？	在 05_scope/sheets/ 中为每个项目创建一个主题卡片。
3. 你与哪些人合作最多？（名字、角色）	填充 03_team/directory.md 并准备需要再次确认的名字列表。
4. 你接收哪些类型的材料？（转录、邮件、笔记、截图）	配置 inbox/ 的分类规则以及 Claude 能读取的格式列表。
5. 你的输出需要报告到何处？（Wiki、工单系统、演示文稿）	调整 CHANGELOG.md：每个需要更新的页面对应一行，标明‘添加’或‘替换’。
6. 你用哪种语言写作，以及你希望遵循哪些写作规则？	填充 CLAUDE.md 中的‘风格’部分。
7. 你希望多久进行一次审查？（每天、每周、每次一对一面谈前）	确定首先安装的命令和代理（步骤 5）。

在继续之前，Claude 会用十行左右总结它理解的内容，并等待你的确认。

3. 创建结构

Claude 会提议 references/structure.md 中描述的目录树，并在你确认后创建它。基本文件夹包括：

• inbox/ 和 archive/：原始材料的收件箱及其处理后的存档。
• 00_journal/：日志和时间线（仅追加）。
• 01_steering/：指导，包括任务板。
• 02_product/：关于产品的持久事实。
• 03_team/：人员目录和协作笔记。
• 04_decisions/：决策日志（仅追加）。
• 05_scope/：主题卡片和生成的视图。
• 06_resources/：词汇表、参考文档。
• scripts/：视图脚本。
• .claude/：代理和命令。

黄金法则：一个文件，一个主题，一个中性名称。任何文件都不能以人名命名。与人相关的内容应放入目录中。

接下来，复制 references/templates/ 中的模板，并将方括号中的字段替换为你在步骤 2 中的回答。

4. 编写 CLAUDE.md 指令文件

每次会话，Claude Code 都会自动读取 CLAUDE.md。它包含游戏规则。从 references/templates/CLAUDE.md 模板开始，并确保它至少包含以下内容：

1. 你是谁，以及 Claude 应该如何与你交流。
2. 有新信息到达时 Claude 应该做什么（摄取协议，参见 references/ingestion-rules.md）。
3. 新鲜度规则、仅追加文件、‘一个事实，一个文件’规则。
4. 步骤 9 的安全规则。
5. 你在问题 6 中选择的写作风格。
6. 经常被转录工具扭曲的专有名词列表，随时间逐渐完善。

保持此文件简短：一到两页。详细信息存在于 references/ 中的文件里，Claude 会在需要时读取它们。

5. 添加代理和命令

代理是一个专门的助手，拥有自己的指令和权限。命令是你在 Claude Code 中输入的快捷方式（例如 /inbox）。两者都是 .claude/ 中的简单 Markdown 文件。

从小处开始。首先安装：

• inbox-ingestion 代理和 /inbox 命令（用于处理你放入的内容）；
• /journal 命令（用于快速记录笔记）。

然后，在需要时添加：board-review、consistency-check、deliverables-writer、meeting-prep、decision-advisor，以及 /review-board、/prep-1to1、/propagate 命令。每个角色在 references/agents.md 中有描述，要复制的模板在 references/templates/.claude/ 中。

每次添加后，让 Claude 验证文件是否被读取：输入 /agents 查看列表。

6. 首次尝试：投递一条笔记并处理它

1. 编写或粘贴一条真实笔记（即使很短）到 inbox/ 中，例如 inbox/2026-01-15_point-equipe.txt。
2. 输入 /inbox。
3. Claude 读取文件，标记可疑段落，与现有内容进行交叉检查，并返回一个编号的修改建议列表，每条建议都包含：文件、修改前内容、修改后内容和来源。
4. 回答‘确认 1, 2, 4’或‘全部确认’。如果没有明确回答，则不会写入任何内容。
5. Claude 执行写入，将原始文件移动到 archive/，在 CHANGELOG.md 中记录已完成的操作，并重新运行视图脚本。

完整协议在 references/inbox-processing.md 中。一个包含原始笔记和结果的端到端示例在 references/example-acme/ 中。

7. 日常流程

四个节奏足以开始。

• 每天（5 分钟）。 将到达的内容放入 inbox/，输入 /inbox，确认。一天结束时，输入 /journal 记录一条自由笔记。
• 会议后。 放入转录或你的笔记，输入 /inbox。优先检查决策及其理由，然后是行动及其负责人。
• 每周。 输入 /review-board，然后让 consistency-check 代理检查日期、状态和姓名。重新运行视图脚本。
• 在一对一面谈前。 输入 /prep-1to1 [名字]。meeting-prep 代理会汇总已讨论的内容、待办事项和未解决的问题，并附上每条信息的来源。

8. 演进

• 添加一个主题。 将 references/templates/scope-sheet.md 复制到 05_scope/sheets/，填写字段，然后运行视图脚本。
• 添加一个代理。 从 references/templates/.claude/agents/ 复制一个模板，更改其名称、描述和指令。在实际案例上进行测试后再采用。
• 添加一个视图。 编写或让别人编写一个小脚本，读取卡片并生成一个表格。它只读取，从不修改卡片。脚本 references/scripts/build_views.py 可以作为起点。
• 一个更改影响多个内容。 使用 /propagate（参见 references/use-cases.md 中的用例）。

在添加任何内容之前，问自己四个问题。这能帮助我不丢失决策及其理由吗？这能告诉我每个项目上的下一个行动及其负责人吗？这能减少在不同主题之间切换的努力吗？这会为我的团队留下有用的痕迹吗？如果答案全部是否定的，则不要添加。

9. 安全规则

1. 提议、确认、写入。 Claude 首先展示他打算修改的内容。只有在获得你的明确同意后，他才写入。
2. 绝不捏造。 文本中不存在的决策或行动不会被创建。如果缺少决策理由，则写入‘理由未记录’。
3. 标记疑问。 当某段内容模棱两可，或者某个人名看起来像是转录变形时，Claude 会指出并询问，而不是自行决断。
4. 未经同意不删除任何内容。 除非你要求，否则不会删除任何文件，也不会将其移出预定的流程（收件箱到存档）。
5. 区分事实、承诺和想法。 已完成的内容、你向某人承诺的内容以及你考虑的内容是三种不同的状态。Claude 的建议绝不会被呈现为承诺。
6. 保留来源。 每个重要的行都必须引用其来源（文件、日期）。

检查清单

• claude 在大脑文件夹中启动并读取 CLAUDE.md。
• 步骤 2 的七个问题都已获得回答，并且总结已得到确认。
• 步骤 3 的文件夹已存在，且没有以人名命名的文件。
• 日志、决策日志和时间线在 CLAUDE.md 中被声明为‘仅追加’。
• 新鲜度规则和‘一个事实，一个文件’规则已包含在 CLAUDE.md 中。
• inbox-ingestion 代理和 /inbox 命令出现在 /agents 以及命令列表中。
• 第一次尝试已完整进行：提议、确认、写入、存档、CHANGELOG.md 条目。
• python3 scripts/build_views.py 无错误运行并生成视图。
• 步骤 7 的四个流程已记录在你查阅的某个地方。
• 步骤 9 的安全规则已复制到 CLAUDE.md 中。

技能文件

文件	内容
references/structure.md	推荐的目录树以及每个文件夹的角色
references/ingestion-rules.md	摄取规则，包含前后示例
references/inbox-processing.md	收件箱文件处理协议，完整示例
references/agents.md	六个代理的目录
references/use-cases.md	七个使用场景
references/templates/	要复制的模板（指令、板、注册表、日志、卡片、代理、命令）
references/scripts/build_views.py	视图生成脚本
references/example-acme/	完整的、虚构的示例大脑