junai Pipeline MCP

caddis — Claude Code 驱动框架

浏览所有命令、技能、Agent 和钩子 -> saajunaid.github.io/caddis-plugin — 参考网站，每次发布时都会重新构建。

caddis 是一个 Claude Code 驱动框架——由插件（以及共享的技能、子 Agent、斜杠命令和钩子库）组成，可大幅增强单个 Claude Code 会话的能力，并让它更难偏离轨道。它与 Agent 无关：同一套资源库也会导出到其他 AI 命令行工具（Codex、Antigravity、Copilot），而 CLAUDE.md↔AGENTS.md 互为镜像，因此每个 Agent 读取的规范都相同。

开始之前

你需要	原因
Claude Code，已安装并登录	caddis 是为它提供的插件
Python 3.11+，并加入 PATH	钩子和跨供应商评审工具基于 Python
Git	多个命令会读取仓库状态
（可选） DeepSeek 或 GLM 的 API 密钥	仅用于跨供应商评审和开源软件流程

坦诚说明平台情况： caddis 在 Windows 和 PowerShell 上开发并日常使用。 钩子采用纯 Python 编写，支持跨平台；技能、命令和 Agent 都是纯 Markdown，在任何平台上都能使用——但部分启动器同时提供 .ps1 和 .sh 版本，部署技能仅适用于 Windows，发布机制（sync.ps1）也仅支持 PowerShell。这里并不排斥 macOS 或 Linux；只是使用较少，因此可能不够完善，欢迎报告问题。

前五分钟

claude plugin marketplace add saajunaid/caddis-plugin
claude plugin install caddis@caddis

然后，在 Claude Code 会话中确认它确实已加载：

/caddis:version

如果输出了版本号，说明安装成功。接下来，用最短的路径了解 caddis 的用途：

试试这个	它的作用
/caddis:feature-plan add CSV export	将分阶段、按 TDD 组织的计划写入 .caddis/plans/——这是驱动框架其余部分读取的持久主干
/caddis:implement <plan>	按阶段执行计划，每个阶段完成后都会提交；只有遇到真正的边界时才会停止
/caddis:cross-review	让不同供应商的模型评审你的差异，因为同一供应商的评审者也会有相同的盲点
/caddis:handoff	编写恢复文档，让下一次会话无需重新探索即可开始

其他功能都不是必需的。如果你只使用 feature-plan → implement → cross-review，就已经能体验到大部分价值。

此仓库是已发布的市场镜像：托管 caddis 和 caddis-extras Claude Code 插件、bundles/ 下可移植的各驱动框架资源包，以及共享资源库。它由 caddis 作者仓库的导出器生成并推送——欢迎在这里提交问题，但代码更改会在上游提交并同步到此处。

---

安装（Claude Code）

# 1. Register this repo as a plugin marketplace (once)
claude plugin marketplace add saajunaid/caddis-plugin

# 2. Install the core plugin (always-on, lean context)
claude plugin install caddis@caddis

# 3. (optional) Add the long-tail skill library — cloud/data/media/etc. Disabled by default,
#    so it costs zero always-on context until you enable it.
claude plugin install caddis-extras@caddis

然后，在任意仓库中：

/caddis:setup-project-ai     # deploy the harness into the project

常见的工作循环如下：

/feature-plan      # (or /prd first) → writes .caddis/plans/<slug>.md, the durable spine
/implement         # executes the plan phase-by-phase, TDD, commit per phase
/ship              # express lane: commit → push → CI (hotfixes); feature work: /ship-pr then /ship-merge
/handoff           # ALWAYS end a session with this — writes the resume doc

最重要的习惯：每次会话结束时都运行 /handoff。 它会写入 .caddis/relay.md，该文件会在下一次会话开始时自动重新注入——这样你无需重新探索即可继续，而不是从一个毫无上下文、容易遗忘的会话重新开始。

完整的命令、技能和钩子参考以及思维模型，请参阅 USERGUIDE.md。

---

你将获得

• 斜杠命令 — /feature-plan、/prd、/implement、/tdd、/ship · /ship-pr · /ship-merge、/handoff、/kb、/digress · /resume、/cross-review、/usage-review、 /mermaid-db · /excalidraw-db、/setup-project-ai、/migrate-dir。
• 子 Agent — 精简、拥有独立上下文的助手：anchor（以证据为先的验证）、 code-reviewer、preflight（计划与代码库验证）、tester、debug、codebase-audit、 security-analyst、data-engineer、sql-expert、knowledge-transfer。
• 四层记忆模型 — 会话中继（relay.md）、自动 Dream Memory （memory.jsonl）、按仓库划分的知识库（.caddis/kb/ + DOC-MAP.md），以及跨仓库记忆。
• 钩子与安全 — 用于防护机密信息和破坏性写入的 PreToolUse 守卫、编辑时自动运行 lint，以及负责中继和记忆的 SessionStart/Stop 钩子。
• 分层技能 — 核心开发技能集随 caddis 一同提供；长尾技能（云、数据、媒体、效率工具）位于 caddis-extras，默认关闭。

---

在 Claude Code 之外安装（Codex、Antigravity 等）

知识层（技能 + AGENTS.md 约定）可在任何运行环境中使用。各运行环境的专属程序包发布在 bundles/ 下，并通过 caddis-init 安装：

# from a checkout of this repo (the installer ships in plugin/scripts/)
python plugin/scripts/claudster_init.py --target codex        --dest /path/to/project
python plugin/scripts/claudster_init.py --target antigravity  --dest /path/to/project

设计上安全：sha256 清单会追踪安装程序写入的内容；重新运行时只会更新未修改的文件，本地编辑过的文件会报告为冲突，绝不会被覆盖。

---

仓库布局

路径	内容
.claude-plugin/marketplace.json	市场清单（caddis + caddis-extras）
plugin/	核心 caddis Claude Code 插件（Agent、命令、钩子、核心技能）
plugin-extras/	caddis-extras 技能库（默认禁用）
bundles/	供 caddis-init 使用的便携式、按运行环境划分的导出内容（codex、antigravity）
.github/	共享资源池：技能、Agent、提示词、说明、工具
sync.ps1、export_runtime_resources.py、validate_pool.py	构建／同步机制

---

关于名称

caddis 之前以 claudster 之名发布（再之前，此仓库承载的是 junai Copilot 管线 — 参见 CHANGELOG.md 中 1.2 之前的条目）。使用旧名称设置的仓库会有 .claudster/ 产物目录；所有内容都能读取 .caddis/ 和 .claudster/，并且会写入仓库现有的目录，因此不会造成问题。想要转换仓库时，请运行 /caddis:migrate-dir。~/.claudster/ 用户级目录（密钥、安装记录）将永久保留。

---

许可证

MIT。已发布的插件程序包（caddis / caddis-extras）在其清单中采用相同的许可证。