@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/process/README.en.md

@@ -1,38 +0,0 @@
-# Development Pipeline
-
-This directory contains AutoSpec's development pipeline definitions, including 6 stages and 4 iteration modes.
-
-## Directory Structure
-
-```
-pipeline/
-├── overview.md         # Pipeline overview (startup gate + execution modes + full flow)
-├── 01-requirement.md   # Stage 1: Requirement Analysis
-├── 02-design.md        # Stage 2: Design Planning
-├── 03-implementation.md # Stage 3: Code Implementation
-├── 04-review.md        # Stage 4: Code Review
-├── 05-testing.md       # Stage 5: QA Testing
-└── 06-delivery.md      # Stage 6: Delivery
-```
-
-## Pipeline Overview
-
-```
-[Stage 0] → Requirement → Design → Implementation → Review → Testing → Delivery
-  Env Check      │            │           │            │         │          │
-                 ↓            ↓           ↓            ↓         ↓          ↓
-             [Layer 1+2]  [Layer 1+2] [Layer 1+2] [Layer 1+2] [Layer 1+2] [Layer 1+2]
-```
-
-## Iteration Modes
-
-| Mode | Stages | Description | Use Case |
-|------|--------|-------------|----------|
-| **Waterfall** | 01→02→03→04→05→06 | Full 6 stages | New features, major changes |
-| **Agile** | 01 + [02→03→04]×N + 05→06 | Story-driven cycles | Iterative development |
-| **Experiment** | 01→02→03 + Evaluation | Prototype + AI evaluation | Technical exploration |
-| **Hotfix** | 01→03→04→06 | Fast track | Emergency fixes |
-
-## Detailed Documentation
-
-For complete pipeline definitions, startup gate, and execution mode details, see [overview.md](overview.md).

package/knowledge/process/README.md

@@ -1,48 +0,0 @@
-# 研发流程
-
-本目录包含 AutoSpec 的研发流程定义，包括 6 个阶段和 4 种迭代模式。
-
-## 目录结构
-
-```
-process/
-├── overview.md         # 流程概览（启动门禁 + 执行模式 + 全流程）
-├── ai-sdlc.md        # AI-Enhanced SDLC 规范
-├── 01-requirement.md   # 阶段1：需求分析
-├── 02-design.md        # 阶段2：方案设计
-├── 03-implementation.md # 阶段3：编码实现
-├── 04-review.md        # 阶段4：代码审查
-├── 05-testing.md       # 阶段5：QA测试
-└── 06-delivery.md      # 阶段6：交付部署
-```
-
-## 流程概览
-
-```
-[Stage 0] → 需求分析 → 方案设计 → 编码实现 → 代码审查 → QA测试 → 交付部署
-  环境就绪      │           │           │           │          │          │
-               ↓           ↓           ↓           ↓          ↓          ↓
-           [双层验证]  [双层验证]  [双层验证]  [双层验证] [双层验证] [双层验证]
-```
-
-## 迭代模式
-
-| 模式 | 阶段 | 说明 | 场景 |
-|------|------|------|------|
-| **Waterfall** | 01→02→03→04→05→06 | 完整6阶段 | 新功能、重大变更 |
-| **Agile** | 01 + [02→03→04]×N + 05→06 | 故事驱动循环 | 迭代开发 |
-| **Experiment** | 01→02→03 + 效果评测 | 原型+AI评估 | 技术探索 |
-| **Hotfix** | 01→03→04→06 | 快速通道 | 紧急修复 |
-
-## 详细文档
-
-| 文件 | 说明 |
-|------|------|
-| [overview.md](overview.md) | 流程概览、启动门禁、执行模式、双层验证 |
-| [ai-sdlc.md](ai-sdlc.md) | AI-Enhanced SDLC 规范（AI 辅助各阶段的最佳实践） |
-| [01-requirement.md](01-requirement.md) | 需求分析阶段详细定义 |
-| [02-design.md](02-design.md) | 方案设计阶段详细定义 |
-| [03-implementation.md](03-implementation.md) | 编码实施阶段详细定义 |
-| [04-review.md](04-review.md) | 代码审查阶段详细定义 |
-| [05-testing.md](05-testing.md) | QA测试阶段详细定义 |
-| [06-delivery.md](06-delivery.md) | 交付部署阶段详细定义 |

package/knowledge/templates/ai-evaluation.md

@@ -1,150 +0,0 @@
-# AI 评测设计模板
-
-> 规范化 AI/模型功能评测文档，确保效果可量化、可追溯。
-
-## 使用说明
-
-1. 每个 AI 功能或模型使用独立的 .md 文件
-2. 文件命名：`{功能名}-evaluation.md`，如 `chat-bot-evaluation.md`
-3. 评测结果需记录到版本历史
-
-## 评测概述
-
-| 字段 | 值 |
-|------|-----|
-| 功能名称 | {功能名} |
-| 模型版本 | {version} |
-| 评测日期 | YYYY-MM-DD |
-| 评测人 | {name} |
-
-## 评测目标
-
-| 目标 | 描述 | 目标值 |
-|------|------|-------|
-| {目标1} | {描述} | {目标值} |
-| {目标2} | {描述} | {目标值} |
-
-## 评测指标
-
-| 指标名称 | 计算方式 | 权重 | 说明 |
-|---------|---------|------|------|
-| 准确率 Accuracy | 正确数/总数 | 30% | 分类正确率 |
-| 召回率 Recall | TP/(TP+FN) | 20% | 正例召回率 |
-| 精确率 Precision | TP/(TP+FP) | 20% | 预测正确率 |
-| F1 Score | 2*P*R/(P+R) | 20% | 综合指标 |
-| 响应时间 | 平均延迟 | 10% | 性能指标 |
-
-## 评测数据集
-
-### 数据集概述
-
-| 字段 | 值 |
-|------|-----|
-| 数据集名称 | {dataset_name} |
-| 数据量 | {count} |
-| 数据来源 | {source} |
-| 标注方式 | 人工标注/自动标注 |
-| 更新日期 | YYYY-MM-DD |
-
-### 数据分布
-
-| 类别 | 数量 | 占比 |
-|------|------|------|
-| {类别1} | {count} | {percent}% |
-| {类别2} | {count} | {percent}% |
-
-### 数据样例
-
-```json
-{
-  "id": "sample_001",
-  "input": "用户输入内容",
-  "expected_output": "期望输出",
-  "category": "类别",
-  "difficulty": "easy/medium/hard"
-}
-```
-
-## 评测方法
-
-### 评测流程
-
-```mermaid
-flowchart TD
-    A[加载数据集] --> B[模型推理]
-    B --> C[结果收集]
-    C --> D[指标计算]
-    D --> E[Badcase 分析]
-    E --> F[生成报告]
-```
-
-### 评测脚本
-
-```python
-# 评测脚本示例
-def evaluate(model, dataset):
-    results = []
-    for sample in dataset:
-        prediction = model.predict(sample['input'])
-        results.append({
-            'id': sample['id'],
-            'expected': sample['expected_output'],
-            'actual': prediction,
-            'correct': prediction == sample['expected_output']
-        })
-    return calculate_metrics(results)
-```
-
-## 评测结果
-
-### 整体指标
-
-| 指标 | 目标值 | 实际值 | 是否达标 |
-|------|-------|-------|---------|
-| Accuracy | {target} | {actual} | ✅/❌ |
-| Recall | {target} | {actual} | ✅/❌ |
-| Precision | {target} | {actual} | ✅/❌ |
-| F1 Score | {target} | {actual} | ✅/❌ |
-| 响应时间 | {target}ms | {actual}ms | ✅/❌ |
-
-### 分类指标
-
-| 类别 | 样本数 | 准确率 | 召回率 | F1 |
-|------|-------|-------|-------|-----|
-| {类别1} | {count} | {acc} | {recall} | {f1} |
-| {类别2} | {count} | {acc} | {recall} | {f1} |
-
-## Badcase 分析
-
-### Badcase 列表
-
-| ID | 输入 | 期望 | 实际 | 原因分析 | 改进建议 |
-|-----|------|------|------|---------|---------|
-| 001 | {input} | {expected} | {actual} | {reason} | {suggestion} |
-
-### 错误类型分布
-
-| 错误类型 | 数量 | 占比 | 典型案例 |
-|---------|------|------|---------|
-| 理解错误 | {count} | {percent}% | {example} |
-| 知识缺失 | {count} | {percent}% | {example} |
-| 推理错误 | {count} | {percent}% | {example} |
-
-## 改进计划
-
-| 优先级 | 改进项 | 预期效果 | 负责人 | 截止日期 |
-|-------|-------|---------|-------|---------|
-| P0 | {改进项} | {效果} | {name} | {date} |
-| P1 | {改进项} | {效果} | {name} | {date} |
-
-## 版本历史
-
-| 版本 | 日期 | 修改人 | 修改说明 |
-|-----|------|--------|---------|
-| v1.0 | YYYY-MM-DD | | 初始版本 |
-
----
-
-**维护者**: AI 团队
-**进化分区**: 自由区
-**关联文档**: `test-knowledge/test-designs/{name}.md`

package/knowledge/templates/api-design.md

@@ -1,117 +0,0 @@
-# API 设计模板
-
-> 规范化接口设计文档，确保接口契约清晰、一致。
-
-## 使用说明
-
-1. 每个接口或接口组使用独立的 .md 文件
-2. 文件命名：`{服务名}-{模块名}.md`，如 `order-service.md`
-3. 接口变更需更新版本历史
-
-## 接口概述
-
-| 字段 | 值 |
-|------|-----|
-| 服务名称 | {服务名} |
-| 基础路径 | `/api/v1/{module}` |
-| 认证方式 | Bearer Token / API Key / OAuth 2.0 |
-| 版本 | v1.0 |
-
-## 接口列表
-
-| 接口名称 | HTTP方法 | 路径 | 描述 |
-|---------|---------|------|------|
-| {接口1} | GET/POST/PUT/DELETE | `/{resource}` | {描述} |
-| {接口2} | GET/POST/PUT/DELETE | `/{resource}/{id}` | {描述} |
-
-## 接口详情
-
-### {接口名称}
-
-**请求**
-
-```http
-{METHOD} /api/v1/{path} HTTP/1.1
-Content-Type: application/json
-Authorization: Bearer {token}
-```
-
-**请求参数**
-
-| 参数名 | 类型 | 必填 | 位置 | 描述 | 示例 |
-|-------|------|------|------|------|------|
-| {param} | string/number/boolean | 是/否 | path/query/body | {描述} | {示例} |
-
-**请求体**
-
-```json
-{
-  "field1": "value1",
-  "field2": 123
-}
-```
-
-**响应体**
-
-```json
-{
-  "code": 0,
-  "message": "success",
-  "data": {
-    "id": "xxx",
-    "name": "xxx"
-  }
-}
-```
-
-## 错误码定义
-
-| 错误码 | HTTP状态码 | 描述 | 处理建议 |
-|-------|-----------|------|---------|
-| 0 | 200 | 成功 | - |
-| 1001 | 400 | 参数错误 | 检查请求参数 |
-| 1002 | 401 | 未授权 | 检查认证信息 |
-| 1003 | 403 | 禁止访问 | 检查权限 |
-| 1004 | 404 | 资源不存在 | 检查资源ID |
-| 1005 | 500 | 服务器错误 | 联系管理员 |
-
-## 通用规范
-
-### 请求头
-
-| 头字段 | 必填 | 描述 |
-|-------|------|------|
-| Content-Type | 是 | application/json |
-| Authorization | 是 | Bearer {token} |
-| X-Request-ID | 否 | 请求追踪ID |
-
-### 响应格式
-
-```json
-{
-  "code": 0,
-  "message": "success",
-  "data": {},
-  "traceId": "xxx"
-}
-```
-
-### 分页参数
-
-| 参数名 | 类型 | 默认值 | 描述 |
-|-------|------|-------|------|
-| page | number | 1 | 页码 |
-| pageSize | number | 20 | 每页数量 |
-| total | number | - | 总数量（响应中返回） |
-
-## 版本历史
-
-| 版本 | 日期 | 修改人 | 修改说明 |
-|-----|------|--------|---------|
-| v1.0 | YYYY-MM-DD | | 初始版本 |
-
----
-
-**维护者**: 后端团队
-**进化分区**: 受控区
-**关联文档**: `design-knowledge/architecture/{name}.md`

package/knowledge/templates/database-design.md

@@ -1,132 +0,0 @@
-# 数据库设计模板
-
-> 规范化数据库设计文档，确保数据模型清晰、一致。
-
-## 使用说明
-
-1. 每个数据库或模块使用独立的 .md 文件
-2. 文件命名：`{数据库名}-{模块名}.md`，如 `order-db.md`
-3. 表结构变更需更新版本历史
-
-## 数据库概述
-
-| 字段 | 值 |
-|------|-----|
-| 数据库名 | {database_name} |
-| 数据库类型 | MySQL / PostgreSQL / MongoDB |
-| 字符集 | utf8mb4 |
-| 排序规则 | utf8mb4_unicode_ci |
-
-## ER 图
-
-```mermaid
-erDiagram
-    USER ||--o{ ORDER : places
-    USER {
-        bigint id PK
-        varchar username
-        varchar email
-        datetime created_at
-    }
-    ORDER ||--|{ ORDER_ITEM : contains
-    ORDER {
-        bigint id PK
-        bigint user_id FK
-        decimal total_amount
-        varchar status
-        datetime created_at
-    }
-    ORDER_ITEM {
-        bigint id PK
-        bigint order_id FK
-        bigint product_id FK
-        int quantity
-        decimal price
-    }
-```
-
-## 表结构
-
-### {表名}
-
-**表说明**：{表的业务含义}
-
-| 字段名 | 类型 | 可空 | 默认值 | 说明 |
-|-------|------|------|-------|------|
-| id | BIGINT | 否 | AUTO_INCREMENT | 主键 |
-| {field} | VARCHAR(255) | 否 | - | {说明} |
-| created_at | DATETIME | 否 | CURRENT_TIMESTAMP | 创建时间 |
-| updated_at | DATETIME | 否 | CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
-
-**索引设计**
-
-| 索引名 | 类型 | 字段 | 说明 |
-|-------|------|------|------|
-| PRIMARY | 主键 | id | 聚簇索引 |
-| idx_{field} | 普通 | {field} | 查询优化 |
-| uk_{field} | 唯一 | {field} | 唯一约束 |
-
-**DDL 语句**
-
-```sql
-CREATE TABLE `{table_name}` (
-  `id` BIGINT NOT NULL AUTO_INCREMENT,
-  `{field}` VARCHAR(255) NOT NULL COMMENT '{说明}',
-  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  INDEX `idx_{field}` (`{field}`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='{表说明}';
-```
-
-## 字段命名规范
-
-| 规则 | 示例 |
-|------|------|
-| 主键 | `id` |
-| 外键 | `{referenced_table}_id` |
-| 布尔值 | `is_{action}` / `has_{feature}` |
-| 时间 | `{action}_at` / `{action}_time` |
-| 数量 | `{entity}_count` / `{entity}_num` |
-| 金额 | `{entity}_amount` / `{entity}_fee` |
-
-## 状态枚举
-
-### {状态类型}
-
-| 值 | 名称 | 说明 |
-|-----|------|------|
-| 0 | INIT | 初始状态 |
-| 1 | PROCESSING | 处理中 |
-| 2 | SUCCESS | 成功 |
-| 3 | FAILED | 失败 |
-| -1 | CANCELLED | 已取消 |
-
-## 数据一致性保障
-
-### 事务边界
-
-| 场景 | 事务范围 | 隔离级别 |
-|------|---------|---------|
-| {场景1} | {表列表} | READ COMMITTED |
-| {场景2} | {表列表} | READ COMMITTED |
-
-### 并发控制
-
-| 场景 | 控制方式 | 说明 |
-|------|---------|------|
-| 库存扣减 | 乐观锁 | version 字段 |
-| 余额变更 | 悲观锁 | SELECT FOR UPDATE |
-| 订单创建 | 分布式锁 | Redis Lock |
-
-## 版本历史
-
-| 版本 | 日期 | 修改人 | 修改说明 |
-|-----|------|--------|---------|
-| v1.0 | YYYY-MM-DD | | 初始版本 |
-
----
-
-**维护者**: 后端团队
-**进化分区**: 受控区
-**关联文档**: `design-knowledge/architecture/{name}.md`