📊 参与快速投票 — 帮助我们决定接下来要开发的功能！

---

Obsidian + Claude Code：AI 责任体系

这不是又一个个人知识管理入门工具包。 这是一个执行系统，它将你的三年愿景与你当下的行动连接起来，并通过 AI 来确保你的执行力和责任感。

三年愿景 ──→ 年度目标 ──→ 项目 ──→ 月度目标 ──→ 周回顾 ──→ 日常任务
                                      ↑
                              /project new
                         (桥梁层)

每一层都紧密相连。/daily 会从周回顾中提取出你本周的“一件大事”；/weekly 展示项目的进展；/monthly 检查季度里程碑；而 /goal-tracking 则能识别哪些目标目前没有对应的项目在推进。这样一来，任何事情都不会被遗漏。

v3.1 · 无依赖 · MIT 许可证

级联结构

人们星标这个仓库的首要原因是：“我希望目标 → 项目 → 日记条目 → 任务能够真正地相互关联起来。”

层级	文件	技能	功能
愿景	Goals/0. Three Year Goals.md	/goal-tracking	生活领域、长期方向
年度	Goals/1. Yearly Goals.md	/goal-tracking	可衡量的目标、季度里程碑
项目	Projects/*/CLAUDE.md	/project	与目标关联的正在进行的计划
月度	Goals/2. Monthly Goals.md	/monthly	汇总周回顾，检查季度进展
周度	Goals/3. Weekly Review.md	/weekly	反思、调整、规划下周
日常	Daily Notes/YYYY-MM-DD.md	/daily	早晨计划、晚上反思

流程说明

早晨 — /daily 会创建当天的笔记，显示本周的“一件大事”以及当前项目的待办事项。你可以据此确定今日的重点。

晚上 — /daily 会总结今天哪些目标和项目得到了关注。未关联的任务会被标记出来。

周日 — /weekly 会阅读你所有的日常笔记，检查项目状态，计算目标进度，并帮助你规划下周。还可以选择使用代理团队模式来并行处理这些任务。

月末 — /monthly 会汇总每周的回顾，对照年度目标检查季度里程碑，并设定下个月的优先事项。

临时操作 — /project new 可以创建一个与目标关联的新项目。/project status 会显示项目的仪表盘。/review 则会根据上下文自动判断需要进行哪种类型的回顾。

快速开始

先决条件

• 已安装 Obsidian
• 已安装 Claude Code CLI
• 已安装 Git

设置步骤

# 克隆并设置
git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm
chmod +x scripts/setup.sh && ./scripts/setup.sh

# 在 Obsidian 中打开知识库，然后启动 Claude Code：
cd ~/your-vault-location
claude

首次运行时，你会看到包含级联结构可视化图的欢迎信息。运行 /onboard 来个性化你的知识库——它会询问你的姓名、偏好的回顾日期以及目标领域，随后完成所有配置。

已经有一个知识库？

你无需从模板开始。只需在现有 Obsidian 知识库的根目录下运行 /adopt——它会扫描你的文件夹结构，检测你的组织方式（PARA、Zettelkasten、LYT 等），交互式地映射你的文件夹，并根据你的目录名称生成所有配置文件。你的知识库结构将保持不变。

cd ~/your-existing-vault
claude
# 然后输入：/adopt

Windows 系统

git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm
scripts\setup.bat

技能（斜杠命令）

技能	命令	用途
每日	/daily	早晨计划、中午检查、晚上反思
每周	/weekly	30 分钟的周回顾，附带项目汇总
每月	/monthly	月度回顾，季度里程碑检查
项目	/project	创建、跟踪、归档与目标关联的项目
回顾	/review	智能路由——根据早上/周日/月底等情境自动选择合适的回顾类型
提交	/push	将知识库的更改提交并推送到 Git
上手	/onboard	交互式设置 + 加载知识库上下文
接入	/adopt	为现有知识库搭建框架（BYOV）
升级	/upgrade	更新到最新版本，同时保留原有内容
目标追踪	(自动)	跟踪整个级联结构中的进展
知识库操作	(自动)	读写文件，管理维基链接

AI 代理

四个具有跨会话记忆的专用代理：

代理	功能
goal-aligner	审核每日活动是否符合既定目标。标记不一致之处。
weekly-reviewer	协助进行三阶段的周回顾。学习你的反思风格。
note-organizer	修复断开的链接，合并重复条目，保持知识库的整洁。
inbox-processor	GTD 式的收件箱处理——分类、澄清、整理。

claude "使用 goal-aligner 代理分析我最近两周的情况"
claude "使用 inbox-processor 代理清理我的收件箱"

这些代理会利用 memory: project 来跨会话学习你的习惯——例如，goal-aligner 会记住你经常出现的不一致模式，而 weekly-reviewer 则会了解哪些反思问题对你最有启发。

生产力教练

一种将 Claude 转变为责任伙伴的输出风格：

/output-style coach

教练会挑战你的假设，指出目标与行动之间的偏差，提出有力的问题，并督促你履行承诺。它非常适合与 /daily 和 /weekly 配合使用。

自动化

无依赖。 所有功能均基于 Bash 脚本和 Markdown 实现。

• 自动提交 — 每次文件写入或编辑都会通过 PostToolUse 钩子触发一次 Git 提交。
• 会话初始化 — 显示你的“一件大事”、当前活跃项目数量以及距离上次回顾的天数。
• 首次使用欢迎 — 新知识库会获得引导式的上手体验。
• 技能发现 — 只需提及“技能”或“帮助”，即可自动列出可用的命令。
• 路径特定规则 — 根据上下文加载 Markdown 规范、生产力工作流和项目管理惯例。

结构

你的知识库/
├── CLAUDE.md                    # AI 上下文与导航
├── .claude/
│   ├── agents/                  # 4 个专用 AI 代理（带记忆）
│   ├── skills/                  # 10 种技能（上述 8 种 + 2 自动）
│   ├── hooks/                   # 自动提交、会话初始化、技能发现
│   ├── rules/                   # 路径特定的约定
│   ├── output-styles/           # 生产力教练
│   └── settings.json            # 权限、环境变量、钩子配置
├── Daily Notes/                 # YYYY-MM-DD.md
├── Goals/                       # 级联结构（三年 → 周）
├── Projects/                    # 每个项目都有 CLAUDE.md
├── Templates/                   # 可复用的笔记模板
├── Archives/                    # 已完成或非活跃的内容
└── Inbox/                       # 快速记录（可选）

升级

内置升级（v3.1+）

/upgrade check    # 预览更改内容
/upgrade          # 带备份的交互式升级

升级技能会创建一个带时间戳的备份，显示每个更改文件的差异，并且不会触及您的内容文件夹（每日笔记、目标、项目等）。

从 v2.1 手动升级

# 复制新的技能目录
cp -r vault-template/.claude/skills/project your-vault/.claude/skills/
cp -r vault-template/.claude/skills/monthly your-vault/.claude/skills/
cp -r vault-template/.claude/skills/review your-vault/.claude/skills/
cp -r vault-template/.claude/skills/upgrade your-vault/.claude/skills/

# 更新代理、钩子、设置
cp vault-template/.claude/agents/*.md your-vault/.claude/agents/
cp vault-template/.claude/hooks/* your-vault/.claude/hooks/
cp vault-template/.claude/settings.json your-vault/.claude/
chmod +x your-vault/.claude/hooks/*.sh

从 v1.x 升级

cp -r vault-template/.claude-plugin your-vault/
cp -r vault-template/.claude your-vault/
cp vault-template/CLAUDE.md your-vault/
chmod +x your-vault/.claude/hooks/*.sh

文档

• 设置指南 — 详细的安装说明
• 自定义 — 让它更符合您的需求
• 工作流示例 — 日常流程与最佳实践
• 故障排除 — 常见问题及解决方案
• 贡献指南 — 如何参与贡献

贡献

我们欢迎各种形式的贡献！请参阅 CONTRIBUTING.md 获取相关指南。标记为“good first issue”的问题非常适合新手参与——请查看问题页面。

许可证

MIT — 您可以自由地将其用于个人知识管理之旅。

Obsidian + Claude Code：AI 问责系统快速上手指南

本工具并非传统的知识管理（PKM）模板，而是一套执行系统。它利用 AI 将你的"3 年愿景”与“每日任务”紧密连接，确保每一层目标都有对应的项目支撑，并通过自动化流程进行问责。

1. 环境准备

在开始之前，请确保你的开发环境已安装以下必要组件：

• 操作系统：macOS, Linux 或 Windows (WSL/PowerShell)
• Obsidian：已安装并创建一个空白或现有的知识库（Vault）。
• Claude Code CLI：Anthropic 官方命令行工具。
  • 安装命令：npm install -g @anthropic-ai/claude-code (需 Node.js 环境)
  • 确保已完成 claude 登录认证。
• Git：用于版本控制和自动提交功能。

注意：本项目零依赖（Zero dependencies），核心逻辑基于 Bash 脚本和 Markdown，无需配置复杂的 Python 或 Node 运行环境。

2. 安装步骤

你可以选择从模板克隆新库，或将系统集成到现有的 Obsidian 知识库中。

方案 A：全新安装（推荐新手）

此方法会创建一个包含完整层级结构（愿景→目标→项目→日报）的新知识库。

# 1. 克隆仓库
git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm

# 2. 运行设置脚本
# macOS/Linux:
chmod +x scripts/setup.sh && ./scripts/setup.sh

# Windows:
scripts\setup.bat

# 3. 在 Obsidian 中打开生成的文件夹，然后启动 Claude Code
cd ~/your-vault-location  # 替换为实际路径
claude

首次运行时，系统将显示欢迎信息。请在对话框中输入 /onboard，按照提示输入你的名字、偏好复盘日期和目标领域，系统将自动完成个性化配置。

方案 B：集成到现有知识库 (BYOV)

如果你已有成熟的 Obsidian 知识库（无论使用 PARA、Zettelkasten 还是其他架构），无需迁移数据。

# 1. 进入你现有的知识库目录
cd ~/your-existing-vault

# 2. 启动 Claude Code
claude

# 3. 在对话框中输入采纳命令
/adopt

/adopt 命令会自动扫描你的文件夹结构，识别组织方式，并生成适配你现有目录名称的配置文件，原有数据结构保持不变。

3. 基本使用

系统核心在于“级联流”（The Cascade），通过特定的斜杠命令（Slash Commands）驱动 AI 代理在不同时间粒度上工作。

核心工作流示例

🌅 早晨规划 (/daily)

启动每日笔记，AI 会从周回顾中提取本周的“唯一重要事项”（ONE Big Thing），并列出活跃项目的下一步行动。

/daily

输出：创建今日笔记，展示聚焦重点，辅助晨间规划。

🌇 晚间复盘 (/daily)

在同一条笔记中再次运行，AI 会总结今日对目标和项目的贡献，标记未关联的任务。

/daily

输出：生成晚间反思摘要，检查目标对齐情况。

📅 周度回顾 (/weekly)

建议在周日运行。AI 读取所有每日笔记，扫描项目状态，计算目标进度，并协助制定下周计划。

/weekly

进阶用法：可调用专用 Agent 并行处理。

claude "Use the weekly-reviewer agent to facilitate my review"

🚀 项目管理 (/project)

创建与长期目标挂钩的新项目，或查看项目仪表盘。

/project new      # 创建新项目并链接到目标
/project status   # 查看所有项目进度概览

🎯 智能路由 (/review)

不确定该用哪个命令？使用 /review，AI 会根据当前上下文（是早晨、周日还是月底）自动判断并执行相应的复盘流程。

/review

启用“生产力教练”模式

想让 AI 更具问责性？切换输出风格，让 AI 挑战你的假设并指出目标与行动的偏差。

/output-style coach

开启后，AI 将以教练口吻提问，确保持续跟进承诺。

自动化特性

• 自动提交：每次文件写入或编辑后，系统会通过 Hook 自动触发 Git commit。
• 会话初始化：每次启动 claude 时，自动显示本周重点、活跃项目数及距上次复盘的天数。
• 技能发现：在对话中提到 "help" 或 "skill"，系统会自动列出可用命令。

---

提示：输入 /upgrade check 可预览最新版本更新，输入 /upgrade 可进行带备份的交互式升级。