@chongyan/autospec 1.0.2 → 1.0.3

package/knowledge/01-principles/README.md

@@ -1,385 +0,0 @@
-# AutoSpec 原则体系
-
-> **定位**: 框架的"原则操作系统"，所有执行决策必须能追溯到本文的原则
->
-> **进化分区**: 🔴 冻结区（宪法、进化规则、核心原则、设计哲学）
-
----
-
-## 原则体系总览
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  L1: 第一性原则 (First Principles) — 不可违背的"物理定律"      │
-│  ─────────────────────────────────────────────────────────  │
-│  验证为王 | 极简实用 | 渐进自主                                │
-│  → 位于：01-first-principles.md                               │
-└─────────────────────────────────────────────────────────────┘
-                              │ 演绎
-┌─────────────────────────────────────────────────────────────┐
-│  L2: 战略原则 (Strategic Principles) — 方向性指导              │
-│  ─────────────────────────────────────────────────────────  │
-│  双层验证 | 做审分离 | Harness 工程 | 知情猜测                  │
-│  → 位于：02-strategic-principles.md                           │
-└─────────────────────────────────────────────────────────────┘
-                              │ 展开
-┌─────────────────────────────────────────────────────────────┐
-│  L3: 战术原则 (Tactical Principles) — 执行策略指导             │
-│  ─────────────────────────────────────────────────────────  │
-│  任务分解 | 上下文管理 | 精准回退 | 反模式预判 | 驯服非确定性    │
-│  → 位于：03-tactical-principles.md                            │
-└─────────────────────────────────────────────────────────────┘
-                              │ 落地
-┌─────────────────────────────────────────────────────────────┐
-│  L4: 操作原则 (Operational Principles) — 具体行为规范          │
-│  ─────────────────────────────────────────────────────────  │
-│  编码规范 | 自主修复 | 宪法门禁 | 检查清单                     │
-│  → 位于：04-operational-principles.md                         │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 目录结构
-
-```
-principles/
-├── README.md                         # 本文件（原则层导航）
-├── 00-principles-hierarchy.md        # 原则体系总纲（L1→L2→L3→L4 完整追溯）
-├── 01-first-principles.md            # L1 第一性原则（P1-P3 三棱锥）
-├── 02-strategic-principles.md        # L2 战略原则（S1-S4）
-├── 03-tactical-principles.md         # L3 战术原则（T1-T6）
-├── 04-operational-principles.md      # L4 操作原则（O1-O4）
-├── 05-domain-principles.md           # 领域实践原则（DDD/系统/需求/编码/CR/知识管理）
-├── 06-methodology-principles.md      # 方法论原则（P1-P44）
-├── 07-cognitive-principles.md        # 认知增强原则（CP1-CP10）
-├── 08-auto-fix-principles.md         # 自主修复原则（实战经验提炼）
-├── 09-constitution.md                # 项目宪法（15 条红线，违反即停线）
-└── 10-evolution-mechanism.md         # 三层进化机制
-```
-
----
-
-## 核心原则文档
-
-### 00-principles-hierarchy.md — 原则体系总纲
-
-**内容**: 完整的 L1→L2→L3→L4 追溯链，原则应用矩阵，原则速查表
-
-**核心章节**:
-- 原则体系总览（L1→L2→L3→L4）
-- 原则追溯链
-- 原则应用矩阵（按阶段/按错误类型）
-- 原则速查表
-- 进化分区说明
-
-**位置**: [00-principles-hierarchy.md](00-principles-hierarchy.md)
-
-### 01-first-principles.md — L1 第一性原则
-
-**内容**: AutoSpec 的"物理定律"，所有上层原则都由此演绎而来
-
-**核心章节**:
-- P1 验证为王（Verification-First）
-- P2 极简实用（Minimal Viable Process）
-- P3 渐进自主（Progressive Autonomy）
-- 核心设计模式（两步生成、渐进式披露、做审分离、Harness Engineering）
-
-**位置**: [01-first-principles.md](01-first-principles.md)
-
-### 02-strategic-principles.md — L2 战略原则
-
-**内容**: 由第一性原则演绎而来的方向性指导原则
-
-**核心章节**:
-- S1 双层验证（Two-Layer Validation）
-- S2 做审分离（Evaluator-Optimizer Separation）
-- S3 Harness Engineering 三部曲
-- S4 知情猜测（Informed Guessing）
-
-**位置**: [02-strategic-principles.md](02-strategic-principles.md)
-
-### 03-tactical-principles.md — L3 战术原则
-
-**内容**: 由战略原则展开而来的执行策略指导原则
-
-**核心章节**:
-- T1 任务分解质量（ATOMIC 原则）
-- T2 上下文精确管理
-- T3 精准回退（Precision Rollback）
-- T4 反模式预判（Anti-Pattern Inoculation）
-- T5 驯服非确定性（Taming Non-Determinism）
-- T6 优先复用项目现有能力
-
-**位置**: [03-tactical-principles.md](03-tactical-principles.md)
-
-### 04-operational-principles.md — L4 操作原则
-
-**内容**: 战术原则的具体落地，包含明确的行为规范和检查清单
-
-**核心章节**:
-- O1 编码规范（Coding Style）
-- O2 自主修复机制（Auto-Fix Loop）
-- O3 宪法门禁（Constitution Gate）
-- O4 检查清单（Checklists）
-
-**位置**: [04-operational-principles.md](04-operational-principles.md)
-
-### 05-domain-principles.md — 领域实践原则
-
-**内容**: 从各领域实践中提炼的通用原则，指导具体领域的执行决策
-
-**核心章节**:
-- DDP1-4: DDD 战术设计原则
-- SDP1-3: 系统设计原则
-- REP1-4: 需求工程原则
-- CEP1-6: 编码实践原则
-- CRP1-5: Code Review 原则
-- KMP1-4: 知识管理原则
-
-**位置**: [05-domain-principles.md](05-domain-principles.md)
-
-### 06-methodology-principles.md — 方法论原则
-
-**内容**: 从知识和实践中提炼的通用原则（P1-P44）
-
-**核心章节**:
-- 思维原则（P1-P6, P30-P31）
-- 设计原则（P7-P13, P32-P34）
-- 产品与需求原则（P14-P18）
-- 工程与质量原则（P19-P21）
-- 治理与进化原则（P22-P29）
-- 架构落地原则（P35-P44）
-
-**位置**: [06-methodology-principles.md](06-methodology-principles.md)
-
-### 07-cognitive-principles.md — 认知增强原则
-
-**内容**: 提升 AI 在自动化研发流程中的认知智能水平（CP1-CP10）
-
-**核心章节**:
-- 协作姿态（CP1 合伙人模式、CP2 情境匹配）
-- 认知纪律（CP3 先问后做、CP4 逻辑链完整、CP5 置信度标注）
-- 错误与学习（CP6 错误即信号、CP7 模式识别）
-- 偏航检测（CP8 三级偏航提醒）
-- 产出质量（CP9 刚好够用、CP10 自我质检）
-
-**位置**: [07-cognitive-principles.md](07-cognitive-principles.md)
-
-### 08-auto-fix-principles.md — 自主修复原则
-
-**内容**: 从自主修复机制实战中提炼的原则集合
-
-**核心章节**:
-- 核心洞察（3 条）
-- 原则体系（AFP1-AFP6）
-- 原则应用矩阵
-- 原则检查清单
-
-**位置**: [08-auto-fix-principles.md](08-auto-fix-principles.md)
-
-### 09-constitution.md — 项目宪法
-
-**内容**: 不可违反的红线清单，违反任何一条立即停止全流程
-
-**核心章节**:
-- 安全红线（#1-#3）
-- 流程红线（#4-#9）
-- 决策红线（#10-#11）
-- 停线条件
-- 自主修复机制
-
-**位置**: [09-constitution.md](09-constitution.md)
-
-### 10-evolution-mechanism.md — 自进化机制
-
-**内容**: 三层自进化体系，从项目实践到框架升级的完整闭环
-
-**核心章节**:
-- L1: Self-Evolve（框架自我进化）
-- L2: Field-Evolve（领域进化）
-- L3: Project-Evolve（项目自我进化）
-- 进化分区（冻结区/受控区/自由区）
-- 安全护栏
-
-**位置**: [10-evolution-mechanism.md](10-evolution-mechanism.md)
-
----
-
-## 快速导航
-
-### 按场景查找原则
-
-| 场景 | 适用原则 | 位置 |
-|------|---------|------|
-| **遇到错误需要修复** | 自主修复原则、修复循环原则 | [08-auto-fix-principles.md](08-auto-fix-principles.md) |
-| **编码实现** | 编码规范、SOLID 原则、CEP 系列 | [04-operational-principles.md](04-operational-principles.md#二 o1-编码规范-coding-style) |
-| **代码审查** | 审查规范、检查清单、CRP 系列 | [05-domain-principles.md](05-domain-principles.md#五 code-review-原则) |
-| **任务分解** | ATOMIC 原则、任务分解质量 | [03-tactical-principles.md](03-tactical-principles.md#二 t1-任务分解质量-atomic-原则) |
-| **需求分析** | 结构化澄清协议、需求分层、REP 系列 | [05-domain-principles.md](05-domain-principles.md#三需求工程原则) |
-| **方案设计** | 领域驱动设计、系统设计、DDP/SDP 系列 | [05-domain-principles.md](05-domain-principles.md#一 ddd-战术设计原则) |
-| **安全红线** | 宪法门禁、停线条件 | [09-constitution.md](09-constitution.md) |
-| **框架进化** | 三层进化体系 | [10-evolution-mechanism.md](10-evolution-mechanism.md) |
-
-### 原则速查表
-
-#### L1: 第一性原则（3 条）
-
-| 原则 | 一句话 | 应用场景 |
-|------|--------|---------|
-| P1 验证为王 | 确定性验证 > AI 审查 > AI 自审 | 所有产出物验证 |
-| P2 极简实用 | 能一个文件说清的不拆两个 | 知识管理、任务分解 |
-| P3 渐进自主 | 从"人审每步"到"人只管 harness" | 自主决策边界 |
-
-#### L2: 战略原则（4 条）
-
-| 原则 | 一句话 | 应用场景 |
-|------|--------|---------|
-| S1 双层验证 | Layer 1 不过，不进 Layer 2 | 所有阶段完成前 |
-| S2 做审分离 | 做和审由不同 AI 实例执行 | 审查任务启动 |
-| S3 Harness 工程 | 不满意产出时，改 harness | 产出质量差时 |
-| S4 知情猜测 | 最多 3 个 NEEDS CLARIFICATION | 需求歧义处理 |
-
-#### L3: 战术原则（6 条）
-
-| 原则 | 一句话 | 应用场景 |
-|------|--------|---------|
-| T1 任务分解 | ATOMIC 原则，2-4 小时粒度 | 任务拆解 |
-| T2 上下文管理 | 热/温/冷分层，按需加载 | 知识加载 |
-| T3 精准回退 | 只重处理失败项，不全量重做 | 修复循环 |
-| T4 反模式预判 | 堵死 6 种捷径路径 | skill 设计 |
-| T5 驯服非确定性 | 四道防线，假设管理 | 关键决策 |
-| T6 优先复用 | 先搜索后实现，禁止硬编码 | 编码/修复 |
-
-#### L4: 操作原则（4 条）
-
-| 原则 | 一句话 | 应用场景 |
-|------|--------|---------|
-| O1 编码规范 | SOLID+DDD，一锁二判三更新 | 代码编写 |
-| O2 自主修复 | 分析→决策→执行→验证，最多 3 次 | 错误处理 |
-| O3 宪法门禁 | 15 条红线，违反即停线 | 全流程 |
-| O4 检查清单 | 5 阶段清单，嵌入式自检 | 阶段完成 |
-
----
-
-## 原则追溯链示例
-
-**场景**: 遇到 Maven 依赖缺失错误
-
-```
-错误发生
-    ↓
-L4-O2 自主修复机制 → 错误分类（依赖类）
-    ↓
-L3-T6 优先复用项目现有能力 → 扫描现有 pom.xml
-    ↓
-L3-T3 精准回退 → Level 2 修正循环
-    ↓
-L2-S1 双层验证 → 重新执行原命令验证
-    ↓
-L1-P1 验证为王 → 验证结果通过
-    ↓
-记录 practice-log → L3-进化机制
-```
-
-**场景**: 需求歧义需要澄清
-
-```
-需求歧义识别
-    ↓
-L2-S4 知情猜测 > 无限提问 → 做合理默认 + 标记
-    ↓
-L3-T5 驯服非确定性 → 防线 2 锚定一致性
-    ↓
-L2-宪法#11 → 最多 3 个 NEEDS CLARIFICATION
-    ↓
-L3-T4 反模式预判 → 防止假设漂移
-    ↓
-L4-templates → 写入需求文档
-```
-
-完整追溯链：[00-principles-hierarchy.md](00-principles-hierarchy.md)
-
----
-
-## 进化分区说明
-
-| 分区 | 说明 | 变更方式 |
-|------|------|---------|
-| 🔴 **冻结区** | 宪法、进化规则、核心原则、设计哲学 | 人工变更，需经过完整的 review 流程 |
-| 🟡 **受控区** | 流程定义、通用 skills、检查清单、编码规范 | 自动提议 + 人工批准 |
-| 🟢 **自由区** | domain skills、benchmarks、支撑技能 | 自动进化 + validator 验证 |
-| 🔵 **环境知识区** | 中间件、组件、集成知识 | 项目级自动优化 |
-
----
-
-## 与相关文档的映射关系
-
-| 本文档章节 | 对应文档 | 说明 |
-|-----------|---------|------|
-| L1 第一性原则 | [01-first-principles.md](01-first-principles.md) | 三棱锥 P1/P2/P3 |
-| L2 战略原则 | [02-strategic-principles.md](02-strategic-principles.md) | S1-S4 |
-| L3 战术原则 | [03-tactical-principles.md](03-tactical-principles.md) | T1-T6 |
-| L4 操作原则 | [04-operational-principles.md](04-operational-principles.md) | O1-O4 |
-| 领域原则 | [05-domain-principles.md](05-domain-principles.md) | DDP/SDP/REP/CEP/CRP/KMP |
-| 方法论原则 | [06-methodology-principles.md](06-methodology-principles.md) | P1-P44 |
-| 认知增强原则 | [07-cognitive-principles.md](07-cognitive-principles.md) | CP1-CP10 |
-| 自主修复原则 | [08-auto-fix-principles.md](08-auto-fix-principles.md) | AFP1-AFP6 |
-| 项目宪法 | [09-constitution.md](09-constitution.md) | 15 条红线 |
-| 进化机制 | [10-evolution-mechanism.md](10-evolution-mechanism.md) | 三层自进化体系 |
-
----
-
-## 使用指南
-
-### 快速定位原则
-
-**场景**: 遇到 X 问题，应该遵循什么原则？
-
-1. 识别问题类型（验证/自主/知识/修复/...）
-2. 查本节原则速查表
-3. 追溯上游原则（理解为什么）
-4. 查看下游操作规范（知道怎么做）
-
-**示例**:
-```
-问题："AI 总是重复造轮子，不扫描现有代码"
-→ 问题类型：知识管理/复用
-→ 速查表：T6 优先复用项目现有能力
-→ 上游原则：P2 极简实用、S3 Harness Engineering
-→ 下游操作：04-operational-principles.md 编码规范、08-auto-fix-principles.md AFP3
-```
-
-### 原则应用检查点
-
-**执行任务前**:
-- [ ] 已读取本文档，理解相关原则
-- [ ] 已识别任务类型和适用原则
-- [ ] 已准备好必要的知识（热层/温层）
-
-**执行任务中**:
-- [ ] 遵循 ATOMIC 原则分解任务
-- [ ] 遵循知情猜测原则（最多 3 个不确定项）
-- [ ] 遵循做审分离原则（审查启动独立 Agent）
-
-**执行任务后**:
-- [ ] 遵循双层验证原则（Layer 1+Layer 2）
-- [ ] 遵循检查清单原则（阶段自检）
-- [ ] 遵循实践日志原则（记录经验）
-
----
-
-**维护者**: AutoSpec 团队
-**反馈渠道**: 知识库 Git 仓库 Issue
-**关联文档**:
-- [原则体系总纲](00-principles-hierarchy.md)
-- [L1 第一性原则](01-first-principles.md)
-- [L2 战略原则](02-strategic-principles.md)
-- [L3 战术原则](03-tactical-principles.md)
-- [L4 操作原则](04-operational-principles.md)
-- [领域实践原则](05-domain-principles.md)
-- [方法论原则](06-methodology-principles.md)
-- [认知增强原则](07-cognitive-principles.md)
-- [自主修复原则](08-auto-fix-principles.md)
-- [项目宪法](09-constitution.md)
-- [自进化机制](10-evolution-mechanism.md)