Immune-Brain Skill 技能

技能简介

Immune-Brain 是面向 Pi 与 Claude Code 的确定性工程工作流与质量保障引擎，目标是"把模糊想法变成可交付代码，覆盖规划、执行、QA 与审查"。它在不破坏日常对话体验的前提下，让复杂功能开发场景可以显式启用 imm-brainstorm、imm-planner、imm-loop 等工作流，并把任务进度以 TaskIntent + TaskRecord 形式落盘到 Git 与 .imm/ 目录，会话重启或上下文清理后可无缝恢复。Claude Code 最低版本要求 2.1.236（已通过 server-initiated MCP elicitation 验证）。适合需要"严肃工程化产出"的 AI 编程场景。

核心能力

• 日常零负担：普通问答、单点修改、探索性对话完全保留 Host 原生体验，不拦截、不强加流程。
• 显式严谨模式：复杂功能开发或高保证任务下显式调用 imm-brainstorm / imm-planner / imm-loop 进入结构化流程。
• 可追踪任务（TaskIntent + TaskRecord）：进度落盘持久化（Git + .imm/），会话重启或上下文清理后可无缝恢复。
• 代码强制 QA 验收：自动化 QA 与隔离式 Reviewer 审查必须通过，任务才被结算完成。
• Batch Authorization 批量运行：一次确认的 batch 让 imm-loop 串行推进已发布 Initiative 的各个 child；每个 child 仍独立 Enrollment、独立 QA/Review、独立结算。
• Pi 适配：通过 package.json 的 pi.skills / pi.extensions 自动发现 6 个 Skill，无需额外 server 配置。
• Claude Code 适配：通过 marketplace 安装 plugin，附带 MCP elicitation server，验证请求通过 IPC 协议。
• 自包含的 Initiative 目录：每个 Initiative 是一个独立目录，包含 brief、handoff、tasks、sessions、artifacts，便于跨 session 跟踪。
• 可插拔 Reviewer：支持把独立 Claude / Codex / Qwen 进程作为隔离 Reviewer，跑评审读 main 文件，主 agent 仍负责所有测试。

安装配置

1. 前置环境：已安装 Pi 或 Claude Code（≥2.1.236）；Node.js 20+；测试环节需 bun。
2. Pi 中安装：在 package.json 添加 "pi": {"skills": ["./plugins/immune-brain/skills"], "extensions": ["./plugins/immune-brain/.pi-extension"]}，无需额外 server 配置，6 个 Skill 自动可用。
3. Claude Code 中安装：从 Marketplace 安装 plugin；plugin 自带 MCP server 触发 server-initiated elicitation。
4. 配置文件位置：.imm/ 目录用于 TaskIntent / TaskRecord 落盘，默认放在项目根。
5. 批量授权：在 imm-loop 启动前一次性确认 batch authorization 范围，避免被逐个 child 反复 prompt。

适用场景

• 长周期工程项目：跨多天 / 多 session 仍要保持任务连贯性的真实项目。
• 需要强 QA 验收：代码提交前必须过自动化 QA + 独立 Reviewer 审查的场景。
• 批量 Initiative 推进：多个 Initiatives 一次性启动 imm-loop 后顺序跑完。
• 上下文清理后恢复：session 超过 context window 后从 .imm/ 落盘记录无缝恢复。
• 严肃工程而非 demo：用 AI 写 demo 不需要，用 AI 跑真项目就需要 Immune-Brain。
• 多 Reviewer 模型：希望主 agent 模型之外再加一道独立 reviewer（Claude / Codex / Qwen 任选）。

适用人群

• AI 编程深度用户：已经在用 Claude Code 或 Pi 写大量代码的工程师。
• 小团队 Lead：希望团队成员共享同一套 AI 工程流程。
• 独立开发者：把 AI 当"严肃 co-engineer"而不是"聊天玩具"。
• 工具作者：希望基于 Pi / Claude Code 写自己的工程 Skill。

官方链接

• npm 包：https://www.npmjs.com/package/immune-brain
• 仓库：https://github.com/dereknex/immune-brain
• License：MIT
• Claude Code 最低版本：2.1.236