@shirayner/ace 0.1.0 → 0.1.1-snapshot.0

package/{README.zh-CN.md → README.en-US.md}

@@ -30,10 +30,20 @@ Done! Your AI coding environment is ready.
 ### Spec 驱动开发
 
 ```
-$ ace spec init ./my-project
+# 进入工作目录
+$ mkdir my-project
+$ cd my-project
+
+# 执行 aspec 初始化
+$ ace spec init
 ✔ openspec config installed
 ✔ spec templates installed (taxonomy, issues, procedures, evolution)
 Done! Spec workflow is ready.
+
+# 三命令 spec coding 流程：
+/opsx:proposal   → 需求澄清 + 创建提案 + 技术澄清 + 确定方案
+/opsx:apply      → 按方案逐项实现，每步验证
+/opsx:archive    → spec 归档，复盘总结，知识库三层进化
 ```
 
 Claude Code 开箱即用已经很强大——但手动配置规则、技能、安全守卫和记忆模板既繁琐又容易出错。

package/README.md

@@ -1,100 +1,313 @@
-[English](README.md) | [中文](README.zh-CN.md)
+# `<img src="https://raw.githubusercontent.com/shirayner/ace/main/assets/logo.svg" width="48" align="center">` ACE
 
-<div align="center">
+<p align="center">
+  <b>AI Coding Environment</b> — 一键配置专业级 Claude Code 开发环境
+</p>
 
-# ace
+<p align="center">
+  <a href="https://www.npmjs.com/package/@shirayner/ace"><img src="https://img.shields.io/npm/v/@shirayner/ace?style=flat-square&color=blue" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/@shirayner/ace?style=flat-square&color=green" alt="license"></a>
+  <a href="package.json"><img src="https://img.shields.io/node/v/@shirayner/ace?style=flat-square&color=orange" alt="Node.js"></a>
+  <a href="#"><img src="https://img.shields.io/badge/Claude%20Code-Compatible-purple?style=flat-square" alt="Claude Code"></a>
+</p>
 
-**One command to set up your Claude Code harness.**
+<p align="center">
+  <a href="README.zh-CN.md">中文</a> | 
+  <a href="docs/getting-started/index.md">快速开始</a> | 
+  <a href="docs/why-ace/index.md">为什么选 ACE</a> | 
+  <a href="docs/architecture/index.md">架构详解</a> | 
+  <a href="docs/theory/index.md">理论基础</a>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/@shirayner/ace)](https://www.npmjs.com/package/@shirayner/ace)
-[![license](https://img.shields.io/github/license/shirayner/ace)](LICENSE)
-[![Node.js](https://img.shields.io/node/v/@shirayner/ace)](package.json)
+---
 
-</div>
+## 🎯 什么是 ACE？
 
-## What it looks like
+ACE 是一个**AI 开发环境配置工具**，基于 Claude Code 官方最佳实践构建，融合认知科学、控制论、软件工程等领域的深度理论，为开发者提供：
 
+- 🧠 **认知增强规则** — 8 条基于认知科学的深度思考与代码质量原则
+- 🤖 **专业级 AI Skills** — 4 个面向不同开发场景的智能技能
+- 🛡️ **安全防护体系** — Hookify 守卫 + 角色脚本双重保障
+- 📝 **规范驱动工作流** — OpenSpec 集成的需求管理体系
+- 🧩 **跨会话记忆系统** — 持久化的开发者画像与项目记忆
+
+```bash
+# 一键安装，即刻拥有专业级 AI 开发环境
+npm install -g @shirayner/ace
+ace init
 ```
+
+---
+
+## ✨ 一分钟速览
+
+### 初始化向导
+
+```bash
 $ ace init
-? Your role: Fullstack Developer
-? Preset: full
-✔ core installed
-✔ rules installed
-✔ plugin installed (ace:auto-goal, ace:coding, ...)
-✔ hookify installed
-✔ hooks installed
-✔ memory installed
-Done! Your AI coding environment is ready.
+? 选择你的角色: Fullstack Developer
+? 选择安装预设: full (完整功能)
+✓ Core 核心配置已安装
+✓ 8 条认知规则已部署
+✓ 4 个 AI Skills 已激活 (ace:auto-goal, ace:coding, ...)
+✓ Hookify 安全守卫已启用
+✓ 角色钩子脚本已配置
+✓ 记忆系统已初始化
+Done! 你的 AI 开发环境已就绪。
 ```
 
-### Spec-driven Development
+### Spec Coding 完整流程
+
+```bash
+# 进入工作目录
+$ mkdir my-project 
+$ cd my-project
+
+# 执行 aspec 初始化
+$ ace spec init
+✓ aspec 工作流已初始化
+Done! 规范驱动开发已就绪。
+
+# 在 Claude Code 中体验三命令开发流程：
+$ claude
+
+> /opsx:proposal 帮我实现用户积分系统
+
+Claude:
+【需求澄清】积分获取规则？消费规则？过期策略？→ 3 个问题确认
+【创建提案】proposal.md
+【技术澄清】并发扣减方案？积分流水存储？→ 2 个问题确认
+【确定方案】design.md + tasks.md（8 个可执行任务）
+
+> /opsx:apply
+
+Claude:
+按 tasks.md 逐项实现，每步验证
+✓ 所有任务完成，测试通过
+
+> /opsx:archive
 
+Claude:
+spec 归档
+复盘总结，知识库三层进化
+✓ ADR/术语表/风险图谱 已更新
 ```
-$ ace spec init ./my-project
-✔ openspec config installed
-✔ spec templates installed (taxonomy, issues, procedures, evolution)
-Done! Spec workflow is ready.
+
+### 健康检查
+
+```bash
+$ ace doctor
+✓ CLAUDE.md 配置正常
+✓ 8 条规则文件完整
+✓ 4 个 Skills 可正常加载
+✓ Hookify 插件运行中
+✓ 记忆目录可访问
+All systems operational.
 ```
 
-## Why ace?
+---
+
+## 🏗️ 架构概览
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        ACE 架构全景                          │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
+│  │   Rules     │  │   Skills    │  │  Hookify    │         │
+│  │  (8 规则)    │  │  (4 技能)    │  │  (3 守卫)    │         │
+│  ├─────────────┤  ├─────────────┤  ├─────────────┤         │
+│  │ • thinking  │  │ • auto-goal │  │ • block-    │         │
+│  │ • clean-code│  │ • coding    │  │   dangerous │         │
+│  │ • code-qual │  │ • skill-    │  │ • protect-  │         │
+│  │ • reporting │  │   creator   │  │   secrets   │         │
+│  │ • task-rec  │  │ • skill-    │  │ • require-  │         │
+│  │ • context-  │  │   optimize  │  │   verify    │         │
+│  │   hygiene   │  │             │  │             │         │
+│  │ • memory-   │  │             │  │             │         │
+│  │   policy    │  │             │  │             │         │
+│  │ • interactive│  │             │  │             │         │
+│  └─────────────┘  └─────────────┘  └─────────────┘         │
+│                                                             │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
+│  │    Hooks    │  │   Memory    │  │    Spec     │         │
+│  │ (角色脚本)   │  │  (记忆系统)  │  │ (规范驱动)   │         │
+│  ├─────────────┤  ├─────────────┤  ├─────────────┤         │
+│  │ • Java 编译 │  │ • MEMORY.md │  │ • config    │         │
+│  │   检查      │  │ • user_     │  │ • taxonomy/ │         │
+│  │ • TypeScript│  │   profile   │  │ • issues/   │         │
+│  │   检查      │  │ • roles/    │  │ • procedures│         │
+│  │ • 更多...   │  │             │  │ • evolution │         │
+│  └─────────────┘  └─────────────┘  └─────────────┘         │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📦 安装预设
+
+| 组件                                       | `full` | `safe` | `minimal` |
+| ------------------------------------------ | :------: | :------: | :---------: |
+| **Core** (CLAUDE.md + settings.json) |    ✅    |    ✅    |     ✅     |
+| **Rules** (8 条认知与代码质量规则)   |    ✅    |    ✅    |     ✅     |
+| **Plugin** (4 个 Skills)             |    ✅    |    ✅    |     ✅     |
+| **Hooks** (角色相关脚本)             |    ✅    |    ❌    |     ❌     |
+| **Hookify** (3 个安全守卫)           |    ✅    |    ✅    |     ❌     |
+| **Memory** (模板 + 开发者画像)       |    ✅    |    ✅    |     ❌     |
+
+```bash
+# 完整功能（推荐）
+ace init --preset full
+
+# 安全优先（适合团队协作）
+ace init --preset safe
+
+# 最小安装（仅核心功能）
+ace init --preset minimal
+```
+
+---
+
+## 🎓 核心设计理念
 
-Claude Code is powerful out of the box — but configuring rules, skills,
-safety guards, and memory templates by hand is tedious and error-prone.
+ACE 的设计融合了多学科的深层洞察：
 
-**ace solves this in one command:**
+### 认知科学
 
-- **Rules** — 8 cognitive and code-quality rules (deep thinking, clean code, ...)
-- **Skills** — 4 AI skills with namespace isolation (`ace:auto-goal`, `ace:coding`, ...)
-- **Spec** — Spec-driven development workflow with OpenSpec integration
-- **Safety** — Hookify guards that block dangerous ops and protect secrets
-- **Memory** — Templates for cross-session memory and developer profiles
-- **Non-destructive** — Smart merge preserves your existing config; uninstall restores it
+- **双过程理论** (Kahneman) — 简单任务快速响应，复杂任务深度分析
+- **认知负荷理论** (Sweller) — 渐进式信息披露，避免工作记忆过载
+- **元认知监控** — 持续自我监控与策略调整
 
-## Quick Start
+### 控制论
+
+- **OODA 循环** (Boyd) — 观察-定向-决策-行动的快速迭代
+- **必要多样性定律** (Ashby) — 策略库必须匹配任务复杂度
+- **闭环控制** — 每个操作都内建验证
+
+### 软件工程
+
+- **Clean Code 原则** (Robert C. Martin)
+- **单一职责** (SOLID)
+- **渐进式复杂度** (OpenAI Agent 最佳实践)
+
+> 📖 详细理论解读请查看 [理论基础文档](docs/theory/index.md)
+
+---
+
+## 🚀 快速开始
+
+### 1. 安装 ACE
 
 ```bash
 npm install -g @shirayner/ace
+```
+
+### 2. 初始化环境
+
+```bash
 ace init
 ```
 
-That's it. Run `ace doctor` to verify.
+按提示选择你的角色和预设。ACE 会自动配置：
+
+- 全局 CLAUDE.md 索引
+- 8 条认知规则
+- 4 个 AI Skills
+- Hookify 安全守卫
+- 角色特定脚本和开发者画像
+
+### 3. 验证安装
+
+```bash
+ace doctor
+```
+
+### 4. 开始项目（可选）
+
+```bash
+# 初始化规范驱动开发工作流
+ace spec init ./my-project
+cd my-project
+
+# 开始开发
+claude
+```
+
+---
+
+## 📚 文档导航
+
+### 新手入门
+
+- [5 分钟快速开始](docs/getting-started/index.md) — 从零到专业开发环境
+- [安装指南](docs/getting-started/installation.md) — 详细安装与配置
+- [第一个项目](docs/getting-started/first-project.md) — 手把手入门教程
+
+### 理解 ACE
+
+- [为什么选 ACE](docs/why-ace/index.md) — 价值主张与核心优势
+- [解决的问题](docs/why-ace/problems-solved.md) — ACE 如何应对开发痛点
+- [方案对比](docs/why-ace/comparisons.md) — 与其他工具的比较
+
+### 深度架构
+
+- [架构全景](docs/architecture/index.md) — 完整组件关系图
+- [8 条规则详解](docs/architecture/rules.md) — 每条规则的用途与设计
+- [4 个 Skills 详解](docs/architecture/skills.md) — 工作原理与最佳实践
+- [aspec 规范驱动](docs/architecture/aspec.md) — spec coding 完整工作流
+- [Hookify 安全体系](docs/architecture/hookify.md)
+- [Hooks 角色脚本](docs/architecture/hooks.md)
+- [记忆系统](docs/architecture/memory.md)
+- [OpenSpec 集成](docs/architecture/spec.md)
+
+### 理论基础
+
+- [理论总览](docs/theory/index.md)
+- [认知科学基础](docs/theory/cognitive-science.md)
+- [控制论与系统论](docs/theory/cybernetics.md)
+- [哲学基础](docs/theory/philosophy.md)
+- [心理学洞察](docs/theory/psychology.md)
+- [社会学视角](docs/theory/sociology.md)
+
+### 参考手册
+
+- [CLI 完整参考](docs/reference/cli.md)
+- [合并策略](docs/reference/merge-strategy.md)
+- [角色说明](docs/reference/roles.md)
+
+---
+
+## 🛡️ 非破坏性设计
 
-## What You Get
+ACE 遵循**零侵入**原则：
 
-| Component | Contents | Preset |
-|-----------|----------|--------|
-| **Core** | `CLAUDE.md` + `settings.json` (smart merge) | all |
-| **Rules** | 8 rules: thinking, clean-code, code-quality, ... | all |
-| **Plugin** | 4 skills + 1 command (`ace:auto-goal`, `ace:coding`, ...) | all |
-| **Hookify** | 3 safety guards (block-dangerous-ops, protect-secrets, ...) | full, safe |
-| **Hooks** | Role-dependent scripts (e.g., Java compile check) | full |
-| **Memory** | MEMORY.md template + role-based developer profile | full, safe |
-| **Spec** | Spec-driven workflow templates (taxonomy, issues, procedures) | `ace spec init` |
+- **智能合并** — 与现有配置共存，从不覆盖
+- **自动备份** — 首次安装前创建完整快照
+- **干净卸载** — `ace uninstall` 一键恢复原始状态
+- **命名空间隔离** — 所有文件使用 `ace/` 前缀，避免冲突
 
-## Design Philosophy
+---
 
-1. **Non-destructive by default** — ace merges into your existing config,
-   never overwrites. Uninstall restores your original state.
+## 🤝 贡献
 
-2. **Namespace isolation** — Rules live in `rules/ace/`, skills use
-   the `ace:` plugin namespace. Your files and ace's files never collide.
+欢迎贡献！我们同时在 GitHub 和 GitLab 维护代码库。
 
-3. **Opinionated but escapable** — ace ships curated defaults for
-   deep thinking, clean code, and safety. Disagree? Override any rule
-   or uninstall cleanly.
+- 报告问题：使用 GitHub Issues
+- 提交改进：Fork & Pull Request
+- 讨论想法：GitHub Discussions
 
-## Documentation
+查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。
 
-- [CLI Reference](docs/cli-reference.md) — Commands, options, and presets
-- [Components](docs/components.md) — Detailed description of all installed components
-- [Merge Strategy](docs/merge-strategy.md) — How ace handles existing config files
-- [Roles](docs/roles.md) — Role-based installation and developer profiles
+---
 
-## Contributing
+## 📄 License
 
-Contributions are welcome on both GitHub and GitLab (internal).
-See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+[MIT](LICENSE) © 2024
 
-## License
+---
 
-[MIT](LICENSE)
+<p align="center">
+  <sub>Built with ❤️ for developers who care about code quality</sub>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shirayner/ace",
-  "version": "0.1.0",
+  "version": "0.1.1-snapshot.0",
   "description": "AI Coding Environment - One command to set up your Claude Code harness",
   "bin": {
     "ace": "./bin/ace.js"

package/plugin/skills/auto-goal/SKILL.md

@@ -9,7 +9,7 @@ description: |
 
 # Auto Goal Skill
 
-自主完成目标的赋能系统。**核心信念**：每步行动都是带预测的实验——预期与现实的偏差是最有价值的学习信号，上下文是最稀缺的资源，足够好胜过完美。
+自主完成目标的赋能系统。**核心信念**：**对齐优先于效率**——准确完成用户真正想要的，胜过高效完成 agent 以为的。每步行动都是带预测的实验，上下文是最稀缺的资源。宁可慢一步确认方向，不要快一步跑偏。
 
 ---
 
@@ -41,18 +41,59 @@ description: |
 
 **域可迁移**：初判不是终判。执行中发现域判断错误时立即切换策略。
 
-### OODA 循环
+### 对齐评估（与域判断同步执行）
+
+技术复杂度和对齐不确定性是**正交的两个维度**，必须同时评估：
+
+| 对齐不确定性 | 信号 | 策略 |
+|-------------|------|------|
+| **低**（EXPLICIT） | 用户指令具体、验收标准明确、无歧义 | 按域策略自主执行 |
+| **中**（ALIGNED） | 可从上下文合理推断，但存在假设 | 标注假设，关键分叉点确认 |
+| **高**（GUESSING） | 目标抽象/多义、存在多可行方案、涉及偏好 | **先澄清再执行**，无论技术域是什么 |
+
+**对齐不确定性信号**（任一命中即升级）：
+- 目标描述抽象或多义（"优化"、"改进"、"重构"、"完善"）
+- 存在 ≥2 个可行方案且各有取舍
+- 决策依赖用户偏好（风格、架构、优先级）
+- 需要做范围决策（做多少？改多少？包含什么？）
+- agent 正在"替用户填空"——用自己的理解补全用户未说明的部分
+
+**铁律**：对齐不确定性为"高"时，**不可内部推理自行填补**，必须向用户提问。技术能力不补偿对齐缺失。
+
+### 首轮对齐（MANDATORY — 不可跳过）
+
+**无论对齐评估结果如何，首轮对齐都必须执行。** 这是结构性要求，不是条件性判断。agent 不知道自己不理解什么——所以不能由 agent 决定是否需要对齐。
+
+**执行时机**：初步分析完成后、OODA 循环启动前。
+
+**呈现内容**（向用户简明呈现，等待确认）：
+1. **我的理解** — 用一两句话复述目标的核心意图
+2. **计划方向** — 打算怎么做（高层策略，不是细节）
+3. **关键假设** — 我做了哪些假设（如果有）
+4. **待确认项** — 有歧义或需要用户选择的地方（如果有）
+
+**用户确认后**才进入 OODA 循环。用户纠正 → 更新理解 → 可能需要再次对齐。
 
 ```
-接收目标 → 初始理解 → 域判断 + 估算深度（1-4）
+接收目标 → 初步分析（域判断 + 对齐评估 + 深度估算）
+  ↓
+⚡首轮对齐（MANDATORY）
+  向用户呈现：理解 + 方向 + 假设 → 等待确认
+  用户确认 → 进入执行 ┃ 用户纠正 → 更新理解 → 再次对齐
   ↓
+```
+
+### OODA 循环（首轮对齐通过后启动）
+
+```
 ┌─────────────────────────────────────────────────┐
 │ Sense  ：状态？变化？新信息？⚡弱信号+外围扫描   │
 │ Orient ：距目标多远？心智模型需要更新吗？        │
 │ Decide ：策略 + 推理模式 + 深度 + 验证标准        │
+│ ⚡Align ：对齐门控（方向性决策时触发）            │
 │ Act    ：识别即行动 or 完整分析（= 检验假设）     │
 │ Observe：结果 vs 预期？验证精度匹配风险级别      │
-│ Adapt  ：更新理解，调节深度/域，外化状态         │
+│ Adapt  ：更新理解，调节深度/域/对齐，外化状态    │
 │                                                  │
 │ → 循环，直到目标满足或触发降级                   │
 └─────────────────────────────────────────────────┘
@@ -62,12 +103,14 @@ description: |
 
 **关键机制**：
 
+- **对齐门控**（Align，Decide→Act 之间的强制检查）：每个方向性决策前自问三个问题：① 这个决策涉及方向/偏好/取舍吗？② 我是在执行用户的指令，还是在替用户做选择？③ 如果用户此刻看到我的决策，会惊讶吗？——**任一为 YES → 暂停，向用户呈现选项并等待确认**。全部为 NO → 执行。这不是"每步都问"，而是**只在方向性决策点问**
 - **弱信号检测**（Sense）：不等失败才反应。主动扫描——进展在减速？假设在累积未验证？复杂度在悄然上升？发现弱信号 → 升级深度或回到 Orient。模糊时先恢复情境意识
-- **假设驱动行动**（Act）：**已知模式→识别即行动**（模式匹配→心理模拟→执行）；**未知→完整分析**。每步先生成预期结果，再行动，后对比——预测偏差是心智模型更新的最强信号
+- **假设驱动行动**（Act）：**已知模式→验证模式适用性→对齐门控→行动**；**未知→完整分析**。每步先生成预期结果，再行动，后对比。**警惕**："识别到模式"≠"理解用户的具体需求"——模式匹配前必须确认：此模式的前提在当前场景中成立吗？用户的需求是否偏离标准模式？
 - **推理模式选择**（Decide）：不可逆选择→生成备选评估后决策；置信度低→多角度推理检查收敛；关键输出完成→切换为怀疑论审查者
 - **验证精度分级**（Observe）：微验证（低风险，心理校验）/ 标准验证（中风险，工具确认）/ 深度验证（高风险/不可逆，交叉证伪）
 - **深度调节**（1=自动…4=全面）：升级信号：偏离/新复杂度/验证失败/弱信号；降级信号：连续顺利/模式匹配/不确定性收敛
 - **熔断器**（持续）：同一子问题重试 > 3 次→换策略或求助；探索超阶段预算→强制转向；每 5 步→目标漂移 + 偏差累积检查
+- **偏差累积检测**（持续）：追踪未经用户确认的假设数量。0-1 个→继续；2-3 个→下一个决策点主动确认；>3 个→**立即暂停**，向用户同步当前理解和已做假设。小偏差是大偏差的前兆
 - **终态证伪**：不问"能运行吗？"，问"什么条件下会失败？"
 
 ---
@@ -77,7 +120,23 @@ description: |
 五个策略，按需组合，可重复调用。
 
 ### 澄清（Clarify）
-消除歧义，对齐理解。区分表面需求与真实需求，检验问题框架是否最优。不确定性分级：必须澄清 / 可合理假设 / 无关紧要。**"必须澄清"级（用户意图/价值判断/方向选择）→ 必须通过平台交互工具向用户提问**，不可内部推理自行填补。能推断的不问，能合理假设的标注后继续。
+消除歧义，对齐理解。区分表面需求与真实需求，检验问题框架是否最优。
+
+**核心原则：对齐优先 — 技术实现细节能推断就自己做；方向、偏好、取舍必须确认。**
+
+**Must-Ask 触发器（硬性，命中任一必须向用户提问）**：
+1. **方案分叉** — 存在 ≥2 个可行方案且各有明显取舍
+2. **范围扩张** — 执行中发现需要做的超出原始目标描述
+3. **假设填补** — 用户目标中有模糊处，agent 正在用自己的理解"填空"
+4. **不可逆操作** — 删除、重写、架构变更
+5. **偏好依赖** — 决策取决于用户的风格/优先级/口味
+
+**Should-Ask 触发器（软性，累积 2+ 项则必须确认）**：
+6. **信心不足** — 对用户真实意图的置信度 < 中等
+7. **领域边界** — 进入 agent 不熟悉的技术/业务领域
+8. **累积偏差** — 已连续做了 3+ 个小假设未经确认
+
+**禁止**：不可因为"能推断"就跳过方向性确认。LLM 最危险的特征是"自信地做错事"——对自己的推断能力保持怀疑。
 
 ### 探索（Explore）
 获取知识，识别最佳实践和风险。**在 sub-agent 中执行**，只将摘要返回主上下文。交叉验证关键信息，标注置信度。**觅食启发**：跟踪信息气味（相关性信号）→ 收益递减时果断换源 → 探索超总预算 30% 停止。**认知行动合法**：为理解而做的探索（临时测试、中间状态打印）是投资非浪费。
@@ -119,6 +178,13 @@ description: |
 
 决策不应仅依赖 ASSUME。INFER/ASSUME 被推翻时，回溯所有依赖它的后续决策。
 
+### 意图置信度（与信息分级正交）
+- **EXPLICIT** — 用户明确说了（原话/明确指令）
+- **ALIGNED** — 可从上下文合理推断（标注推断依据）
+- **GUESSING** — 在替用户做选择（必须提问确认）
+
+**决策矩阵**：意图 GUESSING 时**必须问用户**，无论技术置信度多高。技术能力不补偿对齐缺失。
+
 ### Reflect-then-Retry
 遇到意外时（失败、意外成功、意外副作用），不直接重试，先结构化反思（写入 reflections.md）：
 1. 失败现象 vs 预期偏差
@@ -167,16 +233,32 @@ description: |
 
 ## 介入模式
 
-用户调用时可声明模式：**全自动**（仅不可逆操作前确认）/ **协作**（模糊处主动澄清）。未声明默认协作。
+用户调用时可声明模式：**全自动**（仅不可逆操作前确认）/ **协作**（关键路径确认）。未声明默认**协作**。
+
+### 协作模式（默认）— 关键路径确认制
+
+**默认姿态**：方向自主探索，**关键路径决策前呈现方案等待确认**。
 
-以下为两种模式的共同底线：
+**关键路径**（必须确认的节点）：
+1. **首轮对齐** — **MANDATORY，不可跳过**，初步分析后必须呈现理解并等待确认
+2. **方案选择时** — 多条路径中选一条，呈现取舍
+3. **范围变更时** — 做的比要求的多或少
+4. **中间里程碑** — 大任务的阶段性交付确认
+5. **任何 Must-Ask 触发器命中时**
+
+### 两种模式的共同底线
 
 | 操作类型 | 默认行为 |
 |----------|----------|
-| 可逆、影响范围小 | 自主执行，事后简报 |
-| 不可逆或影响范围大 | 执行前确认 |
-| 涉及用户偏好/价值判断 | 提供选项，等待决策 |
-| 目标/方向性调整 | 始终询问 |
+| 可逆、影响范围小、意图 EXPLICIT | 自主执行，事后简报 |
+| 不可逆或影响范围大 | **执行前确认** |
+| 涉及用户偏好/价值判断 | **提供选项，等待决策** |
+| 目标/方向性调整 | **始终询问** |
+| 意图 GUESSING | **始终询问**，无论操作大小 |
+
+### 用户视角模拟
+
+在关键决策点，切换到用户视角自检：**"如果用户此刻看到我正在做的事和我的推理过程，他们会 (a) 点头认可 (b) 感到惊讶 (c) 说'不，我要的不是这个'"。** (b)(c) → 暂停询问。这不是每步都做——只在方向性决策点做。
 
 ---
 
@@ -189,3 +271,6 @@ description: |
 | 域错配：用 Complicated 策略应对 Complex 问题 | 域感知路由——试探优先于分析 |
 | 吸收循环：卡在重试中不升级策略 | 韧性三态——吸收失败后升级到适应或转化 |
 | 框架锁定：反复修正但不质疑前提 | 双环学习——3次修正无效时质疑"是否在解决正确的问题" |
+| **过度自信**：自信地做错事，替用户做选择却不自知 | 对齐门控——方向性决策前必须过三问检查 |
+| **假设累积**：每个小假设都"合理"，累积后严重偏离 | 偏差累积检测——>3 个未确认假设时暂停 |
+| **模式幻觉**：识别到不适用的模式后自信执行 | 模式适用性验证——前提成立吗？用户需求偏离了吗？ |