@our2ndbrain/cli 2026.4.4 → 2026.4.5

package/README.md

@@ -1,845 +1,108 @@
 # 🧠 2ndBrain
 
-> 一套融合 [PARA](#para)、[C-O-R-D](#cord) 工作流与 [Append-and-Review](#append-and-review) 笔记法的个人知识管理方法论。
+> 面向 AI Agent 与人类协作者的轻量入口：用 2ndBrain 模板、CLI 和 Skill 搭建一个可协作的 Obsidian 知识库。
 
 [简体中文](README.md) | [English](README_en.md)
 
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![npm version](https://img.shields.io/npm/v/@our2ndbrain/cli.svg)](https://www.npmjs.com/package/@our2ndbrain/cli)
 
-## ✨ 这是什么？
+## 这是什么
 
-**2ndBrain** 是一套个人知识管理方法论，融合了 **[PARA](#para)** 组织架构、**[C-O-R-D](#cord)** 工作流与 **Karpathy 的 [Append-and-Review](#append-and-review)** 笔记法——**先记下来，回顾时再整理**，让系统自动汇总任务到看板，你只需专注记录和执行。
+如果你要把这个仓库交给 AI Agent，这份 README 应该是它的第一入口。
 
-> 🛠️ **关于工具**：方法论与工具分离。本仓库提供基于 [Obsidian](https://obsidian.md/) 的开箱即用模板——它本地优先、插件生态丰富，是当前性价比很高的选择。所有数据都是纯文本 Markdown，随时可迁移到任何你喜欢的工具。
+2ndBrain 提供三样东西：
 
-核心思路很简单：
+- 一个基于 Obsidian 的知识库模板，用来承载 PARA 目录、收集箱和看板
+- 一个 CLI，用来初始化、更新和检查知识库环境
+- 一个 2ndBrain Skill，用来指导 AI 记录、整理、回顾和处理内容
 
-- 📥 **先记下来再说**——所有输入先进收集箱，别打断你的心流
-- 🏷️ **打个标签就行**——让任务能被系统"抓住"，不会石沉大海
-- 📋 **看板帮你选**——回顾时一目了然，不用靠脑子记
-- ✅ **只做下一步**——避免选择瘫痪，做完一件是一件
+这份 README 只保留 AI 协作所需的最小信息。更完整的方法论、目录约定、CLI 参考和架构说明见 [详细指南](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/docs/guide.md)。
 
-## 📖 目录
+## Quick Start
 
-- [快速开始](#-快速开始)
-- [团队协作](#-团队协作)
-- [工作流程](#-工作流程-c-o-r-d)
-- [任务约定](#-任务约定)
-- [目录结构](#-目录结构-para)
-- [核心入口](#-核心入口)
-- [Obsidian 插件配置](#-obsidian-插件配置)
-- [CLI 命令参考](#-cli-命令参考)
-- [Obsidian CLI](#-obsidian-cli)
-- [AI 助手指南](#-ai-助手指南)
-- [架构说明](#-架构说明)
-- [延伸阅读](#-延伸阅读)
-- [贡献指南](#-贡献指南)
-
-## 🚀 快速开始
-
-### 安装
-
-推荐使用 **npx**（无需安装）：
+推荐直接使用 `npx`：
 
 ```bash
+npx @our2ndbrain/cli@latest check
 npx @our2ndbrain/cli@latest init my-brain
 cd my-brain
+npx @our2ndbrain/cli@latest member Alice
 ```
 
-或全局安装：
+如果你已经全局安装过 CLI，也可以使用：
 
 ```bash
-npm install -g @our2ndbrain/cli
+2ndbrain check
 2ndbrain init my-brain
-```
-
-### 初始化你的知识库
-
-```bash
-# 1. 创建项目（如已全局安装，直接用 2ndbrain 命令）
-npx @our2ndbrain/cli@latest init my-brain
 cd my-brain
-
-# 2. 添加你的成员目录
-npx @our2ndbrain/cli@latest member yourname
-
-# 3. 用 Obsidian 打开 my-brain 目录，开始使用
-```
-
-<details>
-<summary><strong>🤖 让 AI 助手帮你设置</strong></summary>
-
-把下面这段话粘贴给任何 AI 助手（Claude、ChatGPT、Cursor 等）：
-
-```
-帮我设置 2ndBrain 知识管理系统，按照这个文档操作：
-https://raw.githubusercontent.com/Our2ndBrain/2ndBrain-Template/main/README.md
-```
-
-</details>
-
-<details>
-<summary><strong>📋 已有知识库？一键集成 2ndBrain</strong></summary>
-
-如果你已有 Obsidian 知识库，可以直接运行：
-
-```bash
-# 进入你的现有知识库目录
-cd my-existing-vault
-
-# 运行 init 命令，它会智能合并框架文件
-npx @our2ndbrain/cli@latest init
+2ndbrain member Alice
 ```
 
-**集成模式特性**：
-- ✅ 只创建缺失的框架文件和目录
-- ✅ 智能合并 `.obsidian/` 配置，保留你的插件设置
-- ✅ 从不修改你的个人数据（20_Areas、30_Projects 等）
-- ✅ 自动检测并跳过已存在的内容
+## 初始化知识库
 
-</details>
-
-<details>
-<summary><strong>🔧 For LLM Agents（AI 助手详细指南）</strong></summary>
-
-如果你是帮助用户设置 2ndBrain 的 AI 助手，请按以下步骤操作：
-
-#### 第一步：确认并安装前置条件
-
-**1. 检查 Node.js**
+### 新建一个 2ndBrain 仓库
 
 ```bash
-# 检查 Node.js 是否可用（需要 v18+）
-node --version
-
-# 如果未安装，引导用户安装：
-# macOS: brew install node
-# Windows: 从 https://nodejs.org/ 下载 LTS 版本
-# Linux: sudo apt install nodejs npm  # Debian/Ubuntu
-```
-
-**2. 检查并安装 Obsidian**
-
-```bash
-# 检测用户操作系统
-case "$(uname -s)" in
-  Darwin)
-    # macOS
-    if [ ! -d "/Applications/Obsidian.app" ]; then
-      echo "未检测到 Obsidian，正在引导安装..."
-      echo "请访问 https://obsidian.md/ 下载 macOS 版本"
-      echo "或使用 Homebrew Cask: brew install --cask obsidian"
-    fi
-    ;;
-  Linux*)
-    # Linux
-    if ! command -v obsidian &> /dev/null; then
-      echo "未检测到 Obsidian，正在引导安装..."
-      echo "请访问 https://obsidian.md/ 下载 AppImage 版本"
-      echo "或使用包管理器:"
-      echo "  Arch: sudo pacman -S obsidian"
-      echo "  Fedora: sudo dnf install obsidian"
-    fi
-    ;;
-  MINGW*|MSYS*|CYGWIN*)
-    # Windows
-    if ! powershell -Command "Get-AppxPackage -Name 'Obsidian.MD'" &> /dev/null; then
-      echo "未检测到 Obsidian，正在引导安装..."
-      echo "请访问 https://obsidian.md/ 下载 Windows 版本"
-      echo "或使用 winget: winget install Obsidian.MD.Obsidian"
-    fi
-    ;;
-esac
-```
-
-**为 AI 助手提供的 Obsidian 安装命令参考**：
-
-| 操作系统 | 安装方法 | 命令 |
-|---------|---------|------|
-| macOS | Homebrew | `brew install --cask obsidian` |
-| macOS | 手动下载 | 访问 https://obsidian.md/ |
-| Windows | winget | `winget install Obsidian.MD.Obsidian` |
-| Windows | 手动下载 | 访问 https://obsidian.md/ |
-| Arch Linux | pacman | `sudo pacman -S obsidian` |
-| Fedora | dnf | `sudo dnf install obsidian` |
-| Debian/Ubuntu | AppImage | 从官网下载 AppImage |
-| 其他 Linux | AppImage | 访问 https://obsidian.md/ |
-
-**检测和安装脚本**：
-```bash
-# macOS 检测
-if [ ! -d "/Applications/Obsidian.app" ]; then
-  echo "安装 Obsidian: brew install --cask obsidian"
-fi
-
-# Windows 检测
-winget list | findstr Obsidian || echo "安装 Obsidian: winget install Obsidian.MD.Obsidian"
-
-# Linux 检测
-command -v obsidian || echo "请从 https://obsidian.md/ 下载 AppImage"
-```
-
-#### 第二步：初始化项目
-
-```bash
-# 使用 CLI 初始化项目
+npx @our2ndbrain/cli@latest check
 npx @our2ndbrain/cli@latest init my-brain
 cd my-brain
+npx @our2ndbrain/cli@latest member Alice
 ```
 
-#### 第三步：初始化用户成员目录
-
-```bash
-# 询问用户的名字（用于创建个人收集箱）
-# 假设用户名为 "Alex"
-npx @our2ndbrain/cli@latest member Alex
-```
-
-这会创建：
-- `10_Inbox/Alex/00_To-Do.md` - 个人待办清单（Append-only）
-- `10_Inbox/Alex/01_Tasks.md` - 个人任务看板
-- `10_Inbox/Alex/09_Done.md` - 个人完成记录
-- `.obsidian/daily-notes.json` - 配置日记保存到该成员目录
-
-#### 第四步：验证设置
-
-检查以下文件存在：
-
-```bash
-ls -la 00_Dashboard/01_All_Tasks.md
-ls -la 10_Inbox/*/00_To-Do.md
-ls -la 10_Inbox/*/01_Tasks.md
-ls -la 99_System/Templates/tpl_daily_note.md
-```
-
-#### 第五步：引导用户使用 Obsidian 打开
-
-告诉用户：
-1. 打开 Obsidian 应用
-2. 选择「打开本地仓库」（Open folder as vault）
-3. 选择刚才创建的 `my-brain` 目录
-4. 点击「信任作者并启用插件」（Trust author and enable plugins）
-   > 插件已预装，只需信任即可，无需手动安装
-
-#### 第六步：创建第一篇日记
-
-引导用户：
-1. 按 `Cmd/Ctrl + P` 打开命令面板
-2. 搜索「Daily notes: Open today's daily note」
-3. 写下第一条待办：`- [ ] 探索 2ndBrain 系统 #next`
-
-#### 完成确认
-
-向用户展示：
-- 打开 `00_Dashboard/01_All_Tasks.md` 看看任务看板效果
-- 打开 `10_Inbox/{用户名}/01_Tasks.md` 看看个人看板
-
-#### 注意事项
-
-- 阅读本文档的 [AI 助手指南](#-ai-助手指南) 了解项目约定
-- 所有任务使用格式：`- [ ] 任务描述 #标签 📅 日期`
-- 日记使用模板 `99_System/Templates/tpl_daily_note.md`
-
-</details>
-
-### 首次使用清单
-
-- 用 Obsidian 打开模板
-- 确认插件已启用（Settings → Community plugins）
-- 创建第一篇日记
-- 打开 `00_Dashboard/01_All_Tasks.md` 看看效果
-
-## 👥 团队协作
-
-多人共用一个 2ndBrain 仓库？用 Git 同步：
-
-### 初始化 Git 仓库
-
-```bash
-cd my-brain
-git init
-git add .
-git commit -m "🎉 init: 从 2ndBrain Template 开始"
-
-# 推送到远程仓库（GitHub/GitLab 等）
-git remote add origin <your-repo-url>
-git push -u origin main
-```
-
-### 添加新成员
-
-每个成员需要创建自己的目录：
-
-```bash
-# 成员 Alice 加入
-npx @our2ndbrain/cli@latest member Alice --no-config
-
-# 成员 Bob 加入
-npx @our2ndbrain/cli@latest member Bob --no-config
-```
-
-> 💡 `--no-config` 选项不会修改 `.obsidian/daily-notes.json`，避免覆盖其他成员的配置。每个成员在本地手动配置自己的日记目录。
-
-### 自动同步
-
-安装 [Obsidian Git](https://github.com/denolehov/obsidian-git) 插件，自动备份和同步：
-
-- 自动保存间隔：60 秒
-- 启动时自动拉取：开启
-- 文件变更后自动备份：开启
-
-### 本地配置（不同步）
-
-每个成员的 `.obsidian/daily-notes.json` 配置可能不同，建议将 `.obsidian/` 目录加入 `.gitignore`，或者只同步插件配置而不同步个人设置。
-
-## 🔄 工作流程 (C-O-R-D)
-
-四个字：**收集 → 整理 → 回顾 → 执行**。像流水线一样，让想法变成行动。
-
-C-O-R-D 是 [GTD (Getting Things Done)](#gtd) 的现代轻量演进——保留核心精髓，去掉繁琐仪式。GTD 的「收集-处理-组织-回顾-执行」五步被简化为更符合直觉的四步：两分钟能解决的事立刻做，解决不了就扔进收集箱；利用碎片时间分类处理——马上做、交给别人、或过段时间再说。**每天把收集箱清零**，就像睡觉清空腺苷，第二天轻装上阵。
-
-> 💬 *我不忙，我只是时间不够。*
-
-### 1️⃣ 收集 (Collect)
-
-**记录归记录，任务归任务。**
-
-- **想法、灵感、反思** → 写在今天的日记 `## Thoughts` 区
-- **待办任务** → 追加到 `10_Inbox/{你的名字}/00_To-Do.md` 的 `## Inbox` 区
-
-这是 **[Append-and-Review](#append-and-review)** 的核心实践：**先记下来，不打断思考流程**。通过 Obsidian CLI 可以从终端快速捕获：
-
-```bash
-# 追加想法到日记
-obsidian daily:append content="刚想到一个新点子..."
-
-# 追加任务到 To-Do（自动落入 Inbox 区域）
-obsidian append file="00_To-Do" content="- [ ] 新任务 📅 2026-04-05"
-```
-
-> 💡 **两分钟法则**：能立刻做完的就别记了，直接做掉。
-
-### 2️⃣ 整理 (Organize)
-
-定期整理 To-Do 文件，让任务能被"找到"：
-
-- 打个标签：`#next`（马上做）/ `#waiting`（等别人）/ `#someday`（以后再说）
-- 有截止日期的，加上 `📅 2026-01-15`
-- 把 `## Inbox` 中的任务移到对应项目的 Heading 下
-- 新项目？在 To-Do 文件中添加 `## 项目名` Heading，并链接到 `30_Projects/`
-- 长期关注的话题？相关笔记移到 `20_Areas/`
-- 参考资料？放到 `40_Resources/`
-
-**实际例子**：
-- To-Do 的 Inbox 中写了"重构公司官网"→ 在 To-Do 中新增 `## 网站重构` Heading，创建 `30_Projects/网站重构/` 项目文件夹
-- 日记中记录了"基金定投策略"→ 移到 `20_Areas/理财/基金定投.md`
-- 日记中收藏了"番茄工作法"→ 整理到 `40_Resources/效率工具/番茄工作法.md`
-
-> 💡 **养成习惯**：新任务至少打个标签或日期，不然就会变成"未分类黑洞"。
->
-> 💡 **每周翻翻** `#someday`，捞 1-2 个变成 `#next`，别让手头事太多。
-
-### 3️⃣ 回顾 (Review)
-
-**日记即看板**——打开今天的日记，`## To-Do` 区会自动展示：
-- 今日到期的任务
-- 过期未完成的遗留任务
-
-按项目 Heading 分组显示，一目了然。需要全景视图？打开个人看板 `01_Tasks.md`：
-- **立即行动**：没分类的任务，赶紧处理或打标签
-- **今日必达**：今天到期的，优先搞定
-- **等待跟进**：在等别人的 `#waiting` 任务
-- **下一步行动**：标了 `#next` 的，随时可以开干
-- **未来计划**：还没到期的任务，以及所有 `#someday` 标签的任务
-- **阅读清单**：想看的文章、书籍
-
-> 💡 **每天**至少看一眼日记看板。
->
-> 💡 **每周**看看 `09_Done.md` 回顾成就感；顺便清理一下项目，不活跃的挪到 `90_Archives/`。
-
-### 4️⃣ 执行 (Do)
-
-只做 `#next` 或到期的任务，做完就勾掉。
-
-> 🎯 **核心心法**：不是所有事都要做完，只做"下一步"就够了。
-
-## 📝 任务约定
-
-### 怎么写任务？
-
-```markdown
-- [ ] 任务描述 #标签 📅 2026-01-08
-```
-
-完成后 Tasks 插件会自动加上 `✅ 2026-01-08`，方便回顾。
-
-### 标签速查
-
-| 标签 | 意思 | 什么时候用 |
-|------|------|------------|
-| `#next` | 下一步要做 | 随时可以开工的任务 |
-| `#waiting` | 等别人 | 球在别人那儿 |
-| `#someday` | 以后再说 | 想做但不急 |
-| `#read` | 要读的 | 文章、书籍等文字内容 |
-| `#watch` | 要看的 | 视频、课程等视觉内容 |
-| `#listen` | 要听的 | 播客、音频等听觉内容 |
-| `📅 YYYY-MM-DD` | 截止日期 | 必须在某天前完成 |
-
-### To-Do 文件结构
-
-每个成员的待办清单 `00_To-Do.md` 用 Headings 分区管理：
-
-- `## Readings`：阅读/观看/收听清单（位于上方固定区域）
-- `## 项目名`：项目相关任务，用 blockquote 链接到 `30_Projects/`
-- `## Inbox`：新任务的默认着陆区（**位于文件最底部**，适配 CLI append）
-
-日记模板包含两个区域：
-
-- `## To-Do`：动态查询，展示今日到期 + 过期任务（按项目 Heading 分组）
-- `## Thoughts`：想法/灵感/反思（日记的主体）
-
-## 📁 目录结构 (PARA)
-
-```
-2ndBrain/
-├── 00_Dashboard/          # 看板：任务聚合、进度回顾
-│   ├── 01_All_Tasks.md    #   全局任务看板
-│   └── 09_All_Done.md     #   全局完成记录
-├── 10_Inbox/              # 收集箱：日记落这儿（单一收集点）
-│   ├── Agents/            #   AI 助手共享工作区
-│   │   └── Journal.md     #     Agent 工作日志（append-and-review）
-│   └── {成员名}/          #   每个人类成员一个子目录
-│       ├── 00_To-Do.md    #     个人待办清单（Append-only, Inbox 在底部）
-│       ├── 01_Tasks.md    #     个人任务看板（查询视图）
-│       ├── 09_Done.md     #     个人完成记录
-│       └── 2026-01-14.md  #     日记（想法 + 今日看板）
-├── 20_Areas/              # 领域：长期关注的事（健康、财务…）
-├── 30_Projects/           # 项目：有明确目标的事
-├── 40_Resources/          # 资源：参考资料、方法论
-├── 90_Archives/           # 归档：完成或不再活跃的
-└── 99_System/             # 系统：模板、脚本和配置
-    ├── Scripts/           #   自动化脚本
-    └── Templates/         #   笔记模板
-```
-
-### 东西往哪放？
-
-**决策流程**：所有内容先放 `10_Inbox/`（日记），回顾时再决定归属。
-
-| 分类 | 放这里 | 实际例子 | 别放这儿 |
-|------|--------|----------|----------|
-| **项目** | `30_Projects/项目名/` | `30_Projects/网站重构/` - 有明确目标<br>`30_Projects/年度报告/` - 有截止日期 | 零散想法、临时待办（先放日记） |
-| **领域** | `20_Areas/领域名/` | `20_Areas/理财/基金定投.md` - 长期关注<br>`20_Areas/健康/运动记录.md` - 持续维护 | 已经完成的项目（应归档） |
-| **资源** | `40_Resources/分类/` | `40_Resources/效率工具/番茄工作法.md` - 方法论<br>`40_Resources/书单.md` - 参考资料 | 需要持续维护的事（应放领域或项目） |
-| **归档** | `90_Archives/` | 完成的项目、不再关注的领域 | 还在进行中的任务 |
-| **收集箱** | `10_Inbox/{成员}/` | `10_Inbox/G/2026-01-14.md` - 所有新内容先放这里 | 已整理好的内容（应移到对应目录） |
-
-**判断标准**：
-- **有明确目标和截止日期** → `30_Projects/`
-- **需要长期维护但没有截止日期** → `20_Areas/`
-- **参考资料、工具、方法论** → `40_Resources/`
-- **不确定放哪** → 先放 `10_Inbox/`，回顾时再决定
-
-## 🎯 核心入口
-
-| 文件 | 干嘛用 |
-|------|--------|
-| `00_Dashboard/01_All_Tasks.md` | 全局任务看板，汇总所有成员的待办 |
-| `00_Dashboard/09_All_Done.md` | 全局完成记录，回顾团队成就 |
-| `10_Inbox/{成员}/00_To-Do.md` | 个人待办清单，所有任务写在这里 |
-| `10_Inbox/{成员}/01_Tasks.md` | 个人任务看板，每天看这个 |
-| `10_Inbox/{成员}/09_Done.md` | 个人完成记录，回顾成就感 |
-| `10_Inbox/Agents/Journal.md` | Agent 工作日志，记录 AI 助手的工作 |
-| `99_System/Templates/tpl_daily_note.md` | 日记模板（想法 + 今日看板） |
-
-## 🔌 Obsidian 插件配置
-
-本模板已预装以下插件，初始化时自动包含在 `.obsidian/plugins/` 目录中，打开项目后信任作者即可启用：
-
-### 预装插件
-
-| 插件 | 用途 | 仓库 |
-|------|------|------|
-| **Tasks** | 任务过滤和聚合，支持标签、日期、循环任务等 | [obsidian-tasks-plugin](https://github.com/obsidian-tasks-group/obsidian-tasks) |
-| **Calendar** | 日历视图，点击日期快速跳转到对应日记 | [obsidian-calendar-plugin](https://github.com/liamcain/obsidian-calendar-plugin) |
-| **Git** | 自动备份到 Git 仓库，支持自动提交和拉取 | [obsidian-git](https://github.com/denolehov/obsidian-git) |
-| **Custom Attachment Location** | 自动将附件整理到笔记同名目录 | [obsidian-custom-attachment-location](https://github.com/RainCat1998/obsidian-custom-attachment-location) |
-
-### 手动安装插件
-
-模板预装插件已足够使用，如需额外功能可手动安装：
-
-```bash
-# 社区插件需要在 Obsidian 设置中先启用「社区插件」浏览功能
-# 设置 → Community plugins → Turn on community plugins
-```
-
-推荐的额外插件：
-- [Dataview](https://github.com/blacksmithgu/obsidian-dataview) - 高级数据查询，可创建动态看板
-- [Advanced Tables](https://github.com/tgrosinger/advanced-tables-obsidian) - 增强 Markdown 表格编辑
-
-### 插件配置参考
-
-<details>
-<summary>点击展开配置详情</summary>
-
-**Git 插件**
-- 自动保存间隔：60 秒
-- 启动时自动拉取：开启
-- 文件变更后自动备份：开启
-- 提交信息格式：`vault backup: {{date}}`
-
-**Calendar 插件**
-- 每周起始日：跟随系统
-- 每点代表字数：250
-
-**Custom Attachment Location 插件**
-- 附件路径：`./assets/${noteFileName}`
-- 附件命名：`file-${date:YYYYMMDDHHmmssSSS}`
-
-**Tasks 插件**
-- 全局任务过滤器：可在设置中自定义默认过滤条件
-
-</details>
-
-## 🔧 CLI 命令参考
-
-2ndBrain 提供命令行工具来管理项目：
+### 集成到已有 Obsidian vault
 
 ```bash
-# 全局安装（可选）
-npm install -g @our2ndbrain/cli
-
-# 或使用 npx 直接运行
-npx @our2ndbrain/cli@latest <command>
-```
-
-### 命令列表
-
-| 命令 | 说明 |
-|------|------|
-| `2ndbrain init [path]` | 初始化新项目（或集成到已有知识库） |
-| `2ndbrain member <name> [path]` | 添加成员目录 |
-| `2ndbrain update [path]` | 更新框架文件（看板、模板等） |
-| `2ndbrain remove [path]` | 移除框架文件 |
-| `2ndbrain completion <shell>` | 生成 shell 补全脚本 |
-
-### 更新框架文件
-
-当模板有新版本时，可以使用 `update` 命令更新框架文件（看板、模板、脚本、文档等），同时保留你的个人数据不变。
-
-**框架文件包括**：
-- 文档：`AGENTS.md`、`README.md`、`CHANGELOG.md`、`CLAUDE.md`
-- 看板：`00_Dashboard/01_All_Tasks.md`、`00_Dashboard/09_All_Done.md`
-- 模板：`99_System/Templates/` 下的所有模板（含 `tpl_member_todo.md`）
-- 脚本：`99_System/Scripts/` 下的所有脚本
-- 配置：`.obsidian/` 目录（插件配置，智能合并）
-
-```bash
-# 1. 先预览将要更新的文件
-npx @our2ndbrain/cli@latest update --dry-run
-
-# 2. 确认无误后执行更新
-npx @our2ndbrain/cli@latest update
-```
-
-更新过程中会显示差异预览，你可以选择：
-- **全部更新**：一次性更新所有框架文件
-- **逐个审查**：每个文件单独确认是否更新
-- **跳过**：取消本次更新
-
-> 💡 **重要说明**：`update` 命令只会更新框架文件（看板、模板、脚本等），**不会修改**你的个人数据目录（20_Areas、30_Projects、40_Resources、90_Archives）和成员日记。
-
-### 常用选项
-
-**init**
-- `-f, --force`：强制覆盖已存在的项目
-- `--reset-obsidian, --reset-obs`：完全重置 .obsidian 目录（覆盖所有配置）
-- `-t, --template <path>`：使用自定义模板目录
-
-### init 命令模式
-
-`init` 命令支持两种模式：
-
-1. **全新初始化**：在空目录创建完整项目
-2. **集成模式**：在已有知识库中智能合并框架文件
-
-```bash
-# 全新初始化
-mkdir my-brain && cd my-brain
-npx @our2ndbrain/cli@latest init
-
-# 集成到已有知识库
 cd my-existing-vault
+npx @our2ndbrain/cli@latest check
 npx @our2ndbrain/cli@latest init
+npx @our2ndbrain/cli@latest member Alice
 ```
 
-**集成模式会**：
-- 只创建缺失的框架目录（00_Dashboard、10_Inbox、99_System）
-- 跳过已存在的用户数据目录（20_Areas、30_Projects 等）
-- 智能合并 .obsidian/ 配置，保留你的插件设置
-- 添加缺失的框架文件（看板、模板、文档）
-
-**member**
-- `-f, --force`：强制覆盖已存在的成员目录
-- `--no-config`：不更新 Obsidian daily-notes 配置（团队协作时使用）
+初始化完成后，让用户：
 
-**update**
-- `-d, --dry-run`：预览将要更新的文件，不实际执行
-- `-t, --template <path>`：使用自定义模板目录
-- `-y, --yes`：自动确认所有更新，跳过交互式确认
+1. 用 Obsidian 打开刚创建或集成后的目录。
+2. 点击“Trust author and enable plugins”。
+3. 创建第一篇日记，开始记录任务和想法。
 
-**remove**
-- `-d, --dry-run`：预览将要移除的文件，不实际执行
-- `-f, --force`：跳过确认直接移除
+## 安装 Skill
 
-### 命令补全
-
-启用 Tab 补全，让命令输入更便捷：
+推荐使用 SSH git URL 形式安装这个仓库中的 `2ndbrain` Skill：
 
 ```bash
-# Bash
-echo 'source <(2ndbrain completion bash)' >> ~/.bashrc
-
-# Bash (macOS 使用文件方式，因为 bash 3.x 不支持 source <(...))
-2ndbrain completion bash > ~/.2ndbrain-completion.bash
-echo 'source ~/.2ndbrain-completion.bash' >> ~/.bash_profile
-source ~/.bash_profile
-
-# Zsh
-echo 'source <(2ndbrain completion zsh)' >> ~/.zshrc
-source ~/.zshrc
-
-# Fish
-2ndbrain completion fish > ~/.config/fish/completions/2ndbrain.fish
+npx skills add git@github.com:Our2ndBrain/2ndBrain-Template.git --skill 2ndbrain
 ```
 
-重新打开终端或执行 `source ~/.bashrc`（或对应 shell 配置文件）即可生效。
-
-## 🖥️ Obsidian CLI
-
-Obsidian v1.12.4+ 内置了官方命令行工具，可以从终端直接操作你的知识库。需要 Obsidian 处于运行状态。
-
-### 安装
-
-1. 更新 Obsidian 到 v1.12.4 或更高版本
-2. Settings → General → Command line interface → 启用
-3. 按照提示将 CLI 注册到系统 PATH
+按目标 Agent 安装时，可以显式指定：
 
-<details>
-<summary><strong>分平台 PATH 配置</strong></summary>
-
-**macOS**（zsh）：
-```bash
-echo 'export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"' >> ~/.zshrc
-source ~/.zshrc
-```
-
-**macOS**（bash）：
 ```bash
-echo 'export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"' >> ~/.bash_profile
-source ~/.bash_profile
-```
-
-**Windows**：
-```
-# 系统设置 → 环境变量 → Path → 新增
-C:\Users\{用户名}\AppData\Local\Programs\Obsidian\
+npx skills add git@github.com:Our2ndBrain/2ndBrain-Template.git --skill 2ndbrain -a claude-code
+npx skills add git@github.com:Our2ndBrain/2ndBrain-Template.git --skill 2ndbrain -a cursor
+npx skills add git@github.com:Our2ndBrain/2ndBrain-Template.git --skill 2ndbrain -a openclaw
 ```
 
-**Linux**：
-```bash
-sudo ln -s /opt/obsidian/obsidian /usr/local/bin/obsidian
-```
-
-</details>
-
-### 与 2ndBrain 配合使用
-
-| 场景 | 命令 |
-|------|------|
-| 追加任务到 To-Do | `obsidian append file="00_To-Do" content="- [ ] 新任务 📅 2026-04-05"` |
-| 追加想法到日记 | `obsidian daily:append content="刚想到一个点子..."` |
-| 查看今日日记 | `obsidian daily:read` |
-| 列出所有任务 | `obsidian tasks format=json` |
-| 搜索仓库 | `obsidian search query="关键词"` |
-| 浏览仓库（TUI 模式） | `obsidian` |
-
-> 💡 **CLI 限制**：`append` 只能追加到文件末尾，这就是为什么 To-Do 文件把 `## Inbox` 放在最底部——新任务通过 CLI 追加后自然落入 Inbox 区域。
-
-### AI Agent 集成
-
-Obsidian CLI 让 AI Agent 能够通过标准命令操作你的知识库：
-
-```bash
-# AI Agent 可以通过 CLI 协助管理任务
-obsidian append file="00_To-Do" content="- [ ] AI 建议：整理本周会议笔记 📅 2026-04-07"
-obsidian tasks format=json  # 读取任务列表进行分析
-obsidian search query="[tag:next]" format=json  # 查找待处理任务
-```
-
-更多 CLI 命令参见 [Obsidian CLI 官方文档](https://obsidian.md/cli)。
-
-## 🧠 Agent Skill（OpenClaw / Cursor / Claude Code）
-
-本项目内置了 **2ndbrain Agent Skill**（`skills/2ndbrain/`），让 AI Agent 成为你的知识管理助手。安装后 Agent 能：
-
-- **记录** — 把你说的任务、想法、决策快速写入知识库
-- **处理** — 你丢过来的任何资料（文章、URL、文件），阅读、分析、总结后自动归档到 PARA 对应目录
-- **整理** — 自动分类、打标签、移动任务到正确位置
-- **回顾** — 生成每日行动计划，按优先级排序
-- **记忆** — Agent 自身的所有工作日志和产出也持久化到知识库
-
-### OpenClaw 安装
-
-把本仓库给到 OpenClaw（龙虾），它会自动识别 `skills/2ndbrain/SKILL.md` 并加载。Skill 的 frontmatter 设置了 `always: true`，加载后始终在 Agent 上下文中激活。
-
-首次使用时，Agent 会自动运行 `2ndbrain check` 检测环境，缺什么装什么。你只需要：
-
-1. 把本仓库 URL 给到 OpenClaw
-2. 告诉龙虾你要管理知识库
-3. 龙虾会自动完成安装和初始化
-
-之后你跟龙虾日常对话就行——"帮我记一下"、"帮我读这篇文章"、"整理一下任务"、"今天做什么"。
-
-### Cursor / Claude Code 安装
-
-将 `skills/2ndbrain/` 目录复制到你的 Cursor skills 目录（通常是 `~/.cursor/skills/2ndbrain/`），Cursor 会自动识别并加载。
-
-### 定时整理
-
-Agent Skill 支持通过 OpenClaw cron 设置定时任务，每天自动整理和生成日报：
-
-```bash
-openclaw cron add \
-  --name "2ndbrain-morning" \
-  --cron "0 9 * * *" \
-  --session isolated \
-  --message "你已安装 2ndbrain skill。执行每日整理并生成今日优先级 Top 3"
-```
-
-也可以用 `2ndbrain watch` 命令监听文件变化，自动触发轻量整理。
-
-### Skill 文件结构
-
-```
-skills/2ndbrain/
-├── SKILL.md                        # 主技能文件（Agent 读这个）
-└── references/
-    ├── setup.md                    # 安装引导
-    ├── operations.md               # 整理算法 + 智能日报
-    ├── scheduling.md               # 调度策略（cron + watch）
-    ├── task-conventions.md         # 任务格式约定
-    └── content-processing.md       # 内容处理 + PARA 自动归档
-```
-
-## 🤖 AI 助手指南
-
-> 本节内容面向 AI 助手（Claude、ChatGPT、Cursor 等）。当帮助用户操作本项目时，请遵循以下规则。
-
-### 核心规则
-
-1. **任务格式**：所有任务使用 `- [ ] 任务描述 #tag 📅 YYYY-MM-DD`
-2. **文件放置**：所有新内容先放 `10_Inbox/{成员}/`，明确目标的放 `30_Projects/`
-3. **不要修改看板查询**：`00_Dashboard/` 和 `01_Tasks.md` 中的 Tasks 查询块是自动生成的，只修改 To-Do 文件中的任务
-4. **使用模板创建日记**：模板位于 `99_System/Templates/tpl_daily_note.md`
-5. **任务完成**：将 `- [ ]` 改为 `- [x]`，Tasks 插件会自动添加完成日期
-6. **遵循用户语言**：匹配对话中使用的语言
-
-### Agent 协作设计
-
-AI 助手和人类在 2ndBrain 中**共存协作**。Agent 可以直接操作所有目录，使用 `10_Inbox/Agents/` 共享工作区记录工作日志。
-
-详细的 Agent 工作日志格式和协作规范参见 `10_Inbox/Agents/Journal.md`。
-
-### 工作原则
-
-1. **优先改进工具而非绕过工具**——手动操作不可复现且易出错
-2. **注意命名一致性**——工具设计应考虑命名差异，避免同步失败
-
-## 🏗️ 架构说明
-
-> 本节面向开发者和 AI 编程助手，描述 CLI 工具的内部架构。
-
-<details>
-<summary><strong>点击展开架构详情</strong></summary>
-
-### 入口
-
-- `bin/2ndbrain.js` — CLI 入口（Commander.js）
-- `src/index.js` — 主模块，导出所有命令
-
-### 核心模块
-
-| 模块 | 职责 |
-|------|------|
-| `src/lib/config.js` | 框架文件定义、目录约定、项目识别 |
-| `src/lib/files.js` | 文件操作（复制、智能比较、删除） |
-| `src/lib/diff.js` | 文件比较（使用 `diff` 包，支持行/词级比较） |
-| `src/lib/prompt.js` | 交互式提示（确认、选择、批量更新） |
-| `src/commands/init.js` | 项目初始化（验证、创建目录、复制文件） |
-| `src/commands/member.js` | 成员目录创建（模板处理、配置更新） |
-| `src/commands/update.js` | 框架文件更新（差异预览、批量/逐个模式） |
-| `src/commands/remove.js` | 框架文件移除（仅框架文件，不碰用户数据） |
-
-### 设计模式
-
-- **框架 vs 用户数据分离**：`FRAMEWORK_FILES` 由 CLI 管理，`USER_DATA_DIRS` 永不触碰
-- **模板占位符**：`{{MEMBER_NAME}}` 在 `member` 命令执行时替换
-- **智能合并**：`.obsidian/` 配置使用 manifest 驱动的合并策略（数组并集、只增不覆盖等）
-- **Dry Run 模式**：`update` 和 `remove` 支持 `--dry-run` 预览
-- **项目标识**：`AGENTS.md` 文件的存在标识一个 2ndBrain 项目
-
-### 依赖
-
-- `commander` — CLI 框架
-- `chalk` — 终端颜色
-- `fs-extra` — 增强文件系统操作
-- `diff` — 文件比较/差异生成
-
-Node.js >= 18.0.0
-
-</details>
-
-## 📚 延伸阅读
-
-想深入了解背后的方法论？
-
-- <span id="gtd"></span>**[GTD (Getting Things Done)](https://gettingthingsdone.com/)** - David Allen 的经典时间管理方法
-  - C-O-R-D 是 GTD 的现代轻量演进，保留核心精髓，简化为四步
-
-- <span id="para"></span>**[PARA 方法论](https://fortelabs.com/blog/para/)** - Tiago Forte 的知识管理框架
-  - 本系统的目录结构（Projects、Areas、Resources、Archives）基于此框架
-
-- <span id="append-and-review"></span>**[The Append-and-Review Note](https://karpathy.bearblog.dev/the-append-and-review-note/)** - Karpathy 的极简笔记法
-  - **核心思想**：维护单一笔记，所有新内容追加到顶部，定期回顾时提升重要内容
-  - **在本系统的实践**：
-    - `10_Inbox/` 目录就是"单一收集点"（所有日记都在这里）
-    - 收集阶段：所有想法、待办先追加到日记，不打断思考
-    - 整理阶段：定期回顾日记，将重要内容提升到对应目录（Projects/Areas/Resources）
-    - 这样既保持了记录的低门槛，又通过回顾实现了内容的自然筛选和整理
-
-- <span id="cord"></span>**[C-O-R-D 工作流](https://fortelabs.com/blog/cord/)** - PARA 方法论的实践框架
-  - Collect（收集）、Organize（整理）、Review（回顾）、Do（执行）
-  - 本系统将这四步与 GTD 精髓结合，形成适合个人和团队的知识管理实践
-
-- <span id="obsidian"></span>**[Obsidian](https://obsidian.md/)** - 当前推荐的实现工具，本地优先、插件生态丰富
-
-## 🤝 贡献指南
+如果你的环境暂时不用 `skills` CLI，再退回到手动复制 `skills/2ndbrain/` 目录的方式。
 
-欢迎提交 Issue 和 Pull Request！
+Skill 主入口见 [SKILL.md](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/SKILL.md)。
 
-- 🐛 发现问题？[提交 Issue](https://github.com/Our2ndBrain/2ndBrain-Template/issues)
-- 💡 有改进建议？欢迎 PR
-- ⭐ 觉得有用？给个 Star 支持一下
+## AI 如何与人协作
 
-## 📄 开源协议
+AI Agent 使用这个模板时，至少遵循这些规则：
 
-本项目采用 [Apache License 2.0](LICENSE) 开源协议。
+- 在安装、初始化或接管知识库前，先运行 `2ndbrain check` 或 `npx @our2ndbrain/cli@latest check`。
+- 记录优先于整理。不确定归类时，先放到 `10_Inbox/{成员名}/`。
+- 任务写到 `10_Inbox/{成员名}/00_To-Do.md`，不要手改 `00_Dashboard/*.md` 或 `10_Inbox/*/01_Tasks.md` 这类查询文件。
+- 跟随用户语言，不要擅自切换中英文。
+- 优先通过 2ndBrain Skill 处理这些动作：记录、整理、回顾、内容处理、定时整理。
+- 需要细节时，不要在 README 里猜，直接阅读 Skill 和 references。
 
----
+## 深入阅读
 
-<p align="center">
-  <i>方法论是内核，工具只是载体。<br/>用系统承载混乱，让大脑专注思考。</i>
-</p>
+- [详细指南（中文）](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/docs/guide.md)
+- [Detailed Guide (English)](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/docs/guide_en.md)
+- [2ndBrain Skill](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/SKILL.md)
+- [安装参考](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/references/setup.md)
+- [整理与日报](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/references/operations.md)
+- [内容处理](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/references/content-processing.md)
+- [调度与自动整理](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/references/scheduling.md)
+- [任务约定](https://github.com/Our2ndBrain/2ndBrain-Template/blob/main/skills/2ndbrain/references/task-conventions.md)