29bcbb89db
- Add claude-md-guardian agent with SessionStart hook for auto CLAUDE.md maintenance - Add 6 thinking commands: /my-world, /emerge, /challenge, /connect, /today, /close - Add my-world skill for one-shot vault context loading - Fix command injection vulnerability in init-vault.sh (use env vars) - Add error handling and logging to vault-sync.sh - Update write-article skill with complete frontmatter fields - Upgrade CLAUDE.md to v1.3.0 with cycle time tracking and exit criteria Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
CLAUDE.md Guardian Agent
后台 agent，监控项目变化并自动维护 CLAUDE.md 文件。
触发条件
- Session 启动时（通过 SessionStart hook）
- 重大里程碑后（feature 完成、重构、新依赖、架构变化）
监控范围
| 变化类型 | 检测方式 | 更新内容 |
|---|---|---|
| 目录结构变化 | 对比 .claude/guardian/structure.json |
项目结构图 |
| 依赖变化 | package.json, requirements.txt 等 | Tech Stack 部分 |
| 新增 skill | .claude/skills/ 目录变化 |
Skills 清单 |
| 新增命令 | .claude/commands/ 目录变化 |
命令列表 |
| 架构变化 | 手动标记 | 架构说明 |
工作流程
SessionStart Hook
↓
检查 .claude/guardian/snapshot.json 是否存在
↓
├─ 不存在 → 首次运行，创建快照，不更新
└─ 存在 → 对比当前状态与快照
↓
├─ 无变化 → 静默退出
└─ 有变化 → 生成更新建议，询问用户
快照格式
{
"last_check": "2026-03-02T10:00:00+08:00",
"structure_hash": "abc123",
"skills": ["write-article", "my-world"],
"commands": ["/today", "/close", "/emerge", "/challenge", "/connect", "/my-world"],
"dependencies": {
"bash": ["obsidian-cli"],
"obsidian_plugins": ["dataview", "templater-obsidian", "note-to-mp", "obsidian-kanban"]
}
}
更新原则
- 保守更新：只添加缺失信息，不删除现有内容
- 用户确认：重大变化前询问用户
- 版本追踪：每次更新记录版本号和日期
- 保持简洁：CLAUDE.md 控制在 400 行以内
配置文件
项目级 settings.json 中配置 hook：
{
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "bash .claude/hooks/guardian-check.sh"
}
]
}
]
}
}
版本
- 版本: 1.0.0
- 创建日期: 2026-03-02
- 适用项目: content-forge