用途:Circuit 把编码任务转化为一次命名流程运行,代替手写式随意处理。内置流程包括 Fix(修复缺陷、回归、失败测试)、Build(功能、重构、文档、测试)、Explore(调查、对比、决策前研究,不写入)、Review(代码、diff、PR 审计,只审不改)、Prototype(一次性原型、草图、方案变体)。
主要能力:每次运行在 .circuit/runs/<run-id>/ 下写入 trace.ndjson、reports/(含 operator-summary.md、result.json)和证据;支持检查点暂停后经 circuit resume 恢复;circuit checkpoints 列出等待决策的运行;circuit handoff save/resume/brief 支持跨会话交接;circuit doctor 检查连接器是否可用;circuit preview 展示每一步将使用的连接器和模型而不真正启动;--power 调节模型强度与流程深度,--process 可单独覆盖,--tournament 与 --autonomous 为可选模式。
使用方式:插件环境用 node "${CLAUDE_PLUGIN_ROOT}/scripts/circuit.js" present run <flow> --goal '<task>';仓库内用 ./bin/circuit run <flow> --goal '<task>';全局用 circuit run <flow> --goal '<task>'。--goal 文本必须用单引号包裹,内嵌单引号转义为 '''。配置为 ~/.config/circuit/config.yaml 与 ./.circuit/config.yaml,可用 circuit config set|unset|show 编辑。
适用场景与限制:适合有明确形态的编码工作;琐碎问答、单行回答、已处于 Circuit 运行内的中继工作、用户明确要求跳过、或未安装且未被要求时应直接处理。退出码为契约:完成 0,检查点暂停 0,未完成的关闭 1,用法错误 2。Build、Fix、Prototype 在可写入前会先声明。新建流程应克制,按规则优先用调参、配置、记忆备注或一次性生成解决。中文界面、定价与平台支持资料暂未提供。