参考 · 适合打印

速查表

一页纸参考卡。需要立刻动手时，掌握这些就够了。

五种模式

模式	何时使用	返回值
(default)	用户参与	对话 / 产物
`mode:non-interactive`	无人值守（调度器 / cron）	`Documentation complete` / `Documentation skipped`
`mode:pipeline`	由编排器作为一步调用	状态枚举 JSON
`mode:return-to-caller`	lfg 第 2 步	完整状态记录
`mode:agent`	仅 ce-code-review	JSON 替代 Markdown

状态枚举（请勿改名）

技能	模式	取值
ce-debug	pipeline	`fixed-and-pushed` / `fixed-not-pushed` / `diagnosed-no-fix` / `flaky-infra` / `needs-human`
ce-debug	return-to-caller	`fixed` / `diagnosed-no-fix` / `needs-human` / `blocked`
ce-work	return-to-caller	`complete` / `blocked` / `failed`
ce-babysit-pr	pipeline	`success` / `needs-human`
ce-code-review	agent	`complete` / `failed` / `degraded` / `skipped`
ce-compound	non-interactive	`Documentation complete` / `Documentation skipped`

硬性规则

陈述条件，绝不要罗列步骤或案例。若发现自己又在追加"还有当 X 时……"，请指出 X 所代理的真正条件。
只在所属技能内规定机制。委托类技能只需陈述条件 + 安全失败方向 + 不可推导的被调用方事实；其余一概不写。
把所触碰的段落提到标准。未触碰的段落保持原样 — 在后续工作中点名处理。
绝不在 git commit 时省略尾部路径。绝不 git add -A。绝不在 main/master/detached 状态上裸提交。
绝不在 ce-code-review 中调用 AskUserQuestion。任何时候都不行。
永远不说"safe to merge"。改用 "Looks merge-ready — your call to merge."
绝不为让 CI 变绿而削弱 / 跳过 / mock 断言。
绝不自己盯 CI。把任务交给 ce-babysit-pr。
绝不在委托类技能内重写被调用方的命令。
绝不在 SKILL.md 中跨目录引用另一个技能。
绝不在没有兜底的情况下使用 ${CLAUDE_PLUGIN_ROOT} / ${CLAUDE_SKILL_DIR}。
绝不在读取路径上点名指令文件（AGENTS.md、CLAUDE.md、GEMINI.md）。改用"项目当前生效的指令"。
绝不要重命名状态枚举值。调用方按精确字符串分发。
绝不要把 autofix_class 视为可自动应用的许可。
绝不要为了制造一个记录在案的问题而创建跟踪工单。

最常用 SKILL.md 的开篇第一句

技能	一句话摘要
`lfg`	把一个请求从接收到完成，全程不接管；收尾于一个已确定 CI 状态的开放 PR。
`ce-strategy`	维护 `STRATEGY.md`。
`ce-ideate`	在 brainstorm 之前，先生成有据可依的想法。
`ce-brainstorm`	模糊想法 → 仅含需求的统一计划。
`ce-bakeoff`	独立竞争方案，经评判后综合。
`ce-pov`	对一个或文档给出有据可依的判断。
`ce-plan`	设计如何构建，含置信度检查 + 文档评审。
`ce-doc-review`	对计划/规格做多视角评审。
`ce-prototype`	一次性原型；必须有"人"在场。
`ce-work`	把一份计划从头到尾实现。
`ce-worktree`	隔离的 git worktree 设置。
`ce-simplify-code`	3 个 reviewer 并行；行为保持不变。
`ce-debug`	5 阶段诊断循环，先写测试再修复。
`ce-commit`	本地提交；绝不在默认分支上。
`ce-commit-push-pr`	提交 + 推送 + 开 PR + 交给 babysit。
`ce-babysit-pr`	盯住 PR，直到可合并。
`ce-resolve-pr-feedback`	应用、回复、解决 PR 评审意见。
`ce-code-review`	评审代码；跨模型同侪；深度闸门。
`ce-test-browser`	针对受影响页面的浏览器测试。
`ce-test-xcode`	通过 XcodeBuildMCP 在 iOS 模拟器上测试。
`ce-dogfood`	带 persona 的全自动浏览器 QA。
`ce-polish`	用户主导的 UX 打磨。
`ce-compound`	把已解决的问题沉淀为持久学习。
`ce-compound-refresh`	审计学习知识库。
`ce-handoff`	把会话交接给另一个 Agent。
`ce-explain`	带着证据解释怎么做 / 为什么。
`ce-riffrec-feedback-analysis`	分析 Riffrec 录屏。
`ce-noslop`	去除 AI 写作痕迹。
`ce-promote`	发布 / 营销文案。
`ce-proof`	发布到 Proof 协作文档。
`ce-product-pulse`	产品脉搏报告。
`ce-optimize`	以数据驱动的优化。
`ce-retune`	针对新模型重新调整语料。
`ce-sweep`	清扫反馈渠道 → 生成 lfg 可用的计划。
`ce-setup`	健康检查 + 搭建 Compound Packs。

跨技能调用关系（谁调用谁）

调用方	被调用方
`lfg`	ce-plan, ce-work, ce-simplify-code, ce-code-review, ce-compound, ce-test-browser, ce-commit-push-pr, ce-babysit-pr, ce-debug, ce-brainstorm, ce-pov, ce-prototype, ce-explain, ce-ideate
`ce-babysit-pr`	ce-resolve-pr-feedback, ce-debug, ce-commit-push-pr
`ce-commit-push-pr`	ce-babysit-pr（始终调用，除非显式跳过）
`ce-debug`	ce-simplify-code, ce-code-review, ce-commit, ce-commit-push-pr, ce-compound, ce-brainstorm（重思）
`ce-resolve-pr-feedback`	—
`ce-dogfood`	ce-worktree, ce-debug, ce-commit, ce-compound
`ce-polish`	ce-commit
`ce-brainstorm`	ce-plan, ce-pov, ce-prototype
`ce-plan`	ce-bakeoff, ce-brainstorm, ce-pov, ce-doc-review, ce-work
`ce-strategy`	（向 ce-ideate, ce-brainstorm, ce-plan, ce-product-pulse, ce-dogfood 提供 STRATEGY.md）
`ce-prototype`	ce-brainstorm, ce-plan
`ce-pov`	ce-explain
`ce-riffrec-feedback-analysis`	ce-brainstorm
`ce-sweep`	lfg（通过产出的计划）
`ce-compound`	ce-compound-refresh（窄范围）
`ce-explain`	ce-proof（仅当目标是 Proof 时）

配置键速查

键	默认值	层级	消费方
`docs_root`	`docs`	仅 config.yaml	所有产物写入器
`work_engine_mode` / `work_engine_preferences`	—	两层	ce-work
`brainstorm_output`	`html`	两层	ce-brainstorm
`brainstorm_model`	—	两层	ce-brainstorm
`ideate_output`	`html`	两层	ce-ideate
`pr_teaching_section`	`true`	两层	ce-commit-push-pr
`pr_teaching_archive`	`false`	两层	ce-commit-push-pr
`auto_babysit`	`true`	两层	ce-commit-push-pr
`pulse_product_name`	—	两层	ce-product-pulse
`pulse_lookback_default`	`24h`	两层	ce-product-pulse
`pulse_db_enabled`	`false`	两层	ce-product-pulse
`feedback_sources`	[]	两层	ce-sweep
`cross_model_review_mode`	—	两层	ce-code-review + ce-doc-review
`packs`	[]	两层	ce-code-review + ce-dogfood

CLI 速查

bun run convert       # convert + write all targets
bun run install      # convert + write to user install dir
bun run list         # list installed plugins
bun run plugin-path  # clone a branch to a known path
bun run cleanup      # back up stale CE artifacts

bun run codex:dev -- local      # link worktree's skills
bun run codex:dev -- status     # show local/remote state
bun run codex:dev -- remote     # restore marketplace-backed
bun run codex:dev -- remove     # remove CE installations

bun run test                 # full suite (parallel + TimeoutError re-run)
bun run test:skill-eval-cell # single skill behavior eval
bun run test:skill-eval-pack # paired old-vs-new eval

bun run release:validate      # release metadata check
bun run plugin:validate       # both manifests, --strict

claude plugin validate --strict .claude-plugin/marketplace.json
claude plugin validate --strict .claude-plugin/plugin.json
# (NEVER use `claude plugin validate .` — marketplace-only check)

日常路由速查

用户说	你应当运行
"我有个新功能的想法"	`ce-strategy`（如果事关方向）→ `ce-ideate` → `ce-brainstorm`
"把这件事从头到尾做完，不要我管"	`lfg "<feature>"`
"把这个规划一下"	`ce-plan "<topic>"`
"修这个 bug"	`ce-debug "<issue>"`
"帮我盯着这个 PR"	`ce-babysit-pr "<url>"`
"X 是干什么的？"	`ce-explain "<question>"`
"把这次经验存下来"	`ce-compound mode:non-interactive`
"我们该不该用 X？"	`ce-pov "<question>"`
"快速搭个原型"	`ce-prototype "<prompt>"`
"交接给另一个会话"	`ce-handoff create "<focus>"`
"清扫一下我们的反馈渠道"	`ce-sweep`
"给我的环境做个健康检查"	`ce-setup`

需要记住的关键句

"Writer 永远不声明自己没写过的路径。"
"每个宿主设定各自的边界，并经由不同的路径抵达它。"
"波动契约：worker 以互不重叠的文件归属扇出，而非以条目为单位。"
"委托类技能陈述条件、安全失败方向与不可推导的被调用方事实，绝不重写被调用方的命令。"
"永远不要为把测试套件变绿而修改测试。"
"并非每一次停顿都是敌人。"
"存活标记只能证明工作已开始；判断是否完成属于 Agent 的职责。"
"隔离是升级手段，而非入场费。"
"Settled window 告诉你 PR 已停止变动。它不告诉你评审不会随后赶到。"
"汇报结果，而不是机制。"
"读取文件本身。绝不要凭记忆重构它的规则。"