@chongyan/autospec 1.0.1 → 1.0.3

package/knowledge/checklists/requirement.md

@@ -1,169 +0,0 @@
-# 需求分析检查清单
-
-> **版本**: v2.0
-> **最后更新**: 2026-03-26
-> **基于**: 业界需求工程 检查清单
-> **适用范围**: 所有需求分析场景
-
----
-
-## 必填章节检查
-
-以下章节为必填，缺少则需求文档不完整：
-
-- [ ] 1.1 业务背景
-- [ ] 1.2 业务价值
-- [ ] 2.1 目标 (Success Criteria)
-- [ ] 2.2 范围 (包含/不包含)
-- [ ] 3.2 需求用例图
-- [ ] 3.5 用例业务流程
-
----
-
-## 业务完整性检查
-
-### 背景与价值
-
-- [ ] 业务背景描述了当前面临的问题或机会
-- [ ] 业务价值说明了为什么要做这个需求
-- [ ] 有数据支撑（当前指标、目标指标）
-- [ ] 与团队/公司目标的对齐关系明确
-
-### 目标与范围
-
-- [ ] 目标符合 SMART 原则（具体、可衡量、可实现、相关、有时限）
-- [ ] 范围清晰定义了包含的功能
-- [ ] 范围清晰定义了不包含的功能（排除项）
-- [ ] 无范围蔓延风险
-
-### 业务架构
-
-- [ ] 总体架构图清晰展示系统边界
-- [ ] 需求用例图按角色分组
-- [ ] 用例为原子粒度（不可再拆分）
-- [ ] 业务域拆解完整（8 类场景检查）
-- [ ] 涉及资金链路的有资金流方案
-- [ ] 跨域接口定义清晰
-
----
-
-## 技术可行性检查
-
-- [ ] 技术可行性已初步评估
-- [ ] 依赖和约束已识别
-- [ ] 与现有系统的兼容性已评估
-- [ ] 数据一致性方案明确
-- [ ] 涉及共享组件/依赖库变更的已说明升级方案
-
----
-
-## 非功能需求检查
-
-- [ ] 性能需求已定义（响应时间、吞吐量）
-- [ ] 安全需求已定义（认证、授权、数据保护）
-- [ ] 兼容性需求已定义（向后兼容、数据迁移）
-- [ ] 可用性需求已定义（SLA、降级策略）
-
----
-
-## 三板斧检查
-
-### 灰度策略
-
-- [ ] 灰度维度已定义（用户/流量/功能/数据）
-- [ ] 灰度比例已明确
-- [ ] 灰度回滚方案已定义
-
-### 监控指标
-
-- [ ] 业务指标已定义（下单成功率等）
-- [ ] 性能指标已定义（响应时间等）
-- [ ] 错误指标已定义（错误日志数量等）
-- [ ] 告警阈值已明确
-
-### 应急预案
-
-- [ ] 风险项已识别
-- [ ] 应急操作已定义
-- [ ] 操作步骤清晰
-- [ ] 负责人已明确
-
----
-
-## 需求质量检查
-
-### 无歧义检查
-
-- [ ] 需求描述符合 5W 标准（Who/Where+When/What/Why）
-- [ ] 不同人读到的理解一致
-- [ ] 关键术语有明确定义
-- [ ] 使用 WHEN-THEN 格式描述场景
-
-### 可实现检查
-
-- [ ] 技术上可行
-- [ ] 资源上可承受
-- [ ] 时间上可接受
-
-### 可验收检查
-
-- [ ] 每条功能需求有对应的验收标准
-- [ ] 验收标准可测量
-- [ ] 有明确的完成定义（DoD）
-
----
-
-## 关键假设检查
-
-- [ ] 关键假设清单已填写
-- [ ] 假设分为"已确认"和"待确认"
-- [ ] 待确认假设不超过 3 个（超过需升级人工）
-- [ ] 假设变更有记录
-
----
-
-## 风险检查
-
-- [ ] 风险项已识别
-- [ ] 风险影响评估（高/中/低）
-- [ ] 风险概率评估（高/中/低）
-- [ ] 缓解措施已定义
-
----
-
-## 文档质量检查
-
-- [ ] 文档结构符合模板
-- [ ] 流程图可正常渲染
-- [ ] 链接全部有效
-- [ ] 无拼写错误和语法错误
-- [ ] 格式统一（标题、列表、表格）
-
----
-
-## 检查记录
-
-| 检查项 | 检查结果 | 检查人 | 检查日期 |
-|-------|---------|--------|---------|
-| 必填章节 | 通过/不通过 | | |
-| 业务完整性 | 通过/不通过 | | |
-| 技术可行性 | 通过/不通过 | | |
-| 非功能需求 | 通过/不通过 | | |
-| 三板斧 | 通过/不通过 | | |
-| 需求质量 | 通过/不通过 | | |
-| 关键假设 | 通过/不通过 | | |
-| 风险 | 通过/不通过 | | |
-| 文档质量 | 通过/不通过 | | |
-
-**总体结论**: 通过 / 不通过
-
-**备注**:
-{记录需要关注的问题}
-
----
-
-## 参考资料
-
-- [需求工程指南](../guides/requirement-engineering.md)
-- [proposal 模板](../templates/proposal.md)
-- [设计哲学 - 结构化澄清协议](../principles/design-philosophy.md#dp19-结构化澄清协议)

package/knowledge/checklists/test.md

@@ -1,46 +0,0 @@
-# 测试设计检查清单
-
-> 供 test-generator skill 和 test-reviewer skill 引用，确保测试覆盖完整。
-
-## 边界条件测试（必须覆盖）
-
-- [ ] 空值测试：null、undefined、空字符串、空数组
-- [ ] 边界值测试：0、-1、最大值、最小值、临界值
-- [ ] 特殊字符测试：`< > & " ' / \`、emoji、多字节字符
-- [ ] 超长输入测试：超过最大长度限制的输入
-- [ ] 类型错误测试：传入错误类型参数
-
-## 异常路径测试（必须覆盖）
-
-- [ ] 网络异常：超时、连接失败、DNS解析失败
-- [ ] 资源异常：磁盘满、内存不足、文件不存在
-- [ ] 并发测试：多线程/多进程同时操作同一资源
-- [ ] 状态异常：未初始化、已关闭、事务冲突
-
-## 功能覆盖测试
-
-- [ ] 正向流程：正常输入，正常输出
-- [ ] 分支覆盖：每个if/else分支都有测试
-- [ ] 边界值覆盖：临界值前后都有测试
-- [ ] 前后置条件：依赖服务不可用时的行为
-
-## 安全测试（必须覆盖）
-
-- [ ] SQL注入：包含 `' -- ;` 等SQL关键字的输入
-- [ ] XSS攻击：包含 `<script>alert(1)</script>` 等HTML/JS的输入
-- [ ] 命令注入：包含 `; rm -rf` 等系统命令的输入
-- [ ] 越权访问：尝试访问未授权资源
-
-## 性能测试（建议覆盖）
-
-- [ ] 响应时间：核心接口响应时间在要求范围内
-- [ ] 并发能力：高并发下系统是否稳定
-- [ ] 资源占用：内存、CPU、磁盘IO是否可控
-
-## 测试质量标准
-
-- [ ] 测试可重复执行（无随机因素）
-- [ ] 测试之间无依赖（可并行执行）
-- [ ] 断言明确（失败信息清晰指出问题）
-- [ ] 测试数据可准备（不依赖外部不稳定状态）
-- [ ] 覆盖率达标：核心逻辑 > 70%，安全相关 > 90%

package/knowledge/config/README.en.md

@@ -1,44 +0,0 @@
-# Config Directory
-
-This directory contains AutoSpec's configuration files, defining validation patterns and team triggers.
-
-## Directory Structure
-
-```
-config/
-├── validation-patterns.yaml  # Validation pattern configuration
-└── team-triggers.yaml        # Team trigger configuration
-```
-
-## Configuration Files
-
-### validation-patterns.yaml
-
-Defines validation patterns for each stage:
-
-```yaml
-# Validation pattern example
-patterns:
-  - name: "build-check"
-    stage: "implementation"
-    commands:
-      - "npm run build"
-    required: true
-```
-
-### team-triggers.yaml
-
-Defines team collaboration triggers:
-
-```yaml
-# Team trigger example
-triggers:
-  - name: "code-review-request"
-    condition: "pull_request.opened"
-    actions:
-      - "notify: @team-lead"
-```
-
-## Usage
-
-Configuration files are copied to `.autospec/knowledge/config/` during `autospec init` and can be customized per project needs.

package/knowledge/config/README.md

@@ -1,44 +0,0 @@
-# 配置目录
-
-本目录包含 AutoSpec 的配置文件，定义验证模式和团队触发器。
-
-## 目录结构
-
-```
-config/
-├── validation-patterns.yaml  # 验证模式配置
-└── team-triggers.yaml        # 团队触发器配置
-```
-
-## 配置文件说明
-
-### validation-patterns.yaml
-
-定义各阶段的验证模式：
-
-```yaml
-# 验证模式示例
-patterns:
-  - name: "build-check"
-    stage: "implementation"
-    commands:
-      - "npm run build"
-    required: true
-```
-
-### team-triggers.yaml
-
-定义团队协作触发器：
-
-```yaml
-# 团队触发器示例
-triggers:
-  - name: "code-review-request"
-    condition: "pull_request.opened"
-    actions:
-      - "notify: @team-lead"
-```
-
-## 使用方式
-
-配置文件在 `autospec init` 时复制到 `.autospec/knowledge/config/`，可根据项目需求定制。

package/knowledge/config/role-composition.yaml

@@ -1,98 +0,0 @@
-# 角色组合配置（AI Native文化融入）
-# 定义不同阶段、不同复杂度的角色组合规则
-
-compositions:
-  # 需求阶段角色组合
-  requirement:
-    simple:
-      roles: [ceo, product-owner]
-      focus: [商业价值, 用户价值, MVP范围]
-      aiNative: "评估AI能力边界，识别AI增强机会"
-    medium:
-      roles: [ceo, product-owner, tech-lead, ai-engineer]
-      focus: [商业价值, 用户价值, 技术可行性, AI方案可行性]
-      aiNative: "AI工程师参与评估AI方案可行性"
-    complex:
-      roles: [ceo, product-owner, tech-lead, ai-engineer, backend-engineer, frontend-engineer]
-      focus: [商业价值, 用户价值, 技术可行性, AI方案, 实现复杂度]
-      aiNative: "全面评估AI集成方案，制定效果评测计划"
-
-  # 设计阶段角色组合
-  design:
-    simple:
-      roles: [tech-lead]
-      focus: [架构设计, 技术选型]
-      aiNative: "评估AI技术选型，设计AI集成架构"
-    medium:
-      roles: [tech-lead, ai-engineer, backend-engineer, frontend-engineer]
-      focus: [架构设计, 技术选型, AI方案设计, 接口设计]
-      aiNative: "AI工程师参与核心方案设计"
-    complex:
-      roles: [tech-lead, ai-engineer, data-engineer, backend-engineer, frontend-engineer, quality-engineer]
-      focus: [架构设计, 技术选型, AI方案设计, 数据架构, 接口设计, 测试策略]
-      aiNative: "设计AI效果评测方案，规划数据流"
-
-  # 编码阶段角色组合
-  implementation:
-    simple:
-      roles: [backend-engineer]
-      focus: [代码实现, 单元测试]
-      aiNative: "实现AI接口调用，处理AI响应异常"
-    medium:
-      roles: [backend-engineer, frontend-engineer, ai-engineer]
-      focus: [代码实现, 接口对接, AI集成, 单元测试]
-      aiNative: "AI工程师负责AI模块实现"
-    complex:
-      roles: [backend-engineer, frontend-engineer, ai-engineer, data-engineer, quality-engineer]
-      focus: [代码实现, 接口对接, AI实现, 数据管道, 测试覆盖]
-      aiNative: "AI效果评测实现，数据驱动验证"
-
-  # 测试阶段角色组合
-  testing:
-    simple:
-      roles: [quality-engineer]
-      focus: [测试执行, 缺陷报告]
-      aiNative: "AI功能测试，效果验证"
-    medium:
-      roles: [quality-engineer, backend-engineer, ai-engineer]
-      focus: [测试执行, 接口测试, AI效果评测]
-      aiNative: "AI效果评测，Badcase分析"
-    complex:
-      roles: [quality-engineer, ai-engineer, data-engineer, backend-engineer, frontend-engineer]
-      focus: [测试执行, AI效果评测, 数据验证, 集成测试]
-      aiNative: "全面AI效果评测，数据驱动验证"
-
-  # 交付阶段角色组合
-  delivery:
-    simple:
-      roles: [tech-lead, quality-engineer]
-      focus: [发布检查, 部署验证]
-      aiNative: "AI服务部署检查"
-    medium:
-      roles: [tech-lead, quality-engineer, devops-engineer, ai-engineer]
-      focus: [发布检查, 部署配置, AI服务部署]
-      aiNative: "AI模型部署，服务监控配置"
-    complex:
-      roles: [tech-lead, quality-engineer, devops-engineer, ai-engineer, data-engineer, security-engineer]
-      focus: [发布检查, 部署配置, AI服务部署, 数据管道, 安全检查]
-      aiNative: "AI服务全面部署，安全合规检查"
-
-# 角色协作模式
-collaborationModes:
-  # 并行审查模式
-  parallel-review:
-    description: "多个角色并行审查，信息隔离"
-    execution: "parallel"
-    isolation: true
-
-  # 串行确认模式
-  sequential-confirm:
-    description: "按顺序确认，下一角色基于上一角色结果"
-    execution: "sequential"
-    isolation: false
-
-  # 协作讨论模式
-  collaborative-discussion:
-    description: "多角色共同讨论，达成共识"
-    execution: "collaborative"
-    isolation: false

package/knowledge/config/role-extensions.yaml

@@ -1,140 +0,0 @@
-# 角色扩展配置
-# 定义角色的继承和扩展规则
-
-# 角色扩展定义
-extensions:
-  # 后端工程师扩展为全栈工程师
-  fullstack-engineer:
-    extends: backend-engineer
-    description: "全栈工程师，具备前后端开发能力"
-    additions:
-      tools: []
-      focus:
-        - 前端组件开发
-        - 前后端联调
-        - 全栈架构设计
-      checks:
-        - 前端性能优化
-        - 响应式设计
-        - API契约一致性
-    aiNative: "全栈AI集成，前后端AI交互优化"
-
-  # 技术负责人扩展为架构师
-  architect:
-    extends: tech-lead
-    description: "系统架构师，负责整体架构演进"
-    additions:
-      tools: []
-      focus:
-        - 系统架构演进
-        - 技术债务管理
-        - 技术规范制定
-        - 架构评审
-      checks:
-        - 架构一致性
-        - 技术选型合理性
-        - 系统可扩展性
-    aiNative: "AI架构设计，AI系统演进规划"
-
-  # AI工程师扩展为AI架构师
-  ai-architect:
-    extends: ai-engineer
-    description: "AI架构师，负责AI系统整体设计"
-    additions:
-      tools: []
-      focus:
-        - AI系统架构设计
-        - 模型选型与评估
-        - AI平台规划
-        - AI团队能力建设
-      checks:
-        - AI系统可扩展性
-        - 模型效果保障
-        - AI成本优化
-    aiNative: "AI系统架构核心设计"
-
-  # 数据工程师扩展为数据架构师
-  data-architect:
-    extends: data-engineer
-    description: "数据架构师，负责数据平台设计"
-    additions:
-      tools: []
-      focus:
-        - 数据平台架构
-        - 数据治理
-        - 数据资产建设
-      checks:
-        - 数据质量保障
-        - 数据安全合规
-        - 数据价值挖掘
-    aiNative: "AI数据架构设计，特征平台建设"
-
-  # 质量工程师扩展为测试架构师
-  test-architect:
-    extends: quality-engineer
-    description: "测试架构师，负责测试体系设计"
-    additions:
-      tools: []
-      focus:
-        - 测试体系设计
-        - 测试工具建设
-        - 质量度量体系
-      checks:
-        - 测试覆盖率
-        - 自动化测试效果
-        - 质量指标达成
-    aiNative: "AI测试架构设计，AI效果评测体系"
-
-# 角色能力提供
-provides:
-  backend-engineer:
-    - backend-api-design
-    - database-design
-    - service-implementation
-
-  frontend-engineer:
-    - ui-implementation
-    - user-interaction
-    - frontend-performance
-
-  ai-engineer:
-    - model-selection
-    - prompt-engineering
-    - ai-integration
-    - ai-evaluation
-
-  data-engineer:
-    - data-pipeline
-    - data-quality
-    - feature-engineering
-
-  quality-engineer:
-    - test-design
-    - test-automation
-    - quality-metrics
-
-  security-engineer:
-    - security-audit
-    - compliance-check
-    - vulnerability-scan
-
-# 角色组合约束
-constraints:
-  # 互斥角色（不能同时担任）
-  conflicts:
-    - [independent-reviewer, backend-engineer]
-    - [independent-reviewer, frontend-engineer]
-    - [stage-gate-evaluator, tech-lead]
-
-  # 依赖角色（需要先有）
-  requires:
-    ai-engineer: [tech-lead]
-    security-engineer: [tech-lead]
-    devops-engineer: [tech-lead]
-
-# 角色扩展规则
-rules:
-  - "扩展角色继承基础角色的所有能力"
-  - "扩展角色可以覆盖基础角色的部分定义"
-  - "扩展角色不能与基础角色冲突"
-  - "一个角色只能继承一个基础角色"

package/knowledge/config/skill-compositions.yaml

@@ -1,142 +0,0 @@
-# Skills 组合复用配置
-# 定义 Skills 的组合规则和复用方式
-
-# 基础 Skills（可独立使用）
-base:
-  - name: requirement-analyzer
-    type: do
-    description: "需求分析执行"
-    path: "knowledge/guides/stages/requirement-analyzer.md"
-
-  - name: design-planner
-    type: do
-    description: "方案设计规划"
-    path: "knowledge/guides/stages/design-planner.md"
-
-  - name: code-implementer
-    type: do
-    description: "代码实现"
-    path: "knowledge/guides/stages/code-implementer.md"
-
-  - name: test-generator
-    type: do
-    description: "测试生成"
-    path: "knowledge/guides/stages/test-generator.md"
-
-# 审查类 Skills（可独立使用）
-review:
-  - name: requirement-reviewer
-    type: review
-    description: "需求审查"
-    path: "knowledge/guides/stages/requirement-reviewer.md"
-
-  - name: design-reviewer
-    type: review
-    description: "设计审查"
-    path: "knowledge/guides/stages/design-reviewer.md"
-
-  - name: code-reviewer
-    type: review
-    description: "代码审查"
-    path: "knowledge/guides/stages/code-reviewer.md"
-
-  - name: security-reviewer
-    type: review
-    description: "安全审查"
-    path: "knowledge/guides/stages/security-reviewer.md"
-
-# 分析类 Skills 组合
-analysis:
-  skills:
-    - tech-stack-analyzer
-    - component-discovery
-    - environment-scanner
-  output: "综合分析报告"
-  reuse:
-    - name: tech-stack-analyzer
-      description: "技术栈分析，可单独复用"
-      path: "knowledge/guides/support/tech-stack-analyzer.md"
-    - name: component-discovery
-      description: "组件发现，可单独复用"
-      path: "knowledge/guides/support/component-discovery.md"
-    - name: environment-scanner
-      description: "环境扫描，可单独复用"
-      path: "knowledge/guides/support/environment-scanner.md"
-
-# 评测类 Skills 组合
-evaluation:
-  skills:
-    - ai-effect-evaluator
-    - test-coverage-reviewer
-    - data-validator
-  output: "评测报告"
-  reuse:
-    - name: ai-effect-evaluator
-      description: "AI效果评测"
-      path: "knowledge/guides/stages/ai-effect-evaluator.md"
-    - name: test-coverage-reviewer
-      description: "测试覆盖率审查"
-      path: "knowledge/guides/support/test-coverage-reviewer.md"
-    - name: data-validator
-      description: "数据验证"
-      path: "knowledge/guides/support/ai-data-validator.md"
-
-# 支撑类 Skills（可被其他 Skills 引用）
-support:
-  - name: complexity-assessor
-    description: "复杂度评估"
-    path: "knowledge/guides/support/complexity-assessor.md"
-    reusable: true
-
-  - name: team-orchestrator
-    description: "团队协调器"
-    path: "knowledge/guides/support/team-orchestrator.md"
-    reusable: true
-
-  - name: scope-inference
-    description: "范围推断"
-    path: "knowledge/guides/support/scope-inference.md"
-    reusable: true
-
-  - name: practice-logger
-    description: "实践记录"
-    path: "knowledge/guides/support/practice-logger.md"
-    reusable: true
-
-  - name: knowledge-generator
-    description: "知识生成"
-    path: "knowledge/guides/support/knowledge-generator.md"
-    reusable: true
-
-  - name: methodology-extractor
-    description: "方法论提取"
-    path: "knowledge/guides/support/methodology-extractor.md"
-    reusable: true
-
-# Skills 组合模板
-templates:
-  # 环境分析组合
-  environment-analysis:
-    description: "项目环境分析"
-    skills: [environment-scanner, tech-stack-analyzer, component-discovery]
-    output: ".autospec/runtime/environment-report.md"
-
-  # AI评测组合
-  ai-evaluation:
-    description: "AI功能效果评测"
-    skills: [ai-effect-evaluator, test-planner, data-validator]
-    output: ".autospec/specs/{feature}/evaluation-report.md"
-
-  # 安全审计组合
-  security-audit:
-    description: "安全审计"
-    skills: [security-reviewer, code-reviewer]
-    output: ".autospec/specs/{feature}/security-audit.md"
-
-# Skills 引用知识库
-knowledgeReferences:
-  principles: "knowledge/principles/"
-  process: "knowledge/process/"
-  guides: "knowledge/guides/"
-  checklists: "knowledge/checklists/"
-  scripts: "scripts/"