@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/{organization/ai-native-team.md → 08-organization/01-ai-native-culture.md}

@@ -1,7 +1,7 @@
 # AI Native 团队文化手册
 
 > 本手册定义 AI Native 团队的文化原则、工作方式和协作规范。
-> 与 `knowledge/principles/constitution.md` 互补，宪法红线在此同样生效。
+> 与 `principles/03-constitution.md` 互补，宪法红线在此同样生效。
 
 ## 核心理念
 

package/knowledge/{organization/team-metrics.md → 08-organization/02-team-metrics.md}

@@ -1,7 +1,7 @@
 # 团队度量体系
 
 > 本文档定义 AI Native 团队的度量指标体系。
-> 与 `knowledge/organization/ai-native-team.md` 互补。
+> 与 [01-ai-native-culture.md](01-ai-native-culture.md) 互补。
 
 ## 概述
 

package/knowledge/08-organization/03-committee-structure.md

@@ -0,0 +1,54 @@
+# 治理委员会架构
+
+> 公司治理团队架构定义
+
+## 委员会组成
+
+### 技术委员会（Tech Committee）
+
+| 成员 | 角色 | 职责 |
+|------|------|------|
+| 技术负责人 | 召集人 | 技术决策、架构评审 |
+| 安全工程师 | 成员 | 安全评审 |
+| 运维工程师 | 成员 | 运维质量 |
+
+### 质量委员会（Quality Committee）
+
+| 成员 | 角色 | 职责 |
+|------|------|------|
+| 质量工程师 | 召集人 | 质量标准、流程优化 |
+| 技术负责人 | 成员 | 技术质量 |
+| 运维工程师 | 成员 | 部署质量 |
+
+### 战略委员会（Strategy Committee）
+
+| 成员 | 角色 | 职责 |
+|------|------|------|
+| CEO | 召集人 | 战略方向 |
+| 产品负责人 | 成员 | 产品战略 |
+| 技术负责人 | 成员 | 技术战略 |
+
+## 决策权限
+
+| 决策类型 | 负责委员会 | 决策方式 |
+|----------|-----------|----------|
+| 技术架构 | 技术委员会 | 多数投票 |
+| 质量标准 | 质量委员会 | 多数投票 |
+| 战略方向 | 战略委员会 | CEO最终决策 |
+| 紧急问题 | 召集人 | 快速决策 |
+
+## 会议频率
+
+| 委员会 | 频率 | 时长 |
+|--------|------|------|
+| 技术委员会 | 每周 | 30分钟 |
+| 质量委员会 | 每周 | 30分钟 |
+| 战略委员会 | 每月 | 60分钟 |
+
+## 治理Agent
+
+| Agent | 职责 |
+|-------|------|
+| 治理监测Agent | 每日扫描指标，识别异常 |
+| 治理分析Agent | 分析根因，生成提案 |
+| 治理协调Agent | 协调评审，跟踪执行 |

package/knowledge/08-organization/04-governance-metrics.md

@@ -0,0 +1,55 @@
+# 治理监测指标
+
+> 定义公司治理团队监测的关键指标
+
+## 效率指标（DORA）
+
+| 指标 | 描述 | 目标 |
+|------|------|------|
+| 部署频率 | 部署到生产的频率 | 每天多次 |
+| 变更前置时间 | 从提交到部署的时间 | < 1小时 |
+| 变更失败率 | 部署失败的比率 | < 5% |
+| 恢复时间 | 故障恢复时间 | < 1小时 |
+
+## 质量指标
+
+| 指标 | 描述 | 目标 |
+|------|------|------|
+| Layer1通过率 | 编译/测试/lint通过率 | > 95% |
+| Layer2通过率 | AI审查通过率 | > 85% |
+| Benchmark通过率 | 基准评测通过率 | > 90% |
+| 缺陷密度 | 每千行代码缺陷数 | < 1 |
+
+## 流程指标
+
+| 指标 | 描述 | 目标 |
+|------|------|------|
+| 回退次数 | 阶段回退次数 | < 3次/阶段 |
+| 人工介入 | 需要人工介入的次数 | < 10% |
+| 阶段耗时 | 各阶段平均耗时 | 按复杂度浮动 |
+
+## 进化指标
+
+| 指标 | 描述 | 目标 |
+|------|------|------|
+| Practice-log数 | 实践记录数量 | 持续增长 |
+| 改进采纳率 | 改进建议被采纳率 | > 70% |
+| 进化成功率 | 进化变更成功率 | > 90% |
+
+## 监测频率
+
+| 指标类型 | 监测频率 | 负责Agent |
+|----------|---------|-----------|
+| 效率指标 | 每日 | 治理监测Agent |
+| 质量指标 | 每日 | 治理监测Agent |
+| 流程指标 | 每周 | 治理监测Agent |
+| 进化指标 | 每月 | 治理分析Agent |
+
+## 告警阈值
+
+| 指标 | 告警阈值 | 处理方式 |
+|------|---------|----------|
+| Layer1通过率 | < 80% | 立即告警 |
+| Benchmark通过率 | < 70% | 立即告警 |
+| 回退次数 | > 5次/阶段 | 告警+分析 |
+| 人工介入 | > 20% | 分析原因 |

package/knowledge/08-organization/05-improvement-process.md

@@ -0,0 +1,71 @@
+# 改进流程
+
+> 治理改进流程定义
+
+## 改进来源
+
+| 来源 | 说明 |
+|------|------|
+| 监测发现 | 日常监测发现的问题 |
+| Practice-log | 实践记录汇总的模式 |
+| 自进化 | 自进化触发的改进 |
+| 用户反馈 | 用户提供的反馈 |
+
+## 改进流程
+
+```
+1. 问题发现
+   → 治理监测Agent发现异常
+
+2. 问题分析
+   → 治理分析Agent分析根因
+   → 生成改进提案
+
+3. 提案评审
+   → 相关委员会评审
+   → 通过/否决/修改
+
+4. 执行验证
+   → 小范围试点
+   → 全面推广
+
+5. 效果验证
+   → 指标对比
+   → 确认有效 → 固化
+```
+
+## 改进分类
+
+| 分类 | 说明 | 处理方式 |
+|------|------|----------|
+| 紧急 | 影响当前执行 | 24小时内处理 |
+| 重要 | 影响效率质量 | 本周处理 |
+| 常规 | 优化改进 | 纳入计划 |
+
+## 改进与自进化联动
+
+### 触发条件
+
+| 改进类型 | 目标区域 | 触发进化 | 验证要求 |
+|----------|---------|-----------|----------|
+| 流程优化 | 自由区 | Field-Evolve | validator + 回归测试 |
+| 技能改进 | 自由区 | Field-Evolve | validator + 效果测试 |
+| 角色调整 | 受控区 | Self-Evolve | validator + 人工审批 |
+| 标准优化 | 受控区 | Self-Evolve | validator + 人工审批 |
+
+### 安全检查
+
+| 检查项 | 说明 |
+|--------|------|
+| 语法检查 | 修改内容语法正确 |
+| 语义检查 | 修改内容逻辑合理 |
+| 一致性检查 | 与冻结区/受控区无冲突 |
+| 安全检查 | 无危险操作 |
+
+### 回滚机制
+
+| 场景 | 处理方式 |
+|------|----------|
+| 退化检测 | 自动回滚 |
+| 验证失败 | 回滚到上一状态 |
+| 用户否决 | 记录原因，终止改进 |

package/knowledge/08-organization/README.en.md

@@ -0,0 +1,165 @@
+# AutoSpec Organization Layer
+
+> **Purpose**: AI Native team culture, governance system, metrics, and improvement processes
+>
+> **Evolution Zone**: 🟢 Free (Auto-evolved + Validator-verified)
+
+---
+
+## Directory Structure
+
+```
+organization/
+├── README.md                     # This file (Organization Navigation)
+├── 00-vision-mission.md          # Vision, Mission, Core Values
+├── 01-ai-native-culture.md       # AI Native Team Culture Handbook
+├── 02-team-metrics.md            # Team Metrics System
+├── 03-committee-structure.md     # Governance Committee Structure
+├── 04-governance-metrics.md      # Governance Monitoring Metrics
+└── 05-improvement-process.md     # Improvement Process
+```
+
+---
+
+## Core File Description
+
+### 00-vision-mission.md — Vision & Mission
+
+**Content**: AutoSpec's vision, mission, and core values
+
+**Core Chapters**:
+- Vision: Make AI a reliable development partner, unleash human creativity
+- Mission: Build an autonomous software development pipeline framework
+- Core Values: Verification-First, Minimal-Viable, Progressive-Autonomy, Safety-First, Continuous-Evolution
+- Alignment with Anthropic's Mission
+
+**Location**: [00-vision-mission.md](00-vision-mission.md)
+
+### 01-ai-native-culture.md — AI Native Team Culture
+
+**Content**: AI Native team culture principles, working methods, and collaboration standards
+
+**Core Chapters**:
+- AI Native Four Principles
+- Working Modes (Vibe Coding, AI Pair Programming, Multi-Agent Review)
+- Role Transformation
+- Decision Process
+- Practice Guidelines
+
+**Location**: [01-ai-native-culture.md](01-ai-native-culture.md)
+
+### 02-team-metrics.md — Team Metrics System
+
+**Content**: AI Native team metrics system
+
+**Core Chapters**:
+- AI Capability Metrics (Participation, Quality, Efficiency)
+- Process Efficiency Metrics (Stage Efficiency, Iteration Efficiency, Blocker Metrics)
+- Quality Metrics (Code Quality, Review Quality, Delivery Quality)
+- Team Health Metrics
+- Metrics Dashboard
+
+**Location**: [02-team-metrics.md](02-team-metrics.md)
+
+### 03-committee-structure.md — Governance Committee Structure
+
+**Content**: Company governance team structure definition
+
+**Core Chapters**:
+- Technical Committee
+- Quality Committee
+- Strategy Committee
+- Decision Authority
+- Governance Agents
+
+**Location**: [03-committee-structure.md](03-committee-structure.md)
+
+### 04-governance-metrics.md — Governance Monitoring Metrics
+
+**Content**: Key metrics for company governance team monitoring
+
+**Core Chapters**:
+- Efficiency Metrics (DORA)
+- Quality Metrics (Layer1/Layer2/Benchmark Pass Rates)
+- Process Metrics
+- Evolution Metrics
+- Alert Thresholds
+
+**Location**: [04-governance-metrics.md](04-governance-metrics.md)
+
+### 05-improvement-process.md — Improvement Process
+
+**Content**: Governance improvement process definition
+
+**Core Chapters**:
+- Improvement Sources
+- Improvement Process
+- Improvement Classification
+- Improvement & Self-Evolution Integration
+
+**Location**: [05-improvement-process.md](05-improvement-process.md)
+
+---
+
+## Quick Navigation
+
+### Find by Scenario
+
+| Scenario | Applicable Document |
+|----------|---------------------|
+| **Understand Project Vision** | [00-vision-mission.md](00-vision-mission.md) |
+| **Build AI Native Team** | [01-ai-native-culture.md](01-ai-native-culture.md) |
+| **Team Metrics** | [02-team-metrics.md](02-team-metrics.md) |
+| **Governance Structure** | [03-committee-structure.md](03-committee-structure.md) |
+| **Governance Monitoring** | [04-governance-metrics.md](04-governance-metrics.md) |
+| **Continuous Improvement** | [05-improvement-process.md](05-improvement-process.md) |
+
+---
+
+## Relationship with Principles Layer
+
+Mapping between Organization Layer and Principles Layer files:
+
+| Organization Layer File | Corresponding Principles File | Description |
+|------------------------|----------------------------|-------------|
+| 00-vision-mission.md | [01-first-principles.md](../principles/01-first-principles.md) | Vision & Mission derived from First Principles |
+| 01-ai-native-culture.md | [07-cognitive-principles.md](../principles/07-cognitive-principles.md) | AI Native culture aligned with Cognitive Enhancement Principles |
+| 02-team-metrics.md | [10-evolution-mechanism.md](../principles/10-evolution-mechanism.md) | Metrics system supports evolution mechanism |
+| 03-committee-structure.md | [09-constitution.md](../principles/09-constitution.md) | Governance Committee guards the Constitution |
+| 04-governance-metrics.md | [10-evolution-mechanism.md](../principles/10-evolution-mechanism.md) | Governance metrics monitor evolution effectiveness |
+| 05-improvement-process.md | [10-evolution-mechanism.md](../principles/10-evolution-mechanism.md) | Improvement process is concrete implementation of evolution |
+
+---
+
+## Evolution Zone Description
+
+| Zone | Description | Change Method |
+|------|-------------|---------------|
+| 🔴 **Frozen** | Constitution, Evolution Rules, Core Principles | Human-only changes, requires complete review process |
+| 🟡 **Controlled** | Vision/Mission, Process Definitions, Universal Skills | Auto-proposed + Human-approved |
+| 🟢 **Free** | Organization Layer Files, Domain Skills, Benchmarks | Auto-evolved + Validator-verified |
+
+Organization Layer files are in the **Free Zone**, supporting auto-evolution and continuous optimization.
+
+---
+
+## Usage Guide
+
+### New Team Onboarding
+
+1. Read [00-vision-mission.md](00-vision-mission.md) to understand project vision and mission
+2. Read [01-ai-native-culture.md](01-ai-native-culture.md) to learn AI Native working methods
+3. Read [02-team-metrics.md](02-team-metrics.md) to understand team metrics system
+
+### Governance Team Operations
+
+1. Reference [03-committee-structure.md](03-committee-structure.md) to form committees
+2. Use [04-governance-metrics.md](04-governance-metrics.md) to monitor key metrics
+3. Follow [05-improvement-process.md](05-improvement-process.md) to execute improvement processes
+
+---
+
+**Maintainer**: AutoSpec Team
+**Evolution Zone**: 🟢 Free
+**Version**: v1.0
+**Last Updated**: 2026-03-27

package/knowledge/08-organization/README.md

@@ -0,0 +1,165 @@
+# AutoSpec 组织层
+
+> **定位**: AI Native 团队文化、治理体系、度量指标和改进流程
+>
+> **进化分区**: 🟢 自由区（自动进化 + validator 验证）
+
+---
+
+## 目录结构
+
+```
+organization/
+├── README.md                     # 本文件（组织层导航）
+├── 00-vision-mission.md          # 愿景、使命、核心价值观
+├── 01-ai-native-culture.md       # AI Native 团队文化手册
+├── 02-team-metrics.md            # 团队度量体系
+├── 03-committee-structure.md     # 治理委员会架构
+├── 04-governance-metrics.md      # 治理监测指标
+└── 05-improvement-process.md     # 改进流程
+```
+
+---
+
+## 核心文件说明
+
+### 00-vision-mission.md — 愿景与使命
+
+**内容**: AutoSpec 的愿景、使命和核心价值观
+
+**核心章节**:
+- 愿景：让 AI 成为可靠的研发伙伴，释放人类创造力
+- 使命：构建无人值守的自动化产品研发框架
+- 核心价值观：验证为王、极简实用、渐进自主、安全优先、持续进化
+- 与 Anthropic 使命的对齐
+
+**位置**: [00-vision-mission.md](00-vision-mission.md)
+
+### 01-ai-native-culture.md — AI Native 团队文化
+
+**内容**: AI Native 团队的文化原则、工作方式和协作规范
+
+**核心章节**:
+- AI Native 四原则
+- 工作模式（Vibe Coding、AI 结对编程、多代理审查）
+- 角色转变
+- 决策流程
+- 实践指南
+
+**位置**: [01-ai-native-culture.md](01-ai-native-culture.md)
+
+### 02-team-metrics.md — 团队度量体系
+
+**内容**: AI Native 团队的度量指标体系
+
+**核心章节**:
+- AI 能力指标（参与度、质量、效率）
+- 流程效率指标（阶段效率、迭代效率、阻塞指标）
+- 质量指标（代码质量、审查质量、交付质量）
+- 团队健康指标
+- 度量看板
+
+**位置**: [02-team-metrics.md](02-team-metrics.md)
+
+### 03-committee-structure.md — 治理委员会架构
+
+**内容**: 公司治理团队架构定义
+
+**核心章节**:
+- 技术委员会
+- 质量委员会
+- 战略委员会
+- 决策权限
+- 治理 Agent
+
+**位置**: [03-committee-structure.md](03-committee-structure.md)
+
+### 04-governance-metrics.md — 治理监测指标
+
+**内容**: 定义公司治理团队监测的关键指标
+
+**核心章节**:
+- 效率指标（DORA）
+- 质量指标（Layer1/Layer2/Benchmark 通过率）
+- 流程指标
+- 进化指标
+- 告警阈值
+
+**位置**: [04-governance-metrics.md](04-governance-metrics.md)
+
+### 05-improvement-process.md — 改进流程
+
+**内容**: 治理改进流程定义
+
+**核心章节**:
+- 改进来源
+- 改进流程
+- 改进分类
+- 改进与自进化联动
+
+**位置**: [05-improvement-process.md](05-improvement-process.md)
+
+---
+
+## 快速导航
+
+### 按场景查找
+
+| 场景 | 适用文档 |
+|------|---------|
+| **理解项目愿景** | [00-vision-mission.md](00-vision-mission.md) |
+| **建设 AI Native 团队** | [01-ai-native-culture.md](01-ai-native-culture.md) |
+| **团队度量** | [02-team-metrics.md](02-team-metrics.md) |
+| **治理架构** | [03-committee-structure.md](03-committee-structure.md) |
+| **治理监测** | [04-governance-metrics.md](04-governance-metrics.md) |
+| **持续改进** | [05-improvement-process.md](05-improvement-process.md) |
+
+---
+
+## 与原则层的关系
+
+组织层文件与原则层文件的对应关系：
+
+| 组织层文件 | 对应原则层文件 | 说明 |
+|-----------|--------------|------|
+| 00-vision-mission.md | [01-first-principles.md](../01-principles/01-first-principles.md) | 愿景使命源于第一性原则 |
+| 01-ai-native-culture.md | [07-cognitive-principles.md](../01-principles/07-cognitive-principles.md) | AI Native 文化与认知增强原则对齐 |
+| 02-team-metrics.md | [10-evolution-mechanism.md](../01-principles/10-evolution-mechanism.md) | 度量体系支撑进化机制 |
+| 03-committee-structure.md | [09-constitution.md](../01-principles/09-constitution.md) | 治理委员会守护宪法 |
+| 04-governance-metrics.md | [10-evolution-mechanism.md](../01-principles/10-evolution-mechanism.md) | 治理指标监测进化效果 |
+| 05-improvement-process.md | [10-evolution-mechanism.md](../01-principles/10-evolution-mechanism.md) | 改进流程是进化的具体实现 |
+
+---
+
+## 进化分区说明
+
+| 分区 | 说明 | 变更方式 |
+|------|------|---------|
+| 🔴 **冻结区** | 宪法、进化规则、核心原则 | 人工变更，需经过完整的 review 流程 |
+| 🟡 **受控区** | 愿景使命、流程定义、通用 skills | 自动提议 + 人工批准 |
+| 🟢 **自由区** | 组织层文件、domain skills、benchmarks | 自动进化 + validator 验证 |
+
+组织层文件位于**自由区**，支持自动进化和持续优化。
+
+---
+
+## 使用指南
+
+### 新团队接入
+
+1. 阅读 [00-vision-mission.md](00-vision-mission.md) 理解项目愿景和使命
+2. 阅读 [01-ai-native-culture.md](01-ai-native-culture.md) 学习 AI Native 工作方式
+3. 阅读 [02-team-metrics.md](02-team-metrics.md) 了解团队度量体系
+
+### 治理团队运作
+
+1. 参考 [03-committee-structure.md](03-committee-structure.md) 组建委员会
+2. 使用 [04-governance-metrics.md](04-governance-metrics.md) 监测关键指标
+3. 遵循 [05-improvement-process.md](05-improvement-process.md) 执行改进流程
+
+---
+
+**维护者**: AutoSpec 团队
+**进化分区**: 🟢 自由区
+**版本**: v1.0
+**最后更新**: 2026-03-27