code-yangzz

让 Claude Code 真的记得你，真的分工干活，真的能看见。

v1.8.0 · by yangzz

三件事

① 上帝视角

主 agent 默认只调度，重活全派子 agent。

你说："帮我重构这个函数"
主 agent 会：Task 派 code-reviewer + debugger 子 agent 去做，自己只负责合成交付。

/mode              # 查看当前模式
/mode orchestrator # 半严格（默认，Write/Bash/多文件都要派子 agent）
/mode free         # 关闭守卫（临时场景）
/orchestrate <任务> # 明确触发编排模式，先出调度计划

② 记忆

对话里说"记住我喜欢 X"、"别再用 Y"、"注意 Z 坑" → 自动写回，下一局会话自动恢复。

/remember <内容>   # 主动写入一条持久记忆

记忆存在 ~/.claude/memory/entries.jsonl，按 preference / fact / scar / pattern 分类。下次 SessionStart 自动注入，你什么都不用做。

③ Observatory

浏览器打开 http://localhost:8021，实时看：

npx code-yangzz --observatory

• Cockpit：今日高亮（事件/派遣/拦截/写回）· 我的偏好 · 踩坑 · 给下次 Claude 的留言（写一句，下次会话自动读并消费）
• Live：hook 触发 + 工具调度 + 记忆写回的实时事件流（SSE 推送）
• Memory：记忆地图，支持按 kind/tag 过滤，增 / 改 / 删
• Timeline：跨会话回放

两条守护线（默默生效）

| 守护线 | 触发时机 | 作用 | |--------|---------|------| | 代码质量 | 保存 / 修改文件后 | 自动 Prettier · TypeScript 类型检查 · console.log 残留提醒 | | 危险拦截 | 执行 Bash 前 | 危险命令拦截（rm -rf / 强制推送 etc.）· git push 二次确认 |

安装

npx code-yangzz                    # 交互式安装
npx code-yangzz -y                 # 自动检测并安装
npx code-yangzz --target claude    # 只装 Claude Code
npx code-yangzz --target codex     # 只装 Codex CLI
npx code-yangzz --target both -y   # 两个都装

安装完重启 Claude Code 或 Codex CLI，装完就能用。

每天会用到的命令

npx code-yangzz --observatory        # 打开驾驶舱（默认 :8021）
npx code-yangzz --observatory --port 9021
npx code-yangzz --doctor             # 健康检查
npx code-yangzz --verify             # 包完整性校验
npx code-yangzz --uninstall          # 卸载并恢复备份

它到底改了什么？

一条命令往 ~/.claude/ 注入：

~/.claude/
├── CLAUDE.md                226 行，只讲上帝视角 + 记忆 + 智能体
├── settings.json             hook / 权限 / model 配置
├── hooks/
│   ├── orchestrator-guard    ← 上帝视角守卫
│   ├── memory-writer         ← 记忆自动写回（Stop / PreCompact）
│   ├── session-start         ← 自动注入记忆 + Observatory 留言
│   ├── subagent-context      ← 子 agent 能力继承
│   └── 8 个守护线 hook       ← format / typecheck / bash 拦截等
├── scripts/                  memory-save / mode-switch / doctor
├── agents/                   11 个智能体（8 meta + 3 专家）
├── commands/                 8 个斜杠命令
├── contracts/                workflow-contract.json
├── skills/                   tools (5) + orchestration + agent-teams + ai/dev/arch/devops 领域按需读
└── memory/
    ├── MEMORY.md             稳定记忆
    ├── USER.md               用户画像
    ├── entries.jsonl         结构化条目（主数据）
    ├── events.jsonl          事件流（Observatory 消费）
    └── note-for-next-session.md  Observatory 写入的下次开场白

智能体团队（11 个，按需调度）

8 个治理 meta：meta-warden · meta-conductor · meta-genesis · meta-artisan · meta-sentinel · meta-librarian · meta-prism · meta-scout
3 个专家：code-reviewer · debugger · performance-engineer

斜杠命令（8 个）

| 命令 | 作用 | |------|------| | /remember | 沉淀一条持久记忆 | | /orchestrate | 主 agent 接管任务、先出调度计划 | | /mode | 查看 / 切换上帝视角模式 | | /verify-security | 代码安全扫描 | | /verify-module | 目录结构 / 文档完整性 | | /verify-change | Git 变更分析 | | /verify-quality | 代码质量检测 | | /gen-docs | 生成 README / DESIGN 骨架 |

要求

• Node.js >= 18
• Claude Code 或 Codex CLI（Codex 不支持 hook，上帝视角退化为语义引导）

卸载

npx code-yangzz --uninstall

自动恢复安装前备份。

许可证

MIT

变更历史

见 CHANGELOG.md。