EN 한국어 日本語 中文
入门 · INTRO 整体结构 · REFERENCE →
QE FRAMEWORK · 5分钟指南

让 AI 正确地完成工作的框架

v6.5.0 新功能 · Contract Layer — 从机器层面阻止 AI 悄悄破坏业务逻辑的契约式验证层。详见下方术语表与完整指南。

QE Framework 在让 AI 编码时自动融入规范·执行·验证， 从系统层面防止"草率完成"或"做错了"的情况。

0130秒介绍

为什么需要。当你告诉 AI "修一下这个"时，通常会有三件事出错 — 请求太模糊 AI 只能猜测，或者它执行了但你无法追踪做了什么，或者"都完成了"实际上只做了一半。人类开发者之间也用规范 → 实现 → 评审来防止这个问题。QE 对 AI 强制相同的纪律。

有什么不同。不是简单的提示词集合。每项工作首先被记录为两个文件 — TASK_REQUEST（要做什么）和VERIFY_CHECKLIST（如何验证）。执行发生在之后，每个检查项都用 yes/no 判定，只有全部通过才算"完成"。如果中途失败，自动生成重试规范。

什么得到保证。（1）用户在执行前看到 AI 计划做什么。（2）AI 不给自己评分 — 有独立的验证·监督阶段。（3）任何阶段都能切换 Claude 或 Codex，不直接调用外部 API，所以依赖被隔离。

025秒类比

理解 QE 的最快方法 — 把它想象成工作室。

SKILL
工具
像锤子·钻子这样的功能
AGENT
员工
实际使用这些工具的人
HOOK
规则
"锯之前戴护目镜"这样的自动门闸
SPEC
合同
说明要做什么的文件

03新手只做这 4 件事

  1. /Qinit — 在项目中安装框架（自动生成 CLAUDE.md、.qe/ 目录）
  2. /Qplan "你想做的事一句话" — AI 提议路线图和步骤
  3. /Qgs Phase 1: 简短名称 — 生成两个具体规范文件（批准后立即执行）
  4. 完毕。之后验证·监督自动运行 — 失败时 AI 自己重试，完成时通知你。
# 其他命令可以在你熟悉这 4 个之后再学。
💡 总是可以从 /Qplan 开始。/Qplan 自动判定工作规模，如果判断是简单工作（一个 bug·小重构），会跳过路线图直接进入 /Qgs Fix: …。规模判定你不用做 — /Qplan 会自己分成微型/小型/完整等路径。

04实际流程是这样的

用户："修复点击登录按钮没有反应的 bug"
1

计划 (Plan)

/Qplan 判定工作规模 — "只有一个 bug，微型规模"，提议 1 行计划。 跳过路线图和阶段，直接进入下一步。

2

生成规范 (Spec)

/Qgs 创建TASK_REQUEST（哪个文件的哪个函数怎样修复）和 VERIFY_CHECKLIST（修后检查什么）。用户快速看这两个文件 "对，就这样做"后批准。

3

执行 (Execute)

/Qatomic-run 并行执行检查项。多个文件时，多个 AI 员工（Haiku） 同时分头修改。Hook 每次自动检查"写得对吗？"。

4

验证 (Verify)

/Qcode-run-task 运行测试逐一检查 VERIFY_CHECKLIST。 任何一项失败都自动修复 → 重新运行 → 重新验证（最多 3 次）。通过后报告"完成"。

0515 个核心术语

阅读完整 Reference 前值得了解的单词。

PSE Chain
用户工作流 4 阶段（Plan → Spec → Execute → Verify）。所有工作的骨架。
SIVS Loop
品质门 4 阶段（Spec → Implement → Verify → Supervise）。在 PSE 内部运行的内部验证。
Skill
AI 在特定场景下可以调用的功能单元。像 /Qplan 这样的斜杠命令。
Agent
Skill 委派给的执行主体（E* 前缀）。后台工作的 AI 员工。
Hook
基于事件的自动门闸。AI 做某事前/后确定性运行的规则。
Spec
工作的合同。用 TASK_REQUEST 和 VERIFY_CHECKLIST 两个文件表示。
TASK_REQUEST
"做什么"的规范 — 检查项 + 依赖 + 输出文件路径。
VERIFY_CHECKLIST
"怎样验证完成" — 能用 yes/no 回答的判定项列表。
Wave
并行执行单元。把没有依赖的工作分配给多个 AI。
Teammate
Wave 中工作的 Haiku 模型 Agent。快速、便宜、适合重复工作。
Verify
"做了没有？"确认 — 客观的 yes/no 判定。
Supervise
"做得好不好？"评估 — 安全·品质·文档等专家视角的评估。与 Verify 不同。
Context Memory
按文件夹分割的 AI 上下文。只加载当前工作目录的对应文件，节省 token。
Phase
路线图的一个阶段。可以包含多个 Wave。Phase 1、Phase 2、…
Handoff
Skill 结束时告诉用户下一个命令的标准块。用户能复制粘贴，所以保持简短。
⚠️ Qutopia Mode
让所有技能跳过确认提示并自动选择第一个选项的自主执行开关。速度快，但可能提交错误的文件、直接 push 到 main、或者连锁执行破坏性步骤。只有在需求明确、每一步都可回滚、处于独立功能分支时才启用。完整的启用前检查清单参见 USAGE_GUIDE §10。会话结束前务必执行 /Qutopia off。
Contract Layer (v6.5+)
将业务逻辑固定为结构化 markdown 契约(6 个区块:Signature / Purpose / Constraints / Flow / Invariants / Error Modes),通过 LLM judge 三方比对契约、实现、测试以判定一致性的验证层。从机器层面阻止 AI 重构悄悄偏离原意的"氛围编码"。通过 /Qcontract 与 /Qverify-contract 使用。
/Qcontract
契约生命周期管理技能。子命令 create / edit / list / approve 用于创建、修改、查看、锁定 .qe/contracts/active/ 下的契约。审批采用对话式门控(AskUserQuestion)+ .qe/contracts/.lock 哈希记录的双层防御。
/Qverify-contract
基于 LLM judge(Econtract-judge 代理)的契约合规验证技能。三哈希(contract / impl / test)缓存避免对未变更内容重复判定。支持单契约(<name>)与批量(--all)模式。由 /Qcode-run-task 第 4.10 步自动调用。