@wnlen/agent-execution-template 0.8.19 → 0.8.20

package/bin/agent-execution-template.js

@@ -19,6 +19,8 @@ const REQUIRED_FILES = [
   "ai/template/protocol.md",
   "ai/template/rules/core.md",
   "ai/template/rules/output.md",
+  "ai/template/schemas/result.schema.json",
+  "ai/template/schemas/metrics.schema.json",
   "ai/project/inbox/.gitkeep",
   "ai/project/project.md",
   "ai/project/runtime.md",
@@ -39,11 +41,6 @@ const RECOMMENDED_FILES = [
   "ai/project/refs/roadmap.md"
 ];
 
-const JSON_HEALTH_FILES = [
-  "ai/project/result.json",
-  "ai/project/metrics.json"
-];
-
 const TASK_HEALTH_PATTERNS = [
   /^task_id:\s*/m,
   /^type:\s*/m,
@@ -132,6 +129,7 @@ const TEXT = {
     fail: "失败",
     empty: "为空",
     invalidJson: "JSON 无效",
+    invalidSchema: "不符合协议 schema",
     taskFrontMatterIncomplete: "任务 front matter 缺少关键字段",
     versionMismatch: "模板版本与包版本不一致",
     runInit: "请运行 npx -y @wnlen/agent-execution-template init",
@@ -241,6 +239,7 @@ Usage:
     fail: "FAIL",
     empty: "is empty",
     invalidJson: "contains invalid JSON",
+    invalidSchema: "does not match protocol schema",
     taskFrontMatterIncomplete: "task front matter is missing required fields",
     versionMismatch: "template version does not match package version",
     runInit: "Run npx -y @wnlen/agent-execution-template init",
@@ -701,6 +700,117 @@ function isPermissionError(error) {
   return error && (error.code === "EACCES" || error.code === "EPERM");
 }
 
+function parseJsonFile(file) {
+  return JSON.parse(fs.readFileSync(file, "utf8"));
+}
+
+function valueMatchesType(value, type) {
+  if (type === "array") return Array.isArray(value);
+  if (type === "integer") return Number.isInteger(value);
+  if (type === "number") return typeof value === "number" && Number.isFinite(value);
+  if (type === "object") return value !== null && typeof value === "object" && !Array.isArray(value);
+  return typeof value === type;
+}
+
+function valuesEqual(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+
+function validateJsonSchema(value, schema, location = "$") {
+  const errors = [];
+
+  if (schema.const !== undefined && !valuesEqual(value, schema.const)) {
+    errors.push(`${location} must be ${JSON.stringify(schema.const)}`);
+  }
+
+  if (schema.enum && !schema.enum.some((candidate) => valuesEqual(value, candidate))) {
+    errors.push(`${location} must be one of ${schema.enum.map((item) => JSON.stringify(item)).join(", ")}`);
+  }
+
+  if (schema.type && !valueMatchesType(value, schema.type)) {
+    errors.push(`${location} must be ${schema.type}`);
+    return errors;
+  }
+
+  if (schema.minimum !== undefined && typeof value === "number" && value < schema.minimum) {
+    errors.push(`${location} must be >= ${schema.minimum}`);
+  }
+
+  if (schema.minLength !== undefined && typeof value === "string" && value.length < schema.minLength) {
+    errors.push(`${location} must have length >= ${schema.minLength}`);
+  }
+
+  if (schema.required && valueMatchesType(value, "object")) {
+    for (const key of schema.required) {
+      if (!Object.prototype.hasOwnProperty.call(value, key)) {
+        errors.push(`${location}.${key} is required`);
+      }
+    }
+  }
+
+  if (schema.properties && valueMatchesType(value, "object")) {
+    for (const [key, childSchema] of Object.entries(schema.properties)) {
+      if (Object.prototype.hasOwnProperty.call(value, key)) {
+        errors.push(...validateJsonSchema(value[key], childSchema, `${location}.${key}`));
+      }
+    }
+  }
+
+  if (schema.items && Array.isArray(value)) {
+    value.forEach((item, index) => {
+      errors.push(...validateJsonSchema(item, schema.items, `${location}[${index}]`));
+    });
+  }
+
+  if (schema.allOf) {
+    for (const childSchema of schema.allOf) {
+      if (childSchema.if) {
+        if (validateJsonSchema(value, childSchema.if, location).length === 0 && childSchema.then) {
+          errors.push(...validateJsonSchema(value, childSchema.then, location));
+        }
+      } else {
+        errors.push(...validateJsonSchema(value, childSchema, location));
+      }
+    }
+  }
+
+  return errors;
+}
+
+function printSchemaValidation(file, schemaFile, text) {
+  const fullPath = path.join(process.cwd(), file);
+  const schemaPath = path.join(process.cwd(), schemaFile);
+  if (!fs.existsSync(fullPath) || !fs.existsSync(schemaPath)) {
+    return 0;
+  }
+
+  let value;
+  try {
+    value = parseJsonFile(fullPath);
+    console.log(`[${text.pass}] ${file} JSON`);
+  } catch {
+    console.log(`[${text.fail}] ${file} ${text.invalidJson}`);
+    return 1;
+  }
+
+  let schema;
+  try {
+    schema = parseJsonFile(schemaPath);
+  } catch {
+    console.log(`[${text.fail}] ${schemaFile} ${text.invalidJson}`);
+    return 1;
+  }
+
+  const errors = validateJsonSchema(value, schema);
+  if (errors.length > 0) {
+    console.log(`[${text.fail}] ${file} ${text.invalidSchema}: ${errors.slice(0, 3).join("; ")}`);
+    return 1;
+  }
+
+  console.log(`[${text.pass}] ${file} schema`);
+  return 0;
+}
+
 function printFatal(error, lang) {
   const text = getText(lang);
   if (isPermissionError(error)) {
@@ -756,18 +866,12 @@ function doctor() {
     console.log(`[${text.pass}] ${file}`);
   }
 
-  for (const file of JSON_HEALTH_FILES) {
-    const fullPath = path.join(process.cwd(), file);
-    if (!fs.existsSync(fullPath)) {
-      continue;
-    }
-    try {
-      JSON.parse(fs.readFileSync(fullPath, "utf8"));
-      console.log(`[${text.pass}] ${file} JSON`);
-    } catch {
-      console.log(`[${text.fail}] ${file} ${text.invalidJson}`);
-      missing += 1;
-    }
+  const schemaChecks = [
+    ["ai/project/result.json", "ai/template/schemas/result.schema.json"],
+    ["ai/project/metrics.json", "ai/template/schemas/metrics.schema.json"]
+  ];
+  for (const [file, schemaFile] of schemaChecks) {
+    missing += printSchemaValidation(file, schemaFile, text);
   }
 
   const taskPath = path.join(process.cwd(), "ai/project/task.md");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wnlen/agent-execution-template",
-  "version": "0.8.19",
+  "version": "0.8.20",
   "description": "Low-friction AI execution protocol template for coding agents.",
   "bin": {
     "agent-execution-template": "bin/agent-execution-template.js"

package/template/en/ai/template/VERSION

@@ -1 +1 @@
-0.8.19
+0.8.20

package/template/en/ai/template/execution-policy.md

@@ -121,6 +121,11 @@ verification was not possible. A purely subjective Green is not valid.
 
 ## User-Visible Output
 
+- Use the installed template language by default. When `ai/template/LANG` is
+  `en`, user-visible plans, L1 checklists, checkpoints, task draft handoffs,
+  blocked explanations, and final results should default to English. Use another
+  language only when the human explicitly asks, or when preserving code,
+  commands, file paths, or protocol field names.
 - Show the L1 checklist by default; do not show full L2/L3/L4 by default.
 - Show risk conclusions and necessary reasons; do not output long internal reasoning.
 - Show evidence; do not show internal protocol fields, full YAML,

package/template/en/ai/template/rules/output.md

@@ -25,7 +25,10 @@ verification, assumptions, issues, next steps, and runtime update proposals.
 
 ## Result Markdown
 
-`ai/project/result.md` is the human-readable summary. Keep it short:
+`ai/project/result.md` is the human-readable summary. Keep it short and use the
+installed language from `ai/template/LANG` by default. In the English template,
+headings and prose should default to English; preserve code, commands, file
+paths, and protocol field names as written.
 
 ```md
 ## Status

package/template/zh/ai/project/runtime.md

@@ -3,15 +3,15 @@
 ## 当前状态
 
 - 阶段：方向层与执行层一致性收口
-- 重点：保持文件协议可安装、可升级、可审计，并让项目方向治理与任务执行约束一致。
+- 重点：保持协议可安装、可升级、可审计，并让方向治理与执行约束一致。
 - 阻塞：无
 - 已知风险：
   - 超出当前任务范围
-  - 询问人类那些 Agent 可以安全推断的细节
+  - 询问可安全推断的细节
   - 用历史过程笔记污染运行时上下文
   - 没有验证证据就标记成功
   - 在明确权限之外运行命令
-  - 只优化 token 节省，而忽略成本可接受前提下的输出质量
+  - 只省 token，忽略可接受成本下的质量
   - 方向层已升级但规则、runtime 或 doctor 仍停留在旧语义
 
 ## 硬规则
@@ -36,8 +36,8 @@
 
 ## 项目约束
 
-- 引导读取集从 `ai/template/bootstrap.md`、`ai/template/protocol.md`、`ai/template/rules/core.md`、根目录文档、清单、文档、引用开始；当文档不足时，进行有限源码结构检查。
-- 执行读取集是 `ai/template/prompt.md`、`ai/template/protocol.md`、`ai/template/rules/core.md`、`ai/project/project.md`、`ai/project/runtime.md` 和 `ai/project/task.md`。
+- 引导读取集：`bootstrap.md`、`protocol.md`、`rules/core.md`、根文档、清单、项目文档、引用；文档不足时有限检查源码结构。
+- 执行读取集：`prompt.md`、`protocol.md`、`rules/core.md`、`project.md`、`runtime.md`、`task.md`。
 - `ai/project/refs/` 文件只在任务要求或任务类型触发时加载。
 - `ai/project/refs/final-shape.md`、`module-map.md`、`roadmap.md` 属于方向层正式文档。
 - 方向层正式文档不能被普通 reconcile 或普通执行任务直接修改。
@@ -53,9 +53,9 @@
 ## 当前上下文
 
 这个项目是协议 / 模板，不是复杂 Agent 框架。
-当前产品定位是：面向 AI Coding Agent 的项目方向治理 + 可审计任务执行协议。
-当前产品目标是减少人类交互频率和输入量，同时让任务随时间变得更精确，并减少长期方向漂移。
-允许增加少量服务于协议采用和治理闭环的 CLI；不要引入 UI、云同步或多 Agent 编排。
+定位：面向 AI Coding Agent 的项目方向治理 + 可审计任务执行协议。
+目标：减少人类交互和输入量，让任务随时间更精确，并降低长期方向漂移。
+允许增加少量服务协议采用和治理闭环的 CLI；不要引入 UI、云同步或多 Agent 编排。
 
 ## 引用路由
 
@@ -69,6 +69,6 @@
 
 ## 运行时更新治理
 
-除非 `ai/project/task.md` 明确允许，AI 不得直接更新这个文件。
-如果任务产生长期有效上下文，将建议写入 `ai/project/result.json.runtime_update`。
-通过单独任务应用运行时更新，该任务唯一允许目标是 `ai/project/runtime.md`。
+除非 `task.md` 明确允许，AI 不得直接更新本文件。
+任务产生长期上下文时，写入 `result.json.runtime_update` 建议。
+运行时更新应由单独任务应用，唯一目标是 `ai/project/runtime.md`。

package/template/zh/ai/project/task.md

@@ -79,14 +79,12 @@ permission:
 
 # 任务
 
-这个文件是当前执行契约。优先在引导模式中，根据简短人类目标和仓库上下文生成，
-然后由人类在执行前检查。
+当前执行契约。优先由引导模式根据人类目标和仓库上下文生成，执行前由人类检查。
 
-优先使用安全假设，少问额外问题。AI 应基于用户目标、项目上下文和仓库事实推断
-范围、风险、权限和验收；如果推断会越过权限、安全边界或验收无法定义，将
-`readiness` 标为 `blocked` 或将相关任务节点标为 `Red`，等待人类确认。
-如果本轮新建或重写了任务契约，默认保持 `draft_for_confirmation` 并停下来交接；
-只有已有任务明确处于 `ready_to_execute` 时，才进入执行。
+优先安全假设，少问问题。AI 基于目标、上下文和仓库事实推断范围、风险、权限和验收；
+若会越权、触碰安全边界或验收不可定义，将 `readiness` 设为 `blocked` 或把相关节点设为
+`Red`，等待确认。本轮新建或重写任务契约时，默认保持 `draft_for_confirmation` 并停下交接；
+只有既有任务为 `ready_to_execute` 时才执行。
 
 ## 目标
 
@@ -125,34 +123,32 @@ permission:
 
 ## 执行策略
 
-默认使用 `auto`，由 AI 在执行前规划时判定是否启用连续执行，而不是等待用户口令。
-如果执行前拆出的 L1 任务少于 2 个，使用 `normal`；如果 L1 任务为 2 个或更多，
-自动使用 `bounded_continuous`。
+默认 `auto`：AI 执行前规划并决定是否连续执行，不等用户口令。L1 < 2 用 `normal`；
+L1 >= 2 自动用 `bounded_continuous`。
 
 `bounded_continuous` 表示边界内连续执行：
 
-- 目标、范围、验收、权限和风险评级由 AI 基于用户目标、项目上下文和仓库事实推断；
-  不要求用户预先逐项提供。
+- 目标、范围、验收、权限和风险由 AI 基于目标、上下文和仓库事实推断；不要求用户逐项提供。
 - `readiness = ready_to_execute` 表示没有 Red 预检项，可以执行。
 - `readiness = draft_for_confirmation` 表示需要人类确认后才能执行。
 - `readiness = blocked` 表示当前任务不可执行，必须写 blocked 结果。
-- 本轮如果新建或重写 `ai/project/task.md`，必须停在确认交接；不能在任务仍是草稿时执行。
-- 执行前必须把 L1 任务清单写入 `execution_policy.task_tree`。
-- 执行前必须列出 L1 任务清单；每个 L1 用待办列表表示，完成后打勾并划掉。
+- 本轮新建或重写 `task.md` 时必须停在确认交接；草稿不能执行。
+- 执行前必须把 L1 清单写入 `execution_policy.task_tree`。
+- 执行前必须列出 L1 清单；每个 L1 用待办表示，完成后打勾并划掉。
 - L1 必须是可独立验收的垂直切片；不要把单个机械步骤拆成 L1，也不要把多个
   可独立验收的用户可见结果合并成一个 L1。
-- 执行某个 L1 前，AI 先规划自然衍生出的 L2；如果 L2 仍需拆分，再规划 L3。
-- 默认最多 3 层；只有当不拆 L4 会导致 L3 过大或不可验证时，才允许动态增加 L4。
-- 每个任务节点都由 AI 自己生成 Green / Yellow / Red 风险评级。
+- 执行 L1 前规划 L2；L2 仍过大时规划 L3。
+- 默认最多 3 层；不拆 L4 会导致 L3 过大或不可验证时，才允许 L4。
+- 每个节点都由 AI 生成 Green / Yellow / Red 风险评级。
 - 只有 Red 停下来让人类确认；Green 自动继续，Yellow 只允许当前 L1/L2 内的局部
   低风险修正，不能改变公共接口、数据模型、权限、安全、架构方向或验收标准。
-- `progress_unit` 默认是 `vertical_slice`：每轮推进都应该产生可检查的工作增量。
-- `checkpoint_budget` 是最多可用检查点预算，不是必须用完的次数；不要为了消耗预算而汇报。
+- `progress_unit` 默认为 `vertical_slice`：每轮都应产生可检查增量。
+- `checkpoint_budget` 是上限，不是必须用完；不要为消耗预算而汇报。
 - 只有在风险从 Green 变 Yellow/Red、即将扩大范围或权限、完成 L1 垂直切片、
   验证失败后准备继续、准备最终收尾时才输出 Checkpoint。
 - 每个 Checkpoint 必须包含证据：已改文件、已运行命令、验证结果或无法验证的原因。
-- `task_tree` 写回频率：执行前写入 L1 清单；开始或完成 L1 时更新该 L1 状态；
-  出现 Red、blocked、范围变化或最终收尾时立即写回；不要为每个微小 L3 操作写回。
+- `task_tree` 写回：执行前写 L1 清单；L1 开始/完成、Red、blocked、范围变化或收尾时写回；
+  不为微小 L3 操作写回。
 - 完成后只做一次总复盘；只对 Yellow、Red、失败验证或高影响模块做二次抽检。
 - 连续执行不改变模型策略；涉及判断、架构、失败复盘或验收争议时仍按 `model_policy` 升级。
 
@@ -163,9 +159,8 @@ permission:
 
 ## 模型策略
 
-默认使用 `model_policy.default_tier` 声明的模型档位。
-不要用 `strong` 做常规执行。只为 `model_policy` 声明的角色和触发条件使用 `strong`，
-并在 `ai/project/metrics.json` 中记录原因。
+默认使用 `model_policy.default_tier`。不要用 `strong` 做常规执行；只在
+`model_policy` 声明的角色和触发条件下使用，并在 `metrics.json` 记录原因。
 
 ## 停止条件
 

package/template/zh/ai/template/VERSION

@@ -1 +1 @@
-0.8.19
+0.8.20

package/template/zh/ai/template/bootstrap.md

@@ -1,15 +1,12 @@
 # AI 执行引导
 
 不要总结这个文件。
-执行下面的引导流程。
+按下面流程整理项目上下文。
 
-你正在为 Agent Execution Template 整理项目上下文。
+目标：建立后续任务依赖的稳定项目理解。这是发现与确认，不是实现。
 
-目标：建立后续任务会依赖的稳定项目理解。
-这是发现与确认步骤，不是实现步骤。
-
-你的任务是检查项目，创建或更新 `ai/project/project.md`
-以及相关的 `ai/project/refs/*`，然后在“引导后交接”处停止。
+检查项目，创建或更新 `ai/project/project.md` 和相关 `ai/project/refs/*`，
+然后在“引导后交接”处停止。
 
 ## 先读
 
@@ -31,11 +28,9 @@
 - 能推断约束时，更新 `ai/project/refs/constraints.md`
 - 只有存在持久决策证据时，更新 `ai/project/refs/decisions.md`
 
-只有在人类同时提供当前任务时，才创建 `ai/project/task.md`。
-如果创建了 `ai/project/task.md`，只起草任务契约，不进入执行。
+只有人类同时提供当前任务时，才创建 `ai/project/task.md`。只起草任务契约，不执行。
 
-引导期间不要编辑源码、测试、应用配置、依赖文件、生成文件、
-运行时文件、结果文件或指标文件。
+引导期间不要编辑源码、测试、配置、依赖、生成文件、运行时、结果或指标文件。
 
 ## 阅读顺序
 
@@ -48,12 +43,12 @@
 4. 现有 AI 引用：`ai/project/refs/*.md`
 5. 源码、测试、配置和文档目录的浅层仓库结构
 
-如果文档和清单缺失或不足，可以有限读取代码进行推断：
+文档和清单不足时，可有限读取代码推断：
 
 - 先检查顶层目录和文件名；
 - 检查可能的入口目录，例如 `src/`、`app/`、`lib/`、`packages/`、
   `services/`、`cmd/`、`internal/`、`server/`、`client/`、`test/`、`tests/`；
-- 只读取足够识别项目目的、模块边界、命令和约束的路由、模块、配置和测试文件；
+- 只读取足够识别目的、模块边界、命令和约束的路由、模块、配置和测试文件；
 - 除非人类明确授权，不要读取整个代码库。
 
 除非人类明确引用或授权，不要读取依赖目录、构建产物、覆盖率输出、锁文件
@@ -61,7 +56,7 @@
 
 ## 确认维度
 
-读取后，总结并请人类确认或修正这些点：
+读取后，请人类确认或修正：
 
 - 项目名称、目的和主要用户；
 - 一句话定位、最终形态和任务是否值得做的判断标准；
@@ -74,19 +69,18 @@
 - 持久约束、安全边界、兼容性要求和高风险区域；
 - 会影响后续任务精度的未知项。
 
-一次最多问 3 个问题。只问答案会改变项目身份、命令、边界、约束、风险、
-权限或验收的问题。
+最多问 3 个问题。只问会改变身份、命令、边界、约束、风险、权限或验收的问题。
 
 ## 输出规则
 
 - 未知事实标记为 `Unknown`；不要把猜测当成事实。
-- 如果本次引导吸收了 `ai/project/inbox/*.md` 或 `ai/project/inbox/raw/*.md`，
-  写入上下文后必须把已吸收资料移动到 `ai/project/inbox/processed/`。保留相对路径：
-  `ai/project/inbox/raw/file.md` 移动到 `ai/project/inbox/processed/raw/file.md`。
-  如果文件名冲突，保留原文件名并添加日期或序号。不要移动 `ai/project/inbox/ideas/**`。
+- 若本次吸收 `ai/project/inbox/*.md` 或 `ai/project/inbox/raw/*.md`，写入上下文后移到
+  `ai/project/inbox/processed/`，保留相对路径：`ai/project/inbox/raw/file.md` ->
+  `ai/project/inbox/processed/raw/file.md`。文件名冲突时加日期或序号。不要移动
+  `ai/project/inbox/ideas/**`。
 - 未吸收资料必须留在原位置，并在最终回复中说明原因。
-- 对 `final-shape.md`、`module-map.md`、`roadmap.md` 的初始化内容必须标明证据来源；
-  如果证据不足，保持占位或写 `Unknown`，不要编造愿景。
+- `final-shape.md`、`module-map.md`、`roadmap.md` 的初始化内容必须标明证据来源；
+  证据不足时保持占位或写 `Unknown`，不要编造愿景。
 - 有帮助时，在相关文件中记录证据来源。
 - 保持 `ai/project/project.md` 稳定、长期有效。
 - 保持 `ai/project/refs/*.md` 聚焦；不要把引用文件写成项目流水账。
@@ -95,11 +89,11 @@
 
 ## 引导后交接
 
-写完项目上下文草稿后，不要只要求人类打开文件检查。
-你必须在最终回复中给出可确认摘要，让人类可以直接在聊天里确认或修正。
+写完上下文草稿后，不要只要求人类打开文件检查。最终回复必须给出可确认摘要，
+让人类能直接在聊天里确认或修正。
 
-如果人类在引导请求中已经给出当前任务目标，你必须同时起草 `ai/project/task.md`，
-并把项目理解摘要和任务草稿摘要一起交给人类确认。
+如果引导请求已包含当前任务目标，必须同时起草 `ai/project/task.md`，
+并交付项目理解摘要和任务草稿摘要。
 
 如果人类没有给出当前任务目标，你必须根据项目现状推荐下一步最值得做的任务。
 
@@ -199,5 +193,5 @@
 - 修正：<你要改的地方>
 ```
 
-如果仍有重要未知项，只在“仍不确定”中列出最多 3 条。
+重要未知项只在“仍不确定”中列最多 3 条。
 不要让人类主动去文件管理器里寻找问题；文件路径只作为可追溯记录。

package/template/zh/ai/template/execution-policy.md

@@ -104,6 +104,9 @@ Checkpoint 只在以下情况输出：风险从 Green 变 Yellow/Red、即将扩
 
 ## 用户可见输出
 
+- 默认使用当前安装模板语言输出。`ai/template/LANG` 为 `zh` 时，用户可见的计划、
+  L1 清单、Checkpoint、任务草稿交接、阻塞说明和最终结果默认使用中文；只有用户
+  明确要求其他语言，或需要保留代码、命令、文件路径、协议字段原文时才使用其他语言。
 - 默认展示 L1 清单；不要默认展示完整 L2/L3/L4。
 - 展示风险结论和必要原因；不要输出长篇内部推理。
 - 展示证据；不要展示内部协议字段、完整 YAML、`checkpoint_budget` 或 `model_policy`。

package/template/zh/ai/template/prompt.md

@@ -1,9 +1,7 @@
 # AI 执行提示
 
 不要总结这个文件。
-执行下面的工作流。
-
-你正在 Agent Execution Template 工作区内操作。
+按下面流程执行。你正在 Agent Execution Template 工作区内操作。
 
 先读取：
 
@@ -11,54 +9,45 @@
 2. `ai/template/rules/core.md`
 3. `ai/template/execution-policy.md`
 
-然后选择模式：
+选择模式：
 
-- 如果用户要求更新北极星、最终形态、产品宪法、模块地图、路线图、项目方向，
-  或 `ai/project/inbox/ideas/` 里存在 `.gitkeep` 之外的待评估灵感，按 `strategy_update`
-  起草方向修订任务或直接生成提案，然后停止等待人类确认。
-- 如果用户明确确认某个
-  `ai/project/proposals/final-shape-updates/*.md` 可以合并，按
-  `apply_strategy_update` 起草或执行应用任务；如果 proposal 仍为
-  `proposed`，先根据这次明确确认更新为 `accepted`。
+- 用户要求更新北极星、最终形态、产品宪法、模块地图、路线图或项目方向，
+  或 `ai/project/inbox/ideas/` 有待评估灵感：走 `strategy_update`，生成提案后停下确认。
+- 用户明确确认某个 `ai/project/proposals/final-shape-updates/*.md` 可合并：
+  走 `apply_strategy_update`。若 proposal 仍为 `proposed`，先改为 `accepted`。
 - 如果用户说“开始初始化这个项目，并吸收 ai/project/inbox/ 里的资料”，
-  或要求初始化时一并吸收 `ai/project/inbox/` 里的资料，先检查
-  `ai/project/project.md`。如果它已经存在且不是空文件、占位内容或明显不完整，
-  执行 `ai/template/reconcile.md`，不要重新 bootstrap；如果它为空、只有占位内容或
-  明显不完整，执行 `ai/template/bootstrap.md`，并把 `ai/project/inbox/*.md` 与
-  `ai/project/inbox/raw/*.md` 视为本次引导输入的一部分；在项目上下文确认后停止。
-- 如果用户说“整合 ai/project/inbox/ 里的新资料”，要求整合/合并/吸收/
-  更新上下文/处理新资料，提到 `reconcile` 或 `ai/project/inbox/`，
-  或 `ai/project/inbox/` 里存在 `.gitkeep` 之外的待吸收资料，执行 `ai/template/reconcile.md`，
-  并按它的两阶段流程停止或更新；但 `ai/project/inbox/processed/` 是已处理资料，
-  不应触发整合，`ai/project/inbox/ideas/` 应优先走 `strategy_update`。即使用户说
-  “整合整个 inbox”，默认也只处理 `ai/project/inbox/*.md` 和
-  `ai/project/inbox/raw/*.md`。
+  或要求初始化时吸收 inbox：先检查 `ai/project/project.md`。若已存在且有效，
+  执行 `ai/template/reconcile.md`，不要重新 bootstrap；若为空、占位或不完整，执行
+  `ai/template/bootstrap.md`，并把 `ai/project/inbox/*.md` 与
+  `ai/project/inbox/raw/*.md` 纳入引导输入；上下文确认后停止。
+- 用户说“整合 ai/project/inbox/ 里的新资料”，要求整合/合并/吸收/更新上下文/处理新资料，提到 `reconcile` 或
+  `ai/project/inbox/`，或 inbox 有待吸收资料：执行 `ai/template/reconcile.md`。
+  `processed/` 不触发整合，`ideas/` 优先走 `strategy_update`。即使用户说
+  “整合整个 inbox”，也默认只处理 `ai/project/inbox/*.md` 和 `ai/project/inbox/raw/*.md`。
 - 如果用户说“开始初始化这个项目”、要求初始化/整理/生成项目上下文，
-  或 `ai/project/project.md` 为空、只有占位内容、
-  或不完整，执行 `ai/template/bootstrap.md`，并在项目上下文确认后停止。
-- 如果 `ai/project/task.md` 为空、只有占位内容、或不完整，根据用户当前目标和
-  已确认的项目上下文起草它，然后停止等待人类确认。
-- 如果用户说“继续推进这个项目”，且没有更具体目标，先全局判断当前最值得做的
-  下一步：优先处理待确认上下文、待确认任务、失败结果、未完成任务或明显风险；
-  然后给出建议或起草 `ai/project/task.md`，不要让人类自己去文件管理器里找问题。
-- 只有当 `ai/project/project.md` 和 `ai/project/task.md` 已经足够定义身份、
-  目标、范围、权限和验收时，才进入执行模式。
+  或 `ai/project/project.md` 为空、占位或不完整：执行 `ai/template/bootstrap.md`，
+  上下文确认后停止。
+- `ai/project/task.md` 为空、占位或不完整：按当前目标和已确认上下文起草任务，
+  然后停下确认。
+- 用户说“继续推进这个项目”且无更具体目标：先判断最值得做的下一步，优先处理
+  待确认上下文、待确认任务、失败结果、未完成任务或明显风险；给出建议或起草
+  `ai/project/task.md`，不要让人类自己找问题。
+- 只有当 `project.md` 和 `task.md` 足以定义身份、目标、范围、权限和验收时，
+  才进入执行模式。
 
 ## 任务草稿交接
 
 在任务草稿模式中：
 
 1. 读取已确认的 `ai/project/project.md` 和相关 `ai/project/refs/*.md`。
-2. 根据用户当前目标、项目上下文和仓库事实，推断目标、范围、验收、权限、
-   验证方式和初始风险；不要要求用户逐项提供。
+2. 根据用户目标、项目上下文和仓库事实推断目标、范围、验收、权限、验证方式和初始风险；
+   不要求用户逐项提供。
 3. 起草 `ai/project/task.md`，并将 `execution_policy.mode` 设为 `auto`。
-4. 执行前列出 L1 任务清单并标注 Green / Yellow / Red，同时写入
-   `execution_policy.task_tree`。L1 少于 2 个时使用 `normal`；L1 为 2 个或更多时
-   自动使用 `bounded_continuous`。
-5. 本轮如果新建或重写了 `ai/project/task.md`，将 `readiness` 设为
-   `draft_for_confirmation` 并停止交接；不要在任务仍是草稿时直接执行。
-6. 只有已有任务明确处于 `ready_to_execute`，且没有 Red 预检项时，才能进入执行模式；
-   如果不可执行，设为 `blocked`。
+4. 执行前列出 L1 清单并标注 Green / Yellow / Red，写入 `execution_policy.task_tree`。
+   L1 < 2 用 `normal`；L1 >= 2 自动用 `bounded_continuous`。
+5. 本轮新建或重写 `task.md` 时，将 `readiness` 设为 `draft_for_confirmation` 并停止；
+   草稿不能直接执行。
+6. 只有既有任务为 `ready_to_execute` 且无 Red 预检项，才进入执行；否则设为 `blocked`。
 7. 不要在任务草稿模式中修改源码或业务文件。
 
 任务草稿模式必须以下面结构结束：
@@ -108,15 +97,14 @@
 2. `ai/project/runtime.md`
 3. `ai/project/task.md`
 
-然后按 `ai/template/execution-policy.md` 做执行前规划：列出 L1 清单，给每个 L1
-标注 Green / Yellow / Red，并写入 `execution_policy.task_tree`。根据 L1 数量自动选择
-`normal` 或 `bounded_continuous`。只有 `readiness = ready_to_execute` 才能执行；
-如果本轮新建或重写任务契约，先停在确认交接。L1 必须是可独立验收的垂直切片。
-执行 L1 前规划 L2，执行 L2 前按需规划 L3；默认最多 3 层，必要时允许 L4。
-每完成一个 L1，在清单中打勾并划掉；开始或完成 L1、出现 Red/blocked、范围变化
-或最终收尾时写回 `task_tree`。只有 Red 停止等待人类确认；Green 自动继续，Yellow
-只做当前 L1/L2 内的局部低风险修正。用户可见输出遵守
-`ai/template/execution-policy.md` 的“用户可见输出”规则。最后把结果写入：
+然后按 `ai/template/execution-policy.md` 规划：列 L1，标注 Green / Yellow / Red，
+写入 `execution_policy.task_tree`，并按 L1 数量选择 `normal` 或 `bounded_continuous`。
+只有 `readiness = ready_to_execute` 才能执行；本轮新建或重写任务契约时先停下确认。
+L1 必须是可独立验收的垂直切片。执行 L1 前规划 L2，执行 L2 前按需规划 L3；
+默认最多 3 层，必要时允许 L4。每完成一个 L1，在清单中打勾并划掉；仅在 L1
+开始/完成、Red/blocked、范围变化或最终收尾时写回 `task_tree`。Red 停止确认；
+Green 自动继续；Yellow 只做当前 L1/L2 内的局部低风险修正。用户可见输出遵守
+“用户可见输出”规则。最后写入：
 
 - `ai/project/result.json`
 - `ai/project/result.md`

package/template/zh/ai/template/protocol.md

@@ -1,16 +1,16 @@
 # 协议
 
-Agent Execution Template v0.8 将可复用协议和项目专属执行上下文分开。
+Agent Execution Template v0.8 分离可复用协议和项目现场。
 
 ```text
 ai/template/ = 可复用执行协议
 ai/project/  = 当前项目执行工作区
 ```
 
-`template` 是协议，`project` 是现场工作区。
+`template` 是协议，`project` 是现场。
 
-项目现场不仅保存当前任务，也保存方向层。方向层用于回答“为什么做、往哪里长”，
-执行层用于回答“这次做什么、如何验收”。
+项目现场同时保存任务和方向层。方向层回答“为什么做、往哪里长”，执行层回答
+“这次做什么、如何验收”。
 
 ```text
 ai/project/refs/final-shape.md = 项目北极星说明书
@@ -26,15 +26,14 @@ ai/project/task.md             = 当前执行契约
 ```
 
 1. 项目发现时，执行 `ai/template/bootstrap.md`；不要总结它。
-2. 引导结束时使用“引导后交接”，在聊天里给出可确认摘要和推荐下一步，
-   不要只要求人类打开文件检查。
+2. 引导结束用“引导后交接”，在聊天里给可确认摘要和推荐下一步，不只要求人类打开文件。
 3. 任务执行时，执行 `ai/template/prompt.md`；不要总结它。
-4. 当出现新的权威资料时，放入 `ai/project/inbox/`，执行 `ai/template/reconcile.md`；
-   不要总结它。整合必须先出计划，等确认后再更新上下文。
-5. 当出现会改变项目最终形态、模块边界或路线图的灵感时，先放入
-   `ai/project/inbox/ideas/`，再创建 `strategy_update` 任务生成提案。
-6. 只有人类确认提案后，才能创建 `apply_strategy_update` 任务修改
-   `final-shape.md`、`module-map.md` 或 `roadmap.md`。
+4. 新权威资料放入 `ai/project/inbox/`，执行 `ai/template/reconcile.md`；不要总结它。
+   整合先出计划，确认后更新上下文。
+5. 会改变最终形态、模块边界或路线图的灵感先放入 `ai/project/inbox/ideas/`，
+   再用 `strategy_update` 生成提案。
+6. 人类确认提案后，才可用 `apply_strategy_update` 修改 `final-shape.md`、
+   `module-map.md` 或 `roadmap.md`。
 7. 如果 `ai/project/task.md` 缺失或不完整，根据当前目标和已确认的项目上下文起草它，
    然后用“任务草稿交接”停止。
 8. 任务确认后，检查就绪度、风险、模型策略、引用、权限和验收。
@@ -45,12 +44,10 @@ ai/project/task.md             = 当前执行契约
 
 任务执行前必须读取 `ai/template/execution-policy.md`。
 
-执行策略默认是 `auto`：AI 先拆 L1 任务并判断 Green / Yellow / Red，再决定使用
-`normal` 或 `bounded_continuous`。L1 少于 2 个使用 `normal`；L1 为 2 个或更多
-自动启用 `bounded_continuous`。L1 必须是可独立验收的垂直切片。只有
-`readiness = ready_to_execute` 的既有任务才能执行；本轮新建或重写任务契约时先
-停在确认交接。只有 Red 停止等待人类确认，Yellow 只允许当前 L1/L2 内的局部
-低风险修正。
+默认 `auto`：AI 先拆 L1 并判断 Green / Yellow / Red，再选择 `normal` 或
+`bounded_continuous`。L1 < 2 用 `normal`；L1 >= 2 自动启用 `bounded_continuous`。
+L1 必须是可独立验收的垂直切片。只有既有任务 `readiness = ready_to_execute` 才能执行；
+本轮新建或重写任务契约时先停下确认。Red 停止确认，Yellow 只允许当前 L1/L2 内的局部低风险修正。
 
 任务树、风险分级、Checkpoint 证据和 `task_tree` 写回规则由
 `ai/template/execution-policy.md` 定义。
@@ -62,17 +59,16 @@ ai/project/task.md             = 当前执行契约
 - `ai/project/project.md`
 - `ai/project/refs/*.md`
 
-当 `ai/project/project.md` 为空、只有占位内容、过期、不完整，或用户要求整理项目上下文时，
-使用引导模式。
+当 `project.md` 为空、占位、过期、不完整，或用户要求整理上下文时，使用引导模式。
 
 引导模式必须：
 
 - 先只读取批准的引导来源；
 - 将稳定项目事实总结到 `ai/project/project.md`；
-- 当能推断持久架构、命令、约束或决策事实时，更新聚焦的引用文件；
+- 能推断持久架构、命令、约束或决策事实时，更新聚焦引用文件；
 - 只有在人类同时提供当前任务时，才创建 `ai/project/task.md`，且只起草任务契约；
 - 将未知事实标记为 `Unknown`，不要猜测；
-- 只有答案会改变范围、风险、权限或验收时，最多问 3 个问题；
+- 只有答案会改变范围、风险、权限或验收时，才问问题，最多 3 个；
 - 写完项目上下文草稿后停止；如果已提供当前任务，也可以同时写任务草稿后停止；
 - 永远不要编辑源码、业务、配置、依赖或生成文件。
 
@@ -102,12 +98,12 @@ ai/project/task.md             = 当前执行契约
 5. 浅层仓库结构：
    - 只查看源码、测试、配置和文档目录。
 
-如果文档和清单缺失或不足，可以有限读取代码进行推断：
+文档和清单不足时，可有限读取代码推断：
 
 - 先检查顶层目录和文件名；
 - 检查可能的入口目录，例如 `src/`、`app/`、`lib/`、`packages/`、
   `services/`、`cmd/`、`internal/`、`server/`、`client/`、`test/`、`tests/`；
-- 只读取足够识别项目目的、模块边界、命令和约束的路由、模块、配置和测试文件；
+- 只读取足够识别目的、模块边界、命令和约束的路由、模块、配置和测试文件；
 - 除非人类明确授权，不要读取整个代码库。
 
 默认不要读取：
@@ -118,7 +114,7 @@ ai/project/task.md             = 当前执行契约
 - `.env*` 等密钥或环境文件；
 - 归档或历史目录，除非用户明确引用。
 
-如果仓库很大，先读取根目录文档和清单文件，再询问是否扩展读取范围。
+仓库很大时，先读根文档和清单，再询问是否扩展读取范围。
 
 ### 引导输出
 
@@ -160,8 +156,8 @@ ai/project/task.md             = 当前执行契约
 
 - `ai/project/task.md`
 
-当项目上下文已确认，但 `ai/project/task.md` 为空、只有占位内容、不完整，
-或人类提供了新的任务目标且引导模式尚未起草任务时，使用任务草稿模式。
+项目上下文已确认但 `task.md` 为空、占位、不完整，或人类提供新任务且引导尚未起草时，
+使用任务草稿模式。
 
 任务草稿模式应该：
 
@@ -175,7 +171,7 @@ ai/project/task.md             = 当前执行契约
 
 ## 上下文整合模式
 
-上下文整合模式吸收新的权威资料，并修正现有长期上下文。
+上下文整合模式吸收新权威资料，修正长期上下文。
 
 新资料优先放入：
 
@@ -184,21 +180,20 @@ ai/project/task.md             = 当前执行契约
 
 已整合资料统一移动到 `ai/project/inbox/processed/`，默认不再作为待吸收资料读取。
 
-用户可以直接说“整合 ai/project/inbox/ 里的新资料”。使用上下文整合模式时，
-执行 `ai/template/reconcile.md`。
+用户可直接说“整合 ai/project/inbox/ 里的新资料”。整合时执行 `ai/template/reconcile.md`。
 
 上下文整合模式必须：
 
 - 读取现有 `ai/project/project.md`、`ai/project/runtime.md` 和 `ai/project/refs/*.md`；
 - 读取人类指定的新资料；未指定时读取 `ai/project/inbox/*.md`；
 - 先输出整合计划，不修改文件；
-- 等人类确认后，才更新 `ai/project/project.md`、`ai/project/runtime.md` 和 `ai/project/refs/*.md`；
+- 人类确认后，才更新 `ai/project/project.md`、`ai/project/runtime.md` 和 `ai/project/refs/*.md`；
 - 应用整合后，把本次已处理的 `ai/project/inbox/*.md` 移动到 `ai/project/inbox/processed/`；
 - 不要默认修改 `task.md`、`result.*`、`metrics.json`、源码、测试、配置或依赖文件；
 - 不要把新资料整段塞进 refs，而是吸收长期有效、结构化、可复用的事实。
 
-如果新资料会改变 `final-shape.md`、`module-map.md` 或 `roadmap.md` 的方向性内容，
-上下文整合只能提出 `strategy_update` 建议，不能直接修改这些文件。
+新资料若改变 `final-shape.md`、`module-map.md` 或 `roadmap.md` 的方向性内容，
+整合只能建议 `strategy_update`，不能直接修改。
 
 ## 策略修订模式
 

package/template/zh/ai/template/reconcile.md

@@ -1,16 +1,13 @@
 # AI 上下文整合
 
 不要总结这个文件。
-执行下面的上下文整合流程。
-
-你正在把新的权威资料吸收到现有 Agent Execution Template 项目上下文中。
-这不是重新引导，也不是全量覆盖。
+按下面流程把新权威资料吸收到现有项目上下文。不是重新引导，也不是全量覆盖。
 
 目标：合并新资料中的长期有效事实，修正过期或不准确的旧上下文，保留仍然正确的既有内容。
 
 ## 适用场景
 
-当项目已经使用一段时间后，出现更完整、更权威的业务、产品、架构或流程资料时，使用本流程。
+当出现更完整、更权威的业务、产品、架构或流程资料时，使用本流程。
 
 新资料默认放在：
 
@@ -18,10 +15,10 @@
 - `ai/project/inbox/raw/*.md`
 - `docs/**`
 
-`ai/project/inbox/` 是待吸收资料区。资料被整合确认后，统一移动到
-`ai/project/inbox/processed/`，用于追溯并避免后续重复整合。
-即使用户说“整合整个 inbox”，默认也只处理 `ai/project/inbox/*.md`
-和 `ai/project/inbox/raw/*.md`；不要递归读取 `processed/**` 或 `ideas/**`。
+`ai/project/inbox/` 是待吸收区。资料确认整合后移到 `ai/project/inbox/processed/`，
+用于追溯并避免重复整合。即使用户说“整合整个 inbox”，也默认只处理
+`ai/project/inbox/*.md` 和 `ai/project/inbox/raw/*.md`；不要递归读取
+`processed/**` 或 `ideas/**`。
 
 ## 先读
 
@@ -33,13 +30,13 @@
 6. 人类指定的新资料；未指定时，只读取 `ai/project/inbox/*.md`
    和 `ai/project/inbox/raw/*.md`
 
-不要默认读取 `ai/project/inbox/processed/**`、`ai/project/inbox/ideas/**`、
-`ai/project/archive/**`、源码、测试、配置或依赖文件，除非人类明确要求用它们核对事实。
+不要默认读取 `processed/**`、`ideas/**`、`archive/**`、源码、测试、配置或依赖；
+除非人类明确要求用它们核对事实。
 
 ## 整合原则
 
-- 不要直接覆盖整套文件。
-- 保留仍然正确的既有上下文。
+- 不整套覆盖。
+- 保留仍正确的既有上下文。
 - 将新资料拆分进合适位置：
   - 项目身份、用户、稳定约定 -> `ai/project/project.md`
   - 当前仍有效的执行上下文 -> `ai/project/runtime.md`
@@ -50,10 +47,9 @@
   - 命令 -> `ai/project/refs/commands.md`
   - 约束 -> `ai/project/refs/constraints.md`
   - 持久决策 -> `ai/project/refs/decisions.md`
-- 不要把 `refs/*` 写成原文堆砌；只吸收结构化、长期有效、可复用的内容。
-- 如果新资料会改变北极星、模块地图或路线图的方向性内容，只能建议创建
-  `strategy_update` 提案，不要在上下文整合中直接修改这些方向文件。
-- `task.md`、`result.json`、`result.md`、`metrics.json` 通常不参与业务上下文整合，除非人类明确要求吸收其中仍长期有效的事实。
+- `refs/*` 不堆原文；只吸收结构化、长期有效、可复用的内容。
+- 新资料若改变北极星、模块地图或路线图，只建议创建 `strategy_update`，不要直接改方向文件。
+- `task.md`、`result.json`、`result.md`、`metrics.json` 通常不参与整合；除非人类明确要求吸收其中的长期事实。
 
 ## 两阶段流程
 
@@ -70,13 +66,11 @@
 5. 需要人类确认的问题，最多 3 个
 6. 预计会更新的文件
 
-如果没有需要确认的问题，明确写“无需额外确认”。
-
-阶段 1 结束时必须停止，等待人类确认。
+无问题时写“无需额外确认”。阶段 1 结束必须停止，等待确认。
 
 ### 阶段 2：应用整合
 
-只有在人类明确确认整合计划后，才更新文件。
+只有人类确认整合计划后才更新文件。
 
 允许更新：
 
@@ -97,15 +91,14 @@
 - `ai/project/metrics.json`
 - `ai/project/archive/**`
 
-应用整合完成后，必须把本次已整合的 `ai/project/inbox/*.md` 和
-`ai/project/inbox/raw/*.md` 资料移动到 `ai/project/inbox/processed/`。保留相对路径：
-`ai/project/inbox/raw/file.md` 移动到 `ai/project/inbox/processed/raw/file.md`。
-如果文件名冲突，保留原文件名并添加日期或序号。不要移动
-`ai/project/inbox/ideas/**`；方向灵感应继续走 `strategy_update`。
+整合完成后，把本次已整合的 `ai/project/inbox/*.md` 和 `ai/project/inbox/raw/*.md`
+移到 `ai/project/inbox/processed/`，保留相对路径：`ai/project/inbox/raw/file.md` ->
+`ai/project/inbox/processed/raw/file.md`。文件名冲突时加日期或序号。不要移动 `ideas/**`；
+方向灵感继续走 `strategy_update`。
 
 ## 最终交接
 
-应用整合后，最终回复必须包含：
+应用后，最终回复包含：
 
 ```text
 上下文整合已完成。
@@ -142,4 +135,4 @@
 - 修正：<你要改的地方>
 ```
 
-不要让人类自己去文件管理器里寻找变化；文件路径只作为可追溯记录。
+不要让人类自己找变化；文件路径只作追溯。

package/template/zh/ai/template/rules/core.md

@@ -2,7 +2,7 @@
 
 ## 就绪门
 
-编辑代码前，检查 `ai/project/task.md` 是否清楚定义：
+编辑前，确认 `ai/project/task.md` 已清楚定义：
 
 - 目标
 - 范围
@@ -18,8 +18,8 @@
 
 ## 引导门
 
-如果 `ai/project/project.md` 为空、只有占位内容、不完整，或用户要求整理项目上下文，
-先执行 `ai/template/bootstrap.md`，再进入执行。
+若 `ai/project/project.md` 为空、占位、不完整，或用户要求整理上下文，先执行
+`ai/template/bootstrap.md`。
 
 引导模式只能写项目上下文文件：
 
@@ -32,14 +32,13 @@
 - `ai/project/refs/constraints.md`
 - `ai/project/refs/decisions.md`
 
-只有在人类同时提供当前任务目标时，引导模式才可以写 `ai/project/task.md`。
-此时只能起草任务契约，不能进入实现。
+只有人类同时提供当前任务目标时，引导模式才可写 `ai/project/task.md`；只能起草，不实现。
 
-引导模式不得编辑源码、测试、配置、依赖文件、生成文件、运行时文件、结果文件或指标文件。
+引导模式不得编辑源码、测试、配置、依赖、生成文件、运行时、结果或指标文件。
 
 写完引导草稿后，使用 `ai/template/bootstrap.md` 中的“引导后交接”停止。
 交接必须在聊天里给出可确认摘要和推荐下一步，不要只让人类打开文件检查。
-如果人类已经提供当前任务目标，可以同轮起草 `ai/project/task.md`，但仍必须停止等待确认，不能进入实现。
+若人类已提供任务目标，可同轮起草 `task.md`，但仍必须停止确认，不能实现。
 
 ## 引导读取范围
 
@@ -60,9 +59,8 @@
 
 ## 任务草稿门
 
-如果项目上下文已确认，但 `ai/project/task.md` 为空、只有占位内容、不完整，
-或人类提供了新的任务目标，根据已确认的项目上下文起草 `ai/project/task.md`，
-并在实现前停止等待人类确认。
+项目上下文已确认但 `task.md` 为空、占位、不完整，或人类提供新任务目标时，
+按已确认上下文起草 `task.md`，实现前停止确认。
 
 任务草稿模式只能写：
 
@@ -72,8 +70,8 @@
 
 ## 上下文整合门
 
-如果用户提供新的权威业务、产品、架构或流程资料，并希望合并到既有上下文，
-或说“整合 ai/project/inbox/ 里的新资料”，执行 `ai/template/reconcile.md`，
+用户提供新权威业务、产品、架构或流程资料并希望合并，或说
+“整合 ai/project/inbox/ 里的新资料”时，执行 `ai/template/reconcile.md`。
 不要重新 bootstrap，也不要全量覆盖。
 
 新资料优先放在：
@@ -84,7 +82,7 @@
 
 已整合资料统一移动到 `ai/project/inbox/processed/`，默认不再触发上下文整合。
 
-上下文整合必须先输出整合计划，等待人类确认后才更新文件。
+上下文整合必须先给计划，等确认后再更新文件。
 
 上下文整合默认只能更新：
 
@@ -92,8 +90,7 @@
 - `ai/project/runtime.md`
 - `ai/project/refs/*.md`
 
-如果新资料会改变北极星、模块地图或路线图的方向性内容，只能建议创建
-`strategy_update` 提案，不能在上下文整合中直接修改：
+新资料若改变北极星、模块地图或路线图，只能建议创建 `strategy_update`，不能直接改：
 
 - `ai/project/refs/final-shape.md`
 - `ai/project/refs/module-map.md`
@@ -103,13 +100,12 @@
 
 ## 边界内连续执行门
 
-每次执行前，AI 必须读取 `ai/template/execution-policy.md`，先做任务分解和风险判断，
-而不是等待用户显式说“启用连续执行”。
+每次执行前，AI 必须读取 `ai/template/execution-policy.md`，先分解任务并判断风险，
+不等用户说“启用连续执行”。
 
 硬门禁：
 
-- 只有 `ai/project/task.md.readiness = ready_to_execute` 才能执行；本轮新建或重写
-  `task.md` 时必须停在确认交接。
+- 只有 `task.md.readiness = ready_to_execute` 才能执行；本轮新建或重写 `task.md` 时必须停下确认。
 - L1 必须是可独立验收的垂直切片，不是机械步骤清单。
 - `execution_policy.task_tree` 必须记录 L1 清单和执行状态。
 - 每个任务节点必须有 Green / Yellow / Red 风险评级。
@@ -117,8 +113,8 @@
   权限、安全、架构方向或验收标准。
 - 每个 Checkpoint 必须包含证据；不接受只有主观判断的 Green。
 - Red 必须停止等待人类确认。
-- 任何方向、核心架构、公共 API、持久化数据结构、安全、支付、账号、权限、大量删除、
-  核心重写或高成本方案取舍，都必须停止。
+- 涉及方向、核心架构、公共 API、持久化数据、安全、支付、账号、权限、大量删除、
+  核心重写或高成本取舍时，必须停止。
 - 需要扩大范围、权限、命令、网络或验收时，必须停止。
 - `task_tree` 写回应集中在 L1 开始/完成、Red、blocked、范围变化和最终收尾，
   不要为每个微小 L3 操作写回。
@@ -128,9 +124,8 @@
 
 ## 策略修订门
 
-如果用户要求更新项目北极星、最终形态、产品宪法、模块地图、路线图或项目方向，
-或 `ai/project/inbox/ideas/` 中存在 `.gitkeep` 之外的新灵感，执行
-`strategy_update`。
+用户要求更新北极星、最终形态、产品宪法、模块地图、路线图或项目方向，或
+`ai/project/inbox/ideas/` 有新灵感时，执行 `strategy_update`。
 
 `strategy_update` 只能：
 

package/template/zh/ai/template/rules/output.md

@@ -25,7 +25,9 @@
 
 ## 结果 Markdown
 
-`ai/project/result.md` 是给人看的摘要。保持简短：
+`ai/project/result.md` 是给人看的摘要。保持简短，并默认使用 `ai/template/LANG`
+指定的安装语言。中文模板下，标题和说明默认用中文；代码、命令、文件路径和协议字段
+保留原文。
 
 ```md
 ## 状态

package/test/selftest.js

@@ -54,6 +54,8 @@ function testInitUpdateDoctor() {
   assert(exists(cwd, "ai/template/execution-policy.md"), "init should create execution policy prompt");
   assert(exists(cwd, "ai/template/prompt.md"), "init should create template prompt");
   assert(exists(cwd, "ai/template/reconcile.md"), "init should create template reconcile prompt");
+  assert(exists(cwd, "ai/template/schemas/result.schema.json"), "init should create result schema");
+  assert(exists(cwd, "ai/template/schemas/metrics.schema.json"), "init should create metrics schema");
   assert(exists(cwd, "ai/project/inbox/.gitkeep"), "init should create inbox directory");
   assert(exists(cwd, "ai/project/project.md"), "init should create project.md");
   assert(exists(cwd, "ai/project/task.md"), "init should create task.md");
@@ -81,7 +83,7 @@ function testInitUpdateDoctor() {
   assert(read(cwd, "ai/template/prompt.md").includes("ai/template/execution-policy.md"), "execution prompt should read execution policy");
   assert(read(cwd, "ai/template/execution-policy.md").includes("风险分级"), "execution policy should include risk rubric");
   assert(read(cwd, "ai/template/execution-policy.md").includes("execution_policy.task_tree"), "execution policy should require task tree persistence");
-  assert(read(cwd, "ai/template/prompt.md").includes("默认也只处理 `ai/project/inbox/*.md`"), "execution prompt should narrow inbox reconciliation");
+  assert(read(cwd, "ai/template/prompt.md").includes("也默认只处理 `ai/project/inbox/*.md`"), "execution prompt should narrow inbox reconciliation");
   assert(read(cwd, "ai/template/protocol.md").includes("`bounded_continuous`"), "protocol should include bounded continuous execution");
   assert(read(cwd, "ai/template/execution-policy.md").includes("垂直切片"), "protocol should require vertical-slice progress for continuous execution");
   assert(read(cwd, "ai/template/execution-policy.md").includes("可独立验收的垂直切片"), "execution policy should define L1 granularity");
@@ -89,6 +91,8 @@ function testInitUpdateDoctor() {
   assert(read(cwd, "ai/template/execution-policy.md").includes("不要为每个微小 L3 操作写回"), "execution policy should limit task tree write-back churn");
   assert(read(cwd, "ai/template/execution-policy.md").includes("公共接口、数据模型、权限、安全"), "execution policy should constrain Yellow corrections");
   assert(read(cwd, "ai/template/execution-policy.md").includes("用户可见输出"), "execution policy should define user-visible output rules");
+  assert(read(cwd, "ai/template/execution-policy.md").includes("用户可见的计划"), "execution policy should keep user-visible planning in the installed language");
+  assert(read(cwd, "ai/template/rules/output.md").includes("默认使用 `ai/template/LANG`"), "output rules should keep human-readable results in the installed language");
   assert(read(cwd, "ai/template/execution-policy.md").includes("不要默认展示完整 L2/L3/L4"), "execution policy should avoid exposing full subtask trees by default");
   assert(read(cwd, "ai/template/execution-policy.md").includes("不要展示内部协议字段"), "execution policy should hide internal protocol details by default");
   assert(read(cwd, "ai/template/execution-policy.md").includes("L1 为 2 个或更多，自动启用"), "protocol should auto-enable continuous execution from L1 count");
@@ -110,12 +114,12 @@ function testInitUpdateDoctor() {
   assert(read(cwd, "ai/template/prompt.md").includes("不要重新 bootstrap"), "execution prompt should reconcile inbox material when project context already exists");
   assert(read(cwd, "ai/template/prompt.md").includes("整合 ai/project/inbox/ 里的新资料"), "execution prompt should route natural reconcile entry");
   assert(read(cwd, "ai/template/prompt.md").includes("继续推进这个项目"), "execution prompt should route natural continue entry");
-  assert(read(cwd, "ai/template/prompt.md").includes("不要在任务仍是草稿时直接执行"), "execution prompt should stop after drafting a task");
+  assert(read(cwd, "ai/template/prompt.md").includes("草稿不能直接执行"), "execution prompt should stop after drafting a task");
   assert(read(cwd, "ai/template/prompt.md").includes("用户可见输出"), "execution prompt should reference user-visible output rules");
   assert(read(cwd, "ai/template/prompt.md").includes("strategy_update"), "execution prompt should route strategy updates");
   assert(read(cwd, "ai/template/reconcile.md").includes("上下文整合"), "init should install reconcile prompt");
   assert(read(cwd, "ai/template/reconcile.md").includes("整合计划"), "reconcile prompt should require a plan first");
-  assert(read(cwd, "ai/template/reconcile.md").includes("不要递归读取 `processed/**` 或 `ideas/**`"), "reconcile prompt should exclude processed and ideas recursively");
+  assert(read(cwd, "ai/template/reconcile.md").includes("不要递归读取") && read(cwd, "ai/template/reconcile.md").includes("`processed/**` 或 `ideas/**`"), "reconcile prompt should exclude processed and ideas recursively");
   assert(read(cwd, "ai/template/reconcile.md").includes("ai/project/inbox/processed/raw/file.md"), "reconcile prompt should archive absorbed raw inbox material");
   assert(read(cwd, "ai/template/reconcile.md").includes("未吸收资料"), "reconcile handoff should audit unabsorbed material");
   assert(read(cwd, "ai/template/reconcile.md").includes("冲突处理"), "reconcile handoff should audit conflict handling");
@@ -153,7 +157,9 @@ function testInitUpdateDoctor() {
 
   const doctorOutput = run(["doctor"], cwd);
   assert(doctorOutput.includes("ai/project/result.json JSON"), "doctor should validate result JSON");
+  assert(doctorOutput.includes("ai/project/result.json schema"), "doctor should validate result schema");
   assert(doctorOutput.includes("ai/project/metrics.json JSON"), "doctor should validate metrics JSON");
+  assert(doctorOutput.includes("ai/project/metrics.json schema"), "doctor should validate metrics schema");
   assert(doctorOutput.includes("ai/project/task.md front matter"), "doctor should validate task front matter");
 }
 
@@ -163,6 +169,8 @@ function testEnglishInitUpdateDoctor() {
   const initOutput = run(["init", "--lang", "en"], cwd);
   assert(read(cwd, "ai/template/LANG") === "en\n", "init --lang en should install English template");
   assert(exists(cwd, "ai/template/execution-policy.md"), "English init should create execution policy prompt");
+  assert(exists(cwd, "ai/template/schemas/result.schema.json"), "English init should create result schema");
+  assert(exists(cwd, "ai/template/schemas/metrics.schema.json"), "English init should create metrics schema");
   assert(read(cwd, "ai/template/bootstrap.md").includes("Confirmation Dimensions"), "English init should install English bootstrap prompt");
   assert(read(cwd, "ai/template/bootstrap.md").includes("Do not summarize this file"), "English bootstrap prompt should prevent summary-only behavior");
   assert(read(cwd, "ai/template/bootstrap.md").includes("ai/project/refs/final-shape.md"), "English bootstrap prompt should initialize the North Star");
@@ -186,6 +194,8 @@ function testEnglishInitUpdateDoctor() {
   assert(read(cwd, "ai/template/execution-policy.md").includes("every tiny L3 operation"), "English execution policy should limit task tree write-back churn");
   assert(read(cwd, "ai/template/execution-policy.md").includes("public interfaces, data models, permissions"), "English execution policy should constrain Yellow corrections");
   assert(read(cwd, "ai/template/execution-policy.md").includes("User-Visible Output"), "English execution policy should define user-visible output rules");
+  assert(read(cwd, "ai/template/execution-policy.md").includes("user-visible plans"), "English execution policy should keep user-visible planning in the installed language");
+  assert(read(cwd, "ai/template/rules/output.md").includes("installed language from `ai/template/LANG`"), "English output rules should keep human-readable results in the installed language");
   assert(read(cwd, "ai/template/execution-policy.md").includes("do not show full L2/L3/L4 by default"), "English execution policy should avoid exposing full subtask trees by default");
   assert(read(cwd, "ai/template/execution-policy.md").includes("do not show internal protocol fields"), "English execution policy should hide internal protocol details by default");
   assert(read(cwd, "ai/template/execution-policy.md").includes("Automatically use `bounded_continuous`"), "English protocol should auto-enable continuous execution from L1 count");
@@ -241,6 +251,7 @@ function testEnglishInitUpdateDoctor() {
   const doctorOutput = run(["doctor"], cwd);
   assert(doctorOutput.includes("Template language: en"), "doctor should show installed English language");
   assert(doctorOutput.includes("ai/project/result.json JSON"), "English doctor should validate result JSON");
+  assert(doctorOutput.includes("ai/project/result.json schema"), "English doctor should validate result schema");
   assert(doctorOutput.includes("ai/project/task.md front matter"), "English doctor should validate task front matter");
   assert(doctorOutput.includes("[OK] Ready to run"), "doctor should use installed English language");
   const reconcileOutput = run(["reconcile"], cwd);
@@ -271,6 +282,60 @@ function testDoctorFailureAndWarning() {
   const invalidJsonOutput = run(["doctor"], invalidJsonCwd, 1);
   assert(invalidJsonOutput.includes("JSON 无效"), "doctor should fail invalid result JSON");
 
+  const invalidResultSchemaCwd = createTempProject("agent-execution-template-invalid-result-schema");
+  run(["init"], invalidResultSchemaCwd);
+  write(invalidResultSchemaCwd, "ai/project/result.json", JSON.stringify({
+    protocol_version: "0.8",
+    status: "success",
+    scope_followed: true,
+    files_read: [],
+    refs_read: [],
+    files_changed: [],
+    commands_run: [],
+    verification: {
+      level: "none",
+      passed: false,
+      evidence: []
+    },
+    assumptions: [],
+    issues: [],
+    next: [],
+    runtime_update: {
+      required: false,
+      changes: [],
+      reason: ""
+    }
+  }, null, 2));
+  const invalidResultSchemaOutput = run(["doctor"], invalidResultSchemaCwd, 1);
+  assert(invalidResultSchemaOutput.includes("不符合协议 schema"), "doctor should fail result schema violations");
+  assert(invalidResultSchemaOutput.includes("$.verification.passed must be true"), "doctor should enforce success verification");
+
+  const invalidMetricsSchemaCwd = createTempProject("agent-execution-template-invalid-metrics-schema");
+  run(["init"], invalidMetricsSchemaCwd);
+  write(invalidMetricsSchemaCwd, "ai/project/metrics.json", JSON.stringify({
+    protocol_version: "0.8",
+    task_id: "",
+    task_type: "",
+    model: "",
+    model_tier: "cheap",
+    escalated: true,
+    escalation_reason: "",
+    model_policy_followed: true,
+    escalation_trigger_hit: "",
+    strong_model_role: "",
+    input_tokens_estimated: 0,
+    output_tokens_estimated: 0,
+    duration_minutes: 0,
+    success: false,
+    human_fix_required: false,
+    failure_reason: "",
+    reuse_potential: "low",
+    notes: []
+  }, null, 2));
+  const invalidMetricsSchemaOutput = run(["doctor"], invalidMetricsSchemaCwd, 1);
+  assert(invalidMetricsSchemaOutput.includes("不符合协议 schema"), "doctor should fail metrics schema violations");
+  assert(invalidMetricsSchemaOutput.includes("$.escalation_reason must have length >= 1"), "doctor should enforce escalated metrics details");
+
   const taskWarnCwd = createTempProject("agent-execution-template-task-frontmatter");
   run(["init"], taskWarnCwd);
   write(taskWarnCwd, "ai/project/task.md", "# Task only\n");