@chongyan/autospec 1.0.1 → 1.0.3

package/knowledge/README.md

@@ -1,144 +0,0 @@
-# AutoSpec 知识层
-
-本目录包含 AutoSpec 的核心知识文件，在 `autospec init` 时会复制到用户项目的 `.autospec/knowledge/` 目录。
-
-## 人类-[skills]-创业团队-skills-领域知识分层理念
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  人类维护层 (Human-maintained)                                    │
-│  domain/ - 业务知识（术语、规则、流程）                          │
-│  由领域专家维护，AI 读取但不修改                                   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 驱动
-┌─────────────────────────────────────────────────────────────────┐
-│  创业团队 Skills (AI Agent Roles)                                 │
-│  ../plugins/agents/roles/ - CEO、产品负责人、技术负责人、工程师等   │
-│  模拟创业团队对抗审查，多视角审视产出                              │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 执行
-┌─────────────────────────────────────────────────────────────────┐
-│  阶段 Skills (Stage Skills)                                       │
-│  ../plugins/skills/*-stage/ - 需求分析、方案设计、编码实现等       │
-│  驱动各阶段执行，产出标准化产物                                    │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 支撑
-┌─────────────────────────────────────────────────────────────────┐
-│  领域知识/规范分层 (Knowledge & Standards)                        │
-│  本目录 - 原则、流程、指南、检查清单                              │
-│  按冻结区/受控区/自由区分层管理                                    │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## 三层自进化体系
-
-| 层级 | 命令 | 目标 | 位置 |
-|------|------|------|------|
-| L1: Self-Evolve | `/self-evolve` | 框架自身的迭代升级 | `.claude/skills/self-evolve/` |
-| L2: Field-Evolve | `/autospec:field-evolve` | 从实战项目中学习和提炼 | `plugins/commands/autospec:field-evolve.md` |
-| L3: Project-Evolve | `/autospec:project-evolve` | 实战项目自身的优化 | `plugins/commands/autospec:project-evolve.md` |
-
-**基于评测驱动的进化**：实战流程 → Benchmarks 评测 → Field-Evolve 分析 → 提炼通用模板 → 更新框架能力
-
-## 目录结构
-
-```
-knowledge/
-├── principles/         # 原则层（宪法、进化规则、设计哲学）
-│   ├── constitution.md     # 宪法红线（不可违反的规则）- 冻结区
-│   ├── evolution.md        # 自进化机制 - 冻结区
-│   ├── core-principles.md  # 核心原则（44条方法论）
-│   └── design-philosophy.md # 设计哲学 - 冻结区/受控区
-├── process/            # 流程知识（6阶段 + 4种工作流）- 受控区
-│   ├── overview.md         # 迭代模式概览
-│   ├── ai-sdlc.md         # AI-Enhanced SDLC 规范
-│   ├── 01-requirement.md   # 需求分析阶段
-│   ├── 02-design.md        # 方案设计阶段
-│   ├── 03-implementation.md # 编码实施阶段
-│   ├── 04-review.md        # 审查阶段
-│   ├── 05-testing.md       # 测试阶段
-│   └── 06-delivery.md      # 交付阶段
-├── guides/             # 能力指南（阶段技能 + 支撑技能）- 受控区/自由区
-│   ├── stages/             # 阶段技能
-│   └── support/            # 支撑技能
-├── checklists/         # 检查清单 - 受控区
-│   ├── requirement.md      # 需求检查清单
-│   ├── design.md           # 设计检查清单
-│   ├── code.md             # 编码检查清单
-│   ├── test.md             # 测试检查清单
-│   └── release.md          # 发布检查清单
-├── environment/        # 环境知识（中间件、组件、检测模式）- 环境知识区
-│   ├── component-knowledge.md
-│   ├── middleware-knowledge.md
-│   ├── template-registry.md
-│   └── detection-patterns.yaml
-├── config/             # 配置知识 - 受控区
-│   ├── validation-patterns.yaml
-│   ├── team-triggers.yaml
-│   └── *.yaml
-├── domain/             # 业务知识（人类维护）- 人类层
-│   ├── glossary.md         # 术语表
-│   ├── rules.md            # 业务规则
-│   └── flows/              # 流程图
-├── templates/          # 文档模板
-│   ├── document-versioning.md
-│   ├── risk-detection.md
-│   └── ...                 # 各类设计模板
-└── organization/       # 组织知识（AI Native 团队文化）
-    ├── ai-native-team.md   # AI Native 团队文化手册
-    └── team-metrics.md     # 团队度量体系
-```
-
-## 核心文件说明
-
-| 文件/目录 | 说明 | 进化分区 | 详细文档 |
-|-----------|------|---------|---------|
-| `principles/constitution.md` | 宪法红线，不可违反的规则 | 🔴 冻结区 | 直接阅读 |
-| `principles/evolution.md` | 三层自进化体系，进化分区 + 安全护栏 | 🔴 冻结区 | 直接阅读 |
-| `principles/core-principles.md` | 44条核心方法论原则 | 🔴/🟡 冻结/受控区 | 直接阅读 |
-| `principles/design-philosophy.md` | 设计哲学和核心原则 | 🔴/🟡 冻结/受控区 | 直接阅读 |
-| `process/` | 6阶段研发流程定义 | 🟡 受控区 | [process/overview.md](process/overview.md) |
-| `process/ai-sdlc.md` | AI-Enhanced SDLC 规范 | 🟢 自由区 | [process/ai-sdlc.md](process/ai-sdlc.md) |
-| `guides/` | 可执行技能指南（做类 + 审类） | 🟡/🟢 受控/自由区 | [guides/stages/](guides/stages/) |
-| `checklists/` | 各阶段检查清单 | 🟡 受控区 | [checklists/](checklists/) |
-| `environment/` | 环境衔接协议 | 🔵 环境知识区 | [environment/README.md](environment/README.md) |
-| `config/` | 配置文件 | 🟡 受控区 | [config/README.md](config/README.md) |
-| `domain/` | 业务知识（术语、规则、流程） | 人类层 | [domain/README.md](domain/README.md) |
-| `templates/` | 文档模板 | 🟡 受控区 | [templates/](templates/) |
-| `organization/` | AI Native 团队文化 | 🟢 自由区 | [organization/ai-native-team.md](organization/ai-native-team.md) |
-
-### Benchmarks 评测相关
-
-| 文件/目录 | 说明 | 位置 |
-|-----------|------|------|
-| `../plugins/skills/benchmark-generator/SKILL.md` | Benchmarks 自动生成技能 | 自由区 |
-| `../plugins/skills/benchmark-executor/SKILL.md` | Benchmarks 执行技能 | 自由区 |
-| `../plugins/hooks/lib/benchmarks/` | 评测执行器、改动检测器 | 执行层 |
-
-## 设计原则
-
-知识层设计遵循以下原则：
-
-1. **自闭环**：知识文件不依赖 `scripts/` 代码，可独立复制到用户项目
-2. **可扩展**：通过企业叠加层支持组织定制
-3. **可进化**：通过三层自进化体系（L1 Self-Evolve → L2 Field-Evolve → L3 Project-Evolve）实现持续改进
-4. **人机分离**：`domain/` 目录专门存放人类维护的业务知识
-5. **评测驱动**：通过 Benchmarks 评测量化进化效果，确保改进有据可依
-
-## 使用方式
-
-```bash
-# 初始化项目（复制知识层到 .autospec/knowledge/）
-autospec init
-
-# 更新知识层（保留运行时状态）
-autospec update
-```
-
-## 运行时目录
-
-以下目录在运行时自动生成：
-
-- `evaluation/` - 基准案例（从成功/失败案例自动归档）
-- `evolution/` - 进化记录（practice-log、改进提案等）
-- `environment/` - 环境知识（自动检测生成）

package/knowledge/checklists/code.md

@@ -1,182 +0,0 @@
-# 编码实现检查清单
-
-> **版本**: v2.0
-> **最后更新**: 2026-03-26
-> **基于**: 业界编码规范 + Code Review 规范
-> **适用范围**: 所有编码实现场景
-
----
-
-## Layer 1 验证检查
-
-### 编译检查
-
-- [ ] 代码编译通过
-- [ ] 无编译警告（或警告已评估可接受）
-- [ ] 编译日志已保存
-
-### 单元测试检查
-
-- [ ] 新增代码有对应单元测试
-- [ ] 现有测试全部通过
-- [ ] 测试覆盖率达标（本次变更行覆盖率 ≥ 工程整体覆盖率）
-- [ ] 测试日志已保存
-
-### Lint 检查
-
-- [ ] 代码风格符合规范
-- [ ] 无 lint 警告
-- [ ] Lint 报告已保存
-
-### 类型检查
-
-- [ ] 类型定义完整
-- [ ] 无类型错误
-- [ ] 类型检查报告已保存
-
----
-
-## 编码规范检查
-
-### 数据安全（一锁二判三更新）
-
-- [ ] 并发场景已加锁（锁定单点资源）
-- [ ] 基于最新状态判断（状态检查、金额检查）
-- [ ] 判断通过后再更新
-- [ ] 金额计算使用 Money 类（禁止 float/double）
-
-### 异常处理
-
-- [ ] 异步方法已捕获异常（@Async、线程池、Future）
-- [ ] 无空 catch 块
-- [ ] 异常日志包含完整堆栈
-- [ ] 异常级别准确（ERROR/WARN/INFO）
-
-### 多线程
-
-- [ ] ThreadLocal 使用完毕后调用 remove() 清理
-- [ ] 线程池为有界线程池（队列长度≤100）
-- [ ] 无全局变量/static 变量滥用
-- [ ] 共享对象有锁保护
-
-### 数据库
-
-- [ ] 无 SELECT * 查询
-- [ ] 使用参数化查询（#{}，禁止 ${}）
-- [ ] SQL 带 where 条件
-- [ ] 查询走索引
-
-### 日志规范
-
-- [ ] 使用 LogUtil 打印日志（带 TraceId）
-- [ ] 使用{0}{1}占位符（不字符串拼接）
-- [ ] 关键业务节点有日志
-- [ ] 异常日志包含异常对象
-
----
-
-## 代码质量检查
-
-### 可读性
-
-- [ ] 命名清晰表达用途
-- [ ] 注释解释"为什么"而非"是什么"
-- [ ] 代码风格与团队一致
-- [ ] 函数长度合理（<50 行）
-- [ ] 嵌套层次不超过 2 层
-- [ ] if 分支不超过 5 个
-
-### 可靠性
-
-- [ ] 有水平权限校验
-- [ ] 后端接口校验入参
-- [ ] 对象比较使用 equals
-- [ ] 有超时时间设置
-- [ ] 资源正确释放
-
-### 可扩展性
-
-- [ ] 功能可继续扩展
-- [ ] 无并发瓶颈
-- [ ] 锁粒度合理
-
----
-
-## 功能实现检查
-
-- [ ] 需求完整实现（对照 design.md）
-- [ ] 边界情况已处理
-- [ ] 异常情况已处理
-- [ ] 向后兼容
-
----
-
-## 三板斧检查
-
-### 灰度
-
-- [ ] 功能开关已添加
-- [ ] 灰度配置已添加（DRM 等）
-- [ ] 降级方案已实现
-
-### 监控
-
-- [ ] 关键业务节点有日志
-- [ ] 监控指标已埋点
-- [ ] 异常告警已配置
-
-### 应急
-
-- [ ] 应急操作手册已编写
-- [ ] 回滚方案已验证
-- [ ] 负责人已明确
-
----
-
-## 自测检查
-
-### 正向场景
-
-- [ ] 主流程自测通过
-- [ ] 正常输入输出符合预期
-
-### 异常场景
-
-- [ ] 异常输入处理正确
-- [ ] 错误提示友好
-
-### 边界场景
-
-- [ ] 边界值处理正确
-- [ ] 极限情况处理正确
-
-### 幂等场景
-
-- [ ] 重复调用处理正确
-- [ ] 状态机推进正确
-
----
-
-## 检查记录
-
-| 检查项 | 检查结果 | 检查人 | 检查日期 |
-|-------|---------|--------|---------|
-| Layer 1 验证 | 通过/不通过 | | |
-| 编码规范 | 通过/不通过 | | |
-| 代码质量 | 通过/不通过 | | |
-| 功能实现 | 通过/不通过 | | |
-| 三板斧 | 通过/不通过 | | |
-| 自测 | 通过/不通过 | | |
-
-**总体结论**: 通过 / 不通过
-
-**备注**:
-{记录需要关注的问题}
-
----
-
-## 参考资料
-
-- [编码规范](../standards/coding-style.md)
-- [Code Review 规范](../standards/code-review.md)
-- [设计哲学 - 双层验证](../principles/design-philosophy.md#dp1-双层验证)

package/knowledge/checklists/design.md

@@ -1,196 +0,0 @@
-# 设计分析检查清单
-
-> **版本**: v2.0
-> **最后更新**: 2026-03-26
-> **基于**: 业界系统设计检查清单
-> **适用范围**: 所有系统设计场景
-
----
-
-## 必填章节检查
-
-以下章节为必填，缺少则设计文档不完整：
-
-- [ ] 1. 项目背景
-- [ ] 2. 业务用例
-- [ ] 3.1 功能点列表
-- [ ] 3.2 所有功能点的详细设计
-
----
-
-## 两步生成检查
-
-### Phase 1: 大纲生成
-
-- [ ] 项目背景填写完整（目标、参与人、相关文档）
-- [ ] 业务用例图从 proposal 正确提取
-- [ ] 功能点列表完整，覆盖 proposal 所有功能
-- [ ] 功能点命名清晰，职责单一
-- [ ] 功能点全部标记为 `- [ ]` 未完成
-- [ ] 详细设计章节占位符正确（`> ⏳ 待细化`）
-
-### Phase 2: 逐个细化
-
-- [ ] 所有功能点已标记为 `- [x]` 完成
-- [ ] 每个功能点都有详细设计内容
-- [ ] 详细设计包含概述、流程图、下游交互等
-- [ ] 流程图可正常渲染
-- [ ] 与 proposal.md 业务流程一致
-
----
-
-## 设计质量检查
-
-### 设计原则检查
-
-- [ ] 无实现代码平铺（方法设计只描述职责、入参、输出）
-- [ ] 功能点职责不重叠（无多个功能点重复描述同一逻辑）
-- [ ] 开关/配置无过度设计（能由调用方控制的不在本系统加开关）
-- [ ] 新增配置与项目已有配置声明方式一致
-
-### 领域模型检查
-
-- [ ] 领域模型图清晰展示实体关系
-- [ ] 状态机图正确描述状态流转
-- [ ] 数据库设计符合范式
-- [ ] 索引设计合理
-
-### 接口设计检查
-
-- [ ] 接口定义清晰（输入、输出、错误码）
-- [ ] 接口粒度适中（不过粗不过细）
-- [ ] 接口版本管理策略明确
-- [ ] 向后兼容性已考虑
-
----
-
-## 架构规范检查
-
-### 分层架构
-
-- [ ] 系统分层清晰（业务层、领域层、数据层）
-- [ ] 各层职责明确
-- [ ] 层间依赖合理（不跨层、不循环）
-
-### 模块划分
-
-- [ ] 模块职责单一
-- [ ] 模块间接口清晰
-- [ ] 模块可独立测试
-
-### 依赖管理
-
-- [ ] 依赖方向正确（依赖抽象不依赖具体）
-- [ ] 无循环依赖
-- [ ] 第三方依赖版本明确
-
----
-
-## 共享组件/依赖库检查（如涉及）
-
-- [ ] Maven 坐标明确（groupId:artifactId）
-- [ ] 当前版本明确
-- [ ] 升级版本明确
-- [ ] 变更内容详细说明
-- [ ] 需升级的系统列表明确
-
----
-
-## 非功能设计检查
-
-### 性能设计
-
-- [ ] 性能目标明确
-- [ ] 瓶颈分析到位
-- [ ] 优化措施具体
-
-### 安全设计
-
-- [ ] 认证方案明确
-- [ ] 授权方案明确
-- [ ] 数据保护方案明确
-
-### 可用性设计
-
-- [ ] SLA 目标明确
-- [ ] 降级策略具体
-- [ ] 容灾方案完备
-
----
-
-## 三板斧检查
-
-### 灰度策略
-
-- [ ] 灰度维度已定义
-- [ ] 灰度比例已明确
-- [ ] 灰度回滚方案已定义
-
-### 监控设计
-
-- [ ] 关键业务节点已识别
-- [ ] 监控指标已定义
-- [ ] 告警阈值已明确
-
-### 应急预案
-
-- [ ] 风险项已识别
-- [ ] 应急操作已定义
-- [ ] 操作步骤清晰
-
----
-
-## 关键假设检查
-
-- [ ] 关键假设清单已填写
-- [ ] 假设分为"已确认"和"待确认"
-- [ ] 待确认假设不超过 3 个
-- [ ] 需求阶段的关键假设已校验
-
----
-
-## 风险检查
-
-- [ ] 技术风险已识别
-- [ ] 业务风险已识别
-- [ ] 缓解措施已定义
-
----
-
-## 文档质量检查
-
-- [ ] 文档结构符合模板
-- [ ] 流程图可正常渲染
-- [ ] 链接全部有效
-- [ ] 无拼写错误和语法错误
-- [ ] 格式统一
-
----
-
-## 检查记录
-
-| 检查项 | 检查结果 | 检查人 | 检查日期 |
-|-------|---------|--------|---------|
-| 必填章节 | 通过/不通过 | | |
-| 两步生成 | 通过/不通过 | | |
-| 设计质量 | 通过/不通过 | | |
-| 架构规范 | 通过/不通过 | | |
-| 共享组件/依赖库 | 通过/不通过 | | |
-| 非功能设计 | 通过/不通过 | | |
-| 三板斧 | 通过/不通过 | | |
-| 关键假设 | 通过/不通过 | | |
-| 风险 | 通过/不通过 | | |
-| 文档质量 | 通过/不通过 | | |
-
-**总体结论**: 通过 / 不通过
-
-**备注**:
-{记录需要关注的问题}
-
----
-
-## 参考资料
-
-- [系统设计指南](../guides/system-design.md)
-- [design 模板](../templates/design.md)
-- [设计哲学 - 两步生成](../principles/design-philosophy.md#核心设计模式)

package/knowledge/checklists/release.md

@@ -1,70 +0,0 @@
-# 发布准备检查清单
-
-> 供 pipeline/06-delivery.md 质量关卡和 skills/stages/release-checker.md 引用。
-
-## 必须检查
-
-### 基础检查
-
-- [ ] QA测试报告结论为通过
-- [ ] 无未解决的Critical/Major级别缺陷
-- [ ] 回滚方案已准备并验证可行
-- [ ] 变更记录已编写（含功能/修复列表、影响范围）
-- [ ] 数据库变更（如有）已review并有回滚脚本
-- [ ] 配置变更（如有）已确认
-- [ ] 应急开关/降级方案已准备（限流、降级、熔断）
-- [ ] 关键业务指标监控已配置（不仅技术指标，也含业务指标）
-- [ ] 资损点已识别并有针对性保障措施
-
-### 增强检查项
-
-- [ ] **风险检测项已执行**：风险登记表中的检测计划已全部执行
-- [ ] **业务规则已验证**：critical级别业务规则已通过端到端验证
-- [ ] **灰度策略已确定**：灰度比例/时间窗口/观察指标已明确
-
-## 建议检查
-
-### 基础建议
-
-- [ ] 相关方已通知（产品、运营、客服等）
-- [ ] 监控告警已配置或确认
-- [ ] 灰度/分批发布策略已确定（如适用）
-- [ ] 遗留风险已记录并经人工确认可接受
-- [ ] 发布时间窗口合适（避开高峰期）
-- [ ] 容量评估已完成（压测数据支撑机器数量决策）
-- [ ] 变更回滚预案已演练验证
-- [ ] 数据变更（如有）已通知下游使用方
-- [ ] 发布遵循最小价值单元策略（先样板间再横向扩展）
-
-### 增强建议项
-
-- [ ] **监控告警已演练**：模拟故障场景验证告警触发
-- [ ] **回滚演练已完成**：回滚脚本在测试环境已执行验证
-- [ ] **关键业务流程已验证**：业务流程图中标记的关键路径已通过
-- [ ] **术语已统一**：发布文档中的术语与 glossary.md 一致
-- [ ] **文档版本已更新**：涉及文档已更新版本号和更新说明
-
-## 发布后验证清单
-
-- [ ] 冒烟测试：核心功能是否正常
-- [ ] 监控指标：是否有异常波动（与基线对比）
-- [ ] 业务指标：关键业务指标是否正常
-- [ ] 告警检查：是否有新触发告警
-- [ ] 回滚验证：确认回滚路径畅通
-
-## 发布检查承诺书
-
-```markdown
-## 发布承诺
-
-| 检查项 | 状态 | 确认人 | 确认时间 |
-|--------|------|--------|---------|
-| 测试报告已通过 | ✅/❌ | | |
-| 风险检测已完成 | ✅/❌ | | |
-| 回滚方案已验证 | ✅/❌ | | |
-| 监控告警已配置 | ✅/❌ | | |
-| 变更记录已完备 | ✅/❌ | | |
-
-发布负责人签名：__________
-日期：__________
-```