@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/03-guides/README.en.md

@@ -0,0 +1,212 @@
+# Capability Guides
+
+> **Purpose**: 51 skill files covering core protocols, stage execution, review skills, testing execution, evolution support, AI specializations
+>
+> **Evolution Zone**: 🟡 Controlled / 🟢 Free (by skill type)
+
+---
+
+## Directory Structure
+
+```
+03-guides/
+├── 00-pipeline-protocol.md       # Pipeline Protocol
+├── 01-team-orchestrator.md       # Team Orchestrator
+│
+├── # Stage Execution (02-08)
+├── 02-analyze-requirement.md     # Requirement Analysis
+├── 03-design-solution.md         # Solution Design
+├── 04-implement-code.md          # Code Implementation
+├── 05-plan-testing.md            # Testing Plan
+├── 06-generate-tests.md          # Generate Tests
+├── 07-check-release.md           # Release Check
+├── 08-evaluate-ai-effect.md      # AI Effect Evaluation
+│
+├── # Review Skills (09-14)
+├── 09-review-requirement.md      # Requirement Review
+├── 10-review-design.md           # Design Review
+├── 11-review-code.md             # Code Review
+├── 12-review-testing.md          # Testing Review
+├── 13-audit-security.md          # Security Audit
+├── 14-check-consistency.md       # Consistency Check
+│
+├── # Testing Execution (15-17)
+├── 15-run-unit-tests.md          # Unit Tests
+├── 16-run-integration-tests.md   # Integration Tests
+├── 17-analyze-test-context.md    # Test Context Analysis
+│
+├── # Evolution Support (18-22)
+├── 18-log-practice.md            # Practice Log
+├── 19-distill-skill.md           # Skill Distillation
+├── 20-update-skill.md            # Skill Update
+├── 21-validate-skill.md          # Skill Validation
+├── 22-extract-methodology.md     # Methodology Extraction
+│
+├── # Context/Environment (23-29)
+├── 23-infer-scope.md             # Scope Inference
+├── 24-assess-complexity.md       # Complexity Assessment
+├── 25-discover-component.md      # Component Discovery
+├── 26-analyze-tech-stack.md      # Tech Stack Analysis
+├── 27-scan-environment.md        # Environment Scan
+├── 28-validate-environment.md    # Environment Validation
+├── 29-generate-knowledge.md      # Knowledge Generation
+│
+├── # AI Specializations (30-41)
+├── 30-analyze-ai-capability.md   # AI Capability Analysis
+├── 31-analyze-ai-component.md    # AI Component Analysis
+├── 32-analyze-ai-agent.md        # AI Agent Analysis
+├── 33-analyze-ai-rag.md          # AI RAG Analysis
+├── 34-assess-ai-task.md          # AI Task Assessment
+├── 35-evaluate-ai-pipeline.md    # AI Pipeline Evaluation
+├── 36-evaluate-ai-artifact.md    # AI Artifact Evaluation
+├── 37-plan-ai-evaluation.md      # AI Evaluation Plan
+├── 38-evaluate-ai-path.md        # AI Path Evaluation
+├── 39-validate-ai-data.md        # AI Data Validation
+├── 40-detect-ai-anomaly.md       # AI Anomaly Detection
+├── 41-diagnose-ai-test.md        # AI Test Diagnosis
+│
+├── # Domain Methodologies (42-44)
+├── 42-apply-ddd.md               # DDD Application
+├── 43-run-ai-sdlc.md             # AI-SDLC Execution
+├── 44-manage-knowledge.md        # Knowledge Management
+│
+├── # Tool Skills (45)
+└── 45-test-runner.md             # Test Runner
+│
+└── # Files merged into templates (deleted)
+    # 51-build-glossary.md → 09-templates/05-business-glossary.md
+    # 52-define-domain-rules.md → 09-templates/06-business-rules.md
+    # 53-engineer-requirement.md → 09-templates/00-requirement-proposal.md
+    # 54-design-system.md → 09-templates/01-architecture-design.md
+    # 56-draw-flow-chart.md → 09-templates/07-business-flows.md
+```
+
+---
+
+## Skill Categories
+
+### Core Protocols (00-01)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [00-pipeline-protocol.md](00-pipeline-protocol.md) | Pipeline Protocol - Stage flow rules | 🟡 Controlled |
+| [01-team-orchestrator.md](01-team-orchestrator.md) | Team Orchestrator - Multi-Agent collaboration | 🟡 Controlled |
+
+### Stage Execution Skills (02-08)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [02-analyze-requirement.md](02-analyze-requirement.md) | Requirement Analysis - Extract, analyze, clarify | 🟡 Controlled |
+| [03-design-solution.md](03-design-solution.md) | Solution Design - Architecture, API, data models | 🟡 Controlled |
+| [04-implement-code.md](04-implement-code.md) | Code Implementation - Generate, self-test, refactor | 🟡 Controlled |
+| [05-plan-testing.md](05-plan-testing.md) | Testing Plan - Test strategy, coverage scope | 🟡 Controlled |
+| [06-generate-tests.md](06-generate-tests.md) | Generate Tests - Unit, integration test generation | 🟡 Controlled |
+| [07-check-release.md](07-check-release.md) | Release Check - Pre-release checklist | 🟡 Controlled |
+| [08-evaluate-ai-effect.md](08-evaluate-ai-effect.md) | AI Effect Evaluation - AI/ML feature evaluation | 🟡 Controlled |
+
+### Review Skills (09-14)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [09-review-requirement.md](09-review-requirement.md) | Requirement Review - Completeness, consistency | 🟡 Controlled |
+| [10-review-design.md](10-review-design.md) | Design Review - Architecture rationality, scalability | 🟡 Controlled |
+| [11-review-code.md](11-review-code.md) | Code Review - Code quality, security, maintainability | 🟡 Controlled |
+| [12-review-testing.md](12-review-testing.md) | Testing Review - Test coverage, sufficiency | 🟡 Controlled |
+| [13-audit-security.md](13-audit-security.md) | Security Audit - Security vulnerabilities, compliance | 🟡 Controlled |
+| [14-check-consistency.md](14-check-consistency.md) | Consistency Check - Cross-artifact consistency (DP18) | 🟡 Controlled |
+
+### Testing Execution Skills (15-17)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [15-run-unit-tests.md](15-run-unit-tests.md) | Unit Tests - Execute, analyze results | 🟡 Controlled |
+| [16-run-integration-tests.md](16-run-integration-tests.md) | Integration Tests - Execute, environment validation | 🟡 Controlled |
+| [17-analyze-test-context.md](17-analyze-test-context.md) | Test Context Analysis - Environment, dependencies | 🟡 Controlled |
+
+### Evolution Support Skills (18-22)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [18-log-practice.md](18-log-practice.md) | Practice Log - Execution metrics, lessons learned | 🟢 Free |
+| [19-distill-skill.md](19-distill-skill.md) | Skill Distillation - Extract new skills from practice | 🟢 Free |
+| [20-update-skill.md](20-update-skill.md) | Skill Update - Update existing skill files | 🟢 Free |
+| [21-validate-skill.md](21-validate-skill.md) | Skill Validation - Validate new skill effectiveness | 🟢 Free |
+| [22-extract-methodology.md](22-extract-methodology.md) | Methodology Extraction - Extract general methodologies | 🟢 Free |
+
+### Context/Environment Skills (23-29)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [23-infer-scope.md](23-infer-scope.md) | Scope Inference - Infer task scope, impact | 🟡 Controlled |
+| [24-assess-complexity.md](24-assess-complexity.md) | Complexity Assessment - Assess task complexity | 🟡 Controlled |
+| [25-discover-component.md](25-discover-component.md) | Component Discovery - Discover reusable components | 🟡 Controlled |
+| [26-analyze-tech-stack.md](26-analyze-tech-stack.md) | Tech Stack Analysis - Analyze project tech stack | 🟡 Controlled |
+| [27-scan-environment.md](27-scan-environment.md) | Environment Scan - Scan middleware, environment configs | 🟡 Controlled |
+| [28-validate-environment.md](28-validate-environment.md) | Environment Validation - Validate config completeness | 🟡 Controlled |
+| [29-generate-knowledge.md](29-generate-knowledge.md) | Knowledge Generation - Generate environment knowledge from code | 🟡 Controlled |
+
+### AI Specializations (30-41)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [30-analyze-ai-capability.md](30-analyze-ai-capability.md) | AI Capability Analysis - Analyze AI/ML requirements | 🟡 Controlled |
+| [31-analyze-ai-component.md](31-analyze-ai-component.md) | AI Component Analysis - Analyze AI component usage | 🟡 Controlled |
+| [32-analyze-ai-agent.md](32-analyze-ai-agent.md) | AI Agent Analysis - Analyze Agent architecture | 🟡 Controlled |
+| [33-analyze-ai-rag.md](33-analyze-ai-rag.md) | AI RAG Analysis - Analyze RAG systems | 🟡 Controlled |
+| [34-assess-ai-task.md](34-assess-ai-task.md) | AI Task Assessment - Assess AI task feasibility | 🟡 Controlled |
+| [35-evaluate-ai-pipeline.md](35-evaluate-ai-pipeline.md) | AI Pipeline Evaluation - Evaluate AI pipeline effectiveness | 🟡 Controlled |
+| [36-evaluate-ai-artifact.md](36-evaluate-ai-artifact.md) | AI Artifact Evaluation - Evaluate AI output quality | 🟡 Controlled |
+| [37-plan-ai-evaluation.md](37-plan-ai-evaluation.md) | AI Evaluation Plan - Plan AI evaluation approach | 🟡 Controlled |
+| [38-evaluate-ai-path.md](38-evaluate-ai-path.md) | AI Path Evaluation - Evaluate AI technical path | 🟡 Controlled |
+| [39-validate-ai-data.md](39-validate-ai-data.md) | AI Data Validation - Validate AI training/evaluation data | 🟡 Controlled |
+| [40-detect-ai-anomaly.md](40-detect-ai-anomaly.md) | AI Anomaly Detection - Detect AI anomalies | 🟡 Controlled |
+| [41-diagnose-ai-test.md](41-diagnose-ai-test.md) | AI Test Diagnosis - Diagnose AI test failures | 🟡 Controlled |
+
+### Domain Methodologies (42-44)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [42-apply-ddd.md](42-apply-ddd.md) | DDD Application - Domain-Driven Design practice | 🟡 Controlled |
+| [43-run-ai-sdlc.md](43-run-ai-sdlc.md) | AI-SDLC Execution - AI-enabled SDLC execution | 🟡 Controlled |
+| [44-manage-knowledge.md](44-manage-knowledge.md) | Knowledge Management - Knowledge management best practices | 🟡 Controlled |
+
+> **Note**: The following files have been merged into `09-templates/` directory and deleted:
+> - `51-build-glossary.md` → [05-business-glossary.md](../09-templates/05-business-glossary.md)
+> - `52-define-domain-rules.md` → [06-business-rules.md](../09-templates/06-business-rules.md)
+> - `53-engineer-requirement.md` → [00-requirement-proposal.md](../09-templates/00-requirement-proposal.md)
+> - `54-design-system.md` → [01-architecture-design.md](../09-templates/01-architecture-design.md)
+> - `56-draw-flow-chart.md` → [07-business-flows.md](../09-templates/07-business-flows.md)
+
+### Tool Skills (45)
+
+| File | Description | Evolution Zone |
+|------|-------------|----------------|
+| [45-test-runner.md](45-test-runner.md) | Test Runner - Unified test execution entry | 🟢 Free |
+
+---
+
+## Usage
+
+Skill files are automatically loaded during pipeline stages, no manual reference needed:
+
+```markdown
+<!-- Reference in stage skills -->
+See [Requirement Analysis Skill](02-analyze-requirement.md)
+```
+
+---
+
+## Related Documents
+
+| Document | Description |
+|----------|-------------|
+| [../02-process/](../02-process/) | Process Layer - Skills applied to stages |
+| [../04-checklists/](../04-checklists/) | Checklists - Specific checkpoints for skill execution |
+| [../01-principles/](../01-principles/) | Principles Layer - Principle basis for skill design |
+
+---
+
+**Maintainer**: AutoSpec Team
+**Evolution Zone**: 🟡 Controlled / 🟢 Free
+**Version**: v1.0
+**Last Updated**: 2026-03-27

package/knowledge/03-guides/README.md

@@ -0,0 +1,212 @@
+# 能力指南
+
+> **定位**: 51 个技能文件，覆盖核心协议、阶段执行、审查技能、测试执行、进化支撑、AI 专项等
+>
+> **进化分区**: 🟡 受控区 / 🟢 自由区（按技能类型）
+
+---
+
+## 目录结构
+
+```
+03-guides/
+├── 00-pipeline-protocol.md       # 流水线协议
+├── 01-team-orchestrator.md       # 团队编排器
+│
+├── # 阶段执行 (02-08)
+├── 02-analyze-requirement.md     # 需求分析
+├── 03-design-solution.md         # 方案设计
+├── 04-implement-code.md          # 编码实现
+├── 05-plan-testing.md            # 测试计划
+├── 06-generate-tests.md          # 生成测试
+├── 07-check-release.md           # 发布检查
+├── 08-evaluate-ai-effect.md      # AI 效果评估
+│
+├── # 审查技能 (09-14)
+├── 09-review-requirement.md      # 需求审查
+├── 10-review-design.md           # 设计审查
+├── 11-review-code.md             # 代码审查
+├── 12-review-testing.md          # 测试审查
+├── 13-audit-security.md          # 安全审计
+├── 14-check-consistency.md       # 一致性检查
+│
+├── # 测试执行 (15-17)
+├── 15-run-unit-tests.md          # 单元测试
+├── 16-run-integration-tests.md   # 集成测试
+├── 17-analyze-test-context.md    # 测试上下文分析
+│
+├── # 进化支撑 (18-22)
+├── 18-log-practice.md            # 实践日志
+├── 19-distill-skill.md           # 技能蒸馏
+├── 20-update-skill.md            # 技能更新
+├── 21-validate-skill.md          # 技能验证
+├── 22-extract-methodology.md     # 方法论提取
+│
+├── # 上下文/环境 (23-29)
+├── 23-infer-scope.md             # 范围推断
+├── 24-assess-complexity.md       # 复杂度评估
+├── 25-discover-component.md      # 组件发现
+├── 26-analyze-tech-stack.md      # 技术栈分析
+├── 27-scan-environment.md        # 环境扫描
+├── 28-validate-environment.md    # 环境验证
+├── 29-generate-knowledge.md      # 知识生成
+│
+├── # AI 专项 (30-41)
+├── 30-analyze-ai-capability.md   # AI 能力分析
+├── 31-analyze-ai-component.md    # AI 组件分析
+├── 32-analyze-ai-agent.md        # AI 代理分析
+├── 33-analyze-ai-rag.md          # AI RAG 分析
+├── 34-assess-ai-task.md          # AI 任务评估
+├── 35-evaluate-ai-pipeline.md    # AI 流水线评估
+├── 36-evaluate-ai-artifact.md    # AI 产出物评估
+├── 37-plan-ai-evaluation.md      # AI 评测计划
+├── 38-evaluate-ai-path.md        # AI 路径评估
+├── 39-validate-ai-data.md        # AI 数据验证
+├── 40-detect-ai-anomaly.md       # AI 异常检测
+├── 41-diagnose-ai-test.md        # AI 测试诊断
+│
+├── # 领域方法论 (42-44)
+├── 42-apply-ddd.md               # DDD 应用
+├── 43-run-ai-sdlc.md             # AI-SDLC 执行
+├── 44-manage-knowledge.md        # 知识管理
+│
+├── # 工具技能 (45)
+└── 45-test-runner.md             # 测试运行器
+│
+└── # 已整合到 templates 的文件（已删除）
+    # 51-build-glossary.md → 09-templates/05-business-glossary.md
+    # 52-define-domain-rules.md → 09-templates/06-business-rules.md
+    # 53-engineer-requirement.md → 09-templates/00-requirement-proposal.md
+    # 54-design-system.md → 09-templates/01-architecture-design.md
+    # 56-draw-flow-chart.md → 09-templates/07-business-flows.md
+```
+
+---
+
+## 技能分类
+
+### 核心协议 (00-01)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [00-pipeline-protocol.md](00-pipeline-protocol.md) | 流水线协议 - 定义各阶段流转规则 | 🟡 受控区 |
+| [01-team-orchestrator.md](01-team-orchestrator.md) | 团队编排器 - 多 Agent 协作协议 | 🟡 受控区 |
+
+### 阶段执行技能 (02-08)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [02-analyze-requirement.md](02-analyze-requirement.md) | 需求分析 - 需求提取、分析、澄清 | 🟡 受控区 |
+| [03-design-solution.md](03-design-solution.md) | 方案设计 - 架构设计、API 设计、数据模型 | 🟡 受控区 |
+| [04-implement-code.md](04-implement-code.md) | 编码实现 - 代码生成、自测、重构 | 🟡 受控区 |
+| [05-plan-testing.md](05-plan-testing.md) | 测试计划 - 测试策略、覆盖范围 | 🟡 受控区 |
+| [06-generate-tests.md](06-generate-tests.md) | 生成测试 - 单元测试、集成测试生成 | 🟡 受控区 |
+| [07-check-release.md](07-check-release.md) | 发布检查 - 发布前检查清单 | 🟡 受控区 |
+| [08-evaluate-ai-effect.md](08-evaluate-ai-effect.md) | AI 效果评估 - AI/ML 功能效果评估 | 🟡 受控区 |
+
+### 审查技能 (09-14)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [09-review-requirement.md](09-review-requirement.md) | 需求审查 - 需求完整性、一致性检查 | 🟡 受控区 |
+| [10-review-design.md](10-review-design.md) | 设计审查 - 架构合理性、可扩展性 | 🟡 受控区 |
+| [11-review-code.md](11-review-code.md) | 代码审查 - 代码质量、安全性、可维护性 | 🟡 受控区 |
+| [12-review-testing.md](12-review-testing.md) | 测试审查 - 测试覆盖度、充分性 | 🟡 受控区 |
+| [13-audit-security.md](13-audit-security.md) | 安全审计 - 安全漏洞、合规性检查 | 🟡 受控区 |
+| [14-check-consistency.md](14-check-consistency.md) | 一致性检查 - 跨产物一致性分析 (DP18) | 🟡 受控区 |
+
+### 测试执行技能 (15-17)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [15-run-unit-tests.md](15-run-unit-tests.md) | 单元测试 - 执行单元测试、分析结果 | 🟡 受控区 |
+| [16-run-integration-tests.md](16-run-integration-tests.md) | 集成测试 - 执行集成测试、环境验证 | 🟡 受控区 |
+| [17-analyze-test-context.md](17-analyze-test-context.md) | 测试上下文分析 - 测试环境、依赖分析 | 🟡 受控区 |
+
+### 进化支撑技能 (18-22)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [18-log-practice.md](18-log-practice.md) | 实践日志 - 记录执行度量、经验总结 | 🟢 自由区 |
+| [19-distill-skill.md](19-distill-skill.md) | 技能蒸馏 - 从实践中提炼新技能 | 🟢 自由区 |
+| [20-update-skill.md](20-update-skill.md) | 技能更新 - 更新已有技能文件 | 🟢 自由区 |
+| [21-validate-skill.md](21-validate-skill.md) | 技能验证 - 验证新技能有效性 | 🟢 自由区 |
+| [22-extract-methodology.md](22-extract-methodology.md) | 方法论提取 - 提炼通用方法论 | 🟢 自由区 |
+
+### 上下文/环境技能 (23-29)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [23-infer-scope.md](23-infer-scope.md) | 范围推断 - 推断任务范围、影响面 | 🟡 受控区 |
+| [24-assess-complexity.md](24-assess-complexity.md) | 复杂度评估 - 评估任务复杂度 | 🟡 受控区 |
+| [25-discover-component.md](25-discover-component.md) | 组件发现 - 发现可复用组件 | 🟡 受控区 |
+| [26-analyze-tech-stack.md](26-analyze-tech-stack.md) | 技术栈分析 - 分析项目技术栈 | 🟡 受控区 |
+| [27-scan-environment.md](27-scan-environment.md) | 环境扫描 - 扫描中间件、环境配置 | 🟡 受控区 |
+| [28-validate-environment.md](28-validate-environment.md) | 环境验证 - 验证环境配置完整性 | 🟡 受控区 |
+| [29-generate-knowledge.md](29-generate-knowledge.md) | 知识生成 - 从代码生成环境知识 | 🟡 受控区 |
+
+### AI 专项技能 (30-41)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [30-analyze-ai-capability.md](30-analyze-ai-capability.md) | AI 能力分析 - 分析 AI/ML 能力需求 | 🟡 受控区 |
+| [31-analyze-ai-component.md](31-analyze-ai-component.md) | AI 组件分析 - 分析 AI 组件使用 | 🟡 受控区 |
+| [32-analyze-ai-agent.md](32-analyze-ai-agent.md) | AI 代理分析 - 分析 Agent 架构 | 🟡 受控区 |
+| [33-analyze-ai-rag.md](33-analyze-ai-rag.md) | AI RAG 分析 - 分析 RAG 系统 | 🟡 受控区 |
+| [34-assess-ai-task.md](34-assess-ai-task.md) | AI 任务评估 - 评估 AI 任务可行性 | 🟡 受控区 |
+| [35-evaluate-ai-pipeline.md](35-evaluate-ai-pipeline.md) | AI 流水线评估 - 评估 AI 流水线效果 | 🟡 受控区 |
+| [36-evaluate-ai-artifact.md](36-evaluate-ai-artifact.md) | AI 产出物评估 - 评估 AI 产出质量 | 🟡 受控区 |
+| [37-plan-ai-evaluation.md](37-plan-ai-evaluation.md) | AI 评测计划 - 规划 AI 评测方案 | 🟡 受控区 |
+| [38-evaluate-ai-path.md](38-evaluate-ai-path.md) | AI 路径评估 - 评估 AI 技术路径 | 🟡 受控区 |
+| [39-validate-ai-data.md](39-validate-ai-data.md) | AI 数据验证 - 验证 AI 训练/评测数据 | 🟡 受控区 |
+| [40-detect-ai-anomaly.md](40-detect-ai-anomaly.md) | AI 异常检测 - 检测 AI 异常行为 | 🟡 受控区 |
+| [41-diagnose-ai-test.md](41-diagnose-ai-test.md) | AI 测试诊断 - 诊断 AI 测试失败 | 🟡 受控区 |
+
+### 领域方法论 (42-44)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [42-apply-ddd.md](42-apply-ddd.md) | DDD 应用 - 领域驱动设计实践 | 🟡 受控区 |
+| [43-run-ai-sdlc.md](43-run-ai-sdlc.md) | AI-SDLC 执行 - AI 赋能的 SDLC 执行 | 🟡 受控区 |
+| [44-manage-knowledge.md](44-manage-knowledge.md) | 知识管理 - 知识管理最佳实践 | 🟡 受控区 |
+
+> **注意**：以下文件已整合到 `09-templates/` 目录，原文件已删除：
+> - `51-build-glossary.md` → [05-business-glossary.md](../09-templates/05-business-glossary.md)
+> - `52-define-domain-rules.md` → [06-business-rules.md](../09-templates/06-business-rules.md)
+> - `53-engineer-requirement.md` → [00-requirement-proposal.md](../09-templates/00-requirement-proposal.md)
+> - `54-design-system.md` → [01-architecture-design.md](../09-templates/01-architecture-design.md)
+> - `56-draw-flow-chart.md` → [07-business-flows.md](../09-templates/07-business-flows.md)
+
+### 工具技能 (45)
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [45-test-runner.md](45-test-runner.md) | 测试运行器 - 统一测试执行入口 | 🟢 自由区 |
+
+---
+
+## 使用方式
+
+技能文件在流水线各阶段自动加载，无需手动引用：
+
+```markdown
+<!-- 在阶段 skill 中引用 -->
+详见 [需求分析技能](02-analyze-requirement.md)
+```
+
+---
+
+## 与相关文档的关系
+
+| 文档 | 说明 |
+|------|------|
+| [../02-process/](../02-process/) | 流程层 - 技能应用于各阶段 |
+| [../04-checklists/](../04-checklists/) | 检查清单 - 技能执行的具体检查项 |
+| [../01-principles/](../01-principles/) | 原则层 - 技能设计的原则依据 |
+
+---
+
+**维护者**: AutoSpec 团队
+**进化分区**: 🟡 受控区 / 🟢 自由区
+**版本**: v1.0
+**最后更新**: 2026-03-27

package/knowledge/{checklists/requirement.md → 04-checklists/00-requirement.md}

@@ -166,4 +166,4 @@
 
 - [需求工程指南](../guides/requirement-engineering.md)
 - [proposal 模板](../templates/proposal.md)
-- [设计哲学 - 结构化澄清协议](../principles/design-philosophy.md#dp19-结构化澄清协议)
+- [设计哲学 - 结构化澄清协议](../principles/01-first-principles.md#dp19-结构化澄清协议)

package/knowledge/{checklists/design.md → 04-checklists/01-design.md}

@@ -193,4 +193,4 @@
 
 - [系统设计指南](../guides/system-design.md)
 - [design 模板](../templates/design.md)
-- [设计哲学 - 两步生成](../principles/design-philosophy.md#核心设计模式)
+- [设计哲学 - 两步生成](../principles/01-first-principles.md#核心设计模式)

package/knowledge/{checklists/code.md → 04-checklists/02-code.md}

@@ -73,6 +73,21 @@
 - [ ] 关键业务节点有日志
 - [ ] 异常日志包含异常对象
 
+### AOP 原则检查（跨切面功能）
+
+- [ ] **日志打印**：使用 LogUtil 而非直接 Logger（自动带 TraceId）
+- [ ] **监控埋点**：关键业务节点有 [MONITOR] 日志标记
+- [ ] **鉴权拦截**：权限校验通过切面实现，不侵入业务代码
+- [ ] **事务管理**：事务通过 @Transactional 注解实现
+- [ ] **异常处理**：全局异常处理器统一处理
+- [ ] **TraceId 传递**：入口方法有 TraceId 传递（Controller 层）
+
+### 埋点规范检查
+
+- [ ] 入口方法有 TraceId 传递
+- [ ] 关键业务状态变更有监控埋点
+- [ ] 外部调用有耗时统计埋点
+
 ---
 
 ## 代码质量检查
@@ -179,4 +194,4 @@
 
 - [编码规范](../standards/coding-style.md)
 - [Code Review 规范](../standards/code-review.md)
-- [设计哲学 - 双层验证](../principles/design-philosophy.md#dp1-双层验证)
+- [设计哲学 - 双层验证](../principles/01-first-principles.md#dp1-双层验证)

package/knowledge/{checklists/release.md → 04-checklists/04-release.md}

@@ -1,6 +1,6 @@
 # 发布准备检查清单
 
-> 供 pipeline/06-delivery.md 质量关卡和 skills/stages/release-checker.md 引用。
+> 供 knowledge/02-process/06-delivery.md 质量关卡和 skills/delivery-stage 引用。
 
 ## 必须检查
 

package/knowledge/04-checklists/README.en.md

@@ -0,0 +1,119 @@
+# Checklists
+
+> **Purpose**: Self-check lists before each stage completion, ensuring quality gates
+>
+> **Evolution Zone**: 🟡 Controlled (Auto-proposed + Human-approved)
+
+---
+
+## Directory Structure
+
+```
+04-checklists/
+├── README.md                     # This file (Checklists Navigation)
+├── 00-requirement.md             # Requirement Checklist
+├── 01-design.md                  # Design Checklist
+├── 02-code.md                    # Code Checklist
+├── 03-test.md                    # Testing Checklist
+└── 04-release.md                 # Release Checklist
+```
+
+---
+
+## Checklist Description
+
+### 00-requirement.md — Requirement Checklist
+
+**Content**: Check items before Requirement Analysis stage completion
+
+**Core Chapters**:
+- Requirement Completeness Check
+- Acceptance Criteria Clarity
+- Dependency & Constraint Identification
+- Clarification Questions Marked
+
+**Location**: [00-requirement.md](00-requirement.md)
+
+### 01-design.md — Design Checklist
+
+**Content**: Check items before Solution Design stage completion
+
+**Core Chapters**:
+- Architecture Design Rationality
+- Data Model Design
+- API Design Completeness
+- Technology Selection Record
+- Risk Assessment
+
+**Location**: [01-design.md](01-design.md)
+
+### 02-code.md — Code Checklist
+
+**Content**: Check items before Implementation stage completion
+
+**Core Chapters**:
+- Layer 1 Validation (Build/Test/Lint/Type Check)
+- Data Safety (Lock-Check-Update)
+- Exception Handling
+- Multi-threading Safety
+- Database Operations
+- Logging Standards
+
+**Location**: [02-code.md](02-code.md)
+
+### 03-test.md — Testing Checklist
+
+**Content**: Check items before QA Testing stage completion
+
+**Core Chapters**:
+- Test Case Coverage
+- Integration Test Completeness
+- E2E Testing
+- Acceptance Testing
+- Performance Testing (if required)
+
+**Location**: [03-test.md](03-test.md)
+
+### 04-release.md — Release Checklist
+
+**Content**: Check items before Delivery stage completion
+
+**Core Chapters**:
+- Pre-release Check
+- Rollback Plan
+- Monitoring & Alerting
+- Documentation Completeness
+
+**Location**: [04-release.md](04-release.md)
+
+---
+
+## Usage
+
+Each checklist is executed before completing the corresponding stage:
+
+```
+Stage Execution → Layer 1 Validation → Layer 2 Review → Checklist Self-Check → Stage Complete
+```
+
+**Checklist Embedding**:
+- Each stage's skill automatically loads the corresponding checklist
+- AI self-checks against the checklist during execution
+- Automatically supplements any missing items
+
+---
+
+## Related Documents
+
+| Document | Description |
+|----------|-------------|
+| [../02-process/](../02-process/) | 6-Stage Process Definition |
+| [../07-standards/](../07-standards/) | Coding/Review Standards |
+| [../03-guides/](../03-guides/) | Stage Execution Skills |
+
+---
+
+**Maintainer**: AutoSpec Team
+**Evolution Zone**: 🟡 Controlled
+**Version**: v1.0
+**Last Updated**: 2026-03-27