使用 Claude Code 在 Obsidian 中连接长期目标与日常执行。

https://t.co/G4xAqAkXkV https://t.co/KBM3ZvHTfF

ballred/obsidian-claude-pkm

源码：https://github.com/ballred/obsidian-claude-pkm

📊 参与快速投票 (https://github.com/ballred/obsidian-claude-pkm/discussions/4) — 帮助塑造下一步开发方向！

Obsidian + Claude Code：AI 问责执行系统

这不是又一个 PKM 入门套件。 这是一个将你的三年愿景与今日行动相连接的执行系统——并通过 AI 来确保问责。

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

每个层级相互连接。/daily 从每周回顾中凸显你本周的头等大事。/weekly 展示项目进展。/monthly 检查季度里程碑。/goal-tracking 则知晓哪些目标尚未启动对应项目。确保万无一失。

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

层级联动

用户为本仓库点星的第一大理由：“我想要目标 → 项目 → 每日笔记 → 任务能够真正连接起来。”

运作流程

早晨 — /daily 创建今日笔记，显示本周头等大事和活跃项目的下一步行动。你选择今日焦点。

晚间 — /daily 概括今日关注了哪些目标与项目。未链接的任务会被标记。

周日 — /weekly 读取你所有每日笔记，扫描项目状态，计算目标进度，并协助你规划下周。可选智能代理团队模式可并行化收集过程。

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

随时 — /project new 创建与目标关联的新项目。/project status 显示仪表板。/review 根据上下文自动识别应进行何种回顾。

快速开始

先决条件

• 已安装 Obsidian (https://obsidian.md/)
• 已安装 Claude Code CLI (https://docs.anthropic.com/en/docs/claude-code)
• 已安装 Git

设置

``bash

克隆并设置

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 ~/你的库位置 claude

首次运行时，你将看到包含层级联动可视化的欢迎消息。运行 `/onboard` 以个性化你的库——它会询问你的姓名、偏好的回顾日和目标领域，然后配置一切。

### 已有库？

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

``bash
cd ~/你的现有库
claude
# 然后输入：/adopt

Windows

``bash 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 式收件箱处理——分类、澄清、组织。 |

``bash
claude "使用 goal-aligner 代理分析我最近两周的活动"
claude "使用 inbox-processor 代理清理我的收件箱"

智能代理使用 memory: project 来学习你跨会话的模式——goal-aligner 记忆反复出现的不匹配模式，weekly-reviewer 学习哪些反思问题对你有效。

效率教练

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

``bash /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+）

``bash /upgrade check # 预览变更内容 /upgrade # 交互式升级并备份

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

### 从 v2.1 手动升级

``bash
# 复制新的技能目录
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 升级

``bash 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

## 文档

- **[设置指南](docs/SETUP_GUIDE.md)** — 详细安装说明
- **[自定义](docs/CUSTOMIZATION.md)** — 定制你的系统
- **[工作流示例](docs/WORKFLOW_EXAMPLES.md)** — 日常流程与最佳实践
- **[故障排除](docs/TROUBLESHOOTING.md)** — 常见问题与解决方案
- **[贡献](CONTRIBUTING.md)** — 如何提供帮助

## 贡献

欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。标记为“good first issue”的是适合新手的问题——请查看问题页面 (https://github.com/ballred/obsidian-claude-pkm/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)。

## 许可证

MIT — 随意用于你的个人知识管理之旅。