@chongyan/autospec 1.0.1 → 1.0.3

package/knowledge/guides/support/complexity-assessor.md

@@ -1,268 +0,0 @@
----
-name: complexity-assessor
-description: 当需要判断任务复杂度以决定是否引入完整团队审查时触发
-type: support
----
-
-## 定位
-任务复杂度评估专用技能，用于决定触发哪些角色参与审查，平衡效果与效率。
-
-**AI Native 理念**：评估时考虑AI相关复杂度，AI功能需要额外评估模型选型、效果验证等维度。
-
-## 配置文件依赖
-
-本评估器依赖以下配置文件：
-- `${KNOWLEDGE}/config/team-stage.yaml` - 团队阶段配置（获取角色触发规则）
-- `${KNOWLEDGE}/config/role-composition.yaml` - 角色组合规则
-
-## 输入
-- 任务描述
-- 项目上下文（技术栈、现有系统）
-- 需求文档（如有）
-- 团队阶段（seed/growth/mature，默认 growth）
-
-## 输出
-复杂度评估报告：
-```yaml
-score: 8                    # 总分（4-12分）
-level: medium               # 复杂度级别：simple/medium/complex
-teamStage: growth           # 团队阶段
-needsFullTeam: true         # 是否需要完整团队
-requiredRoles:              # 需要的角色列表（从配置读取）
-  - ceo
-  - product-owner
-  - tech-lead
-  - backend-engineer
-  - ai-engineer             # AI Native：中等复杂度也引入AI工程师
-triggeredRoles:             # 条件触发的角色
-  - security-engineer       # 触发原因：涉及用户数据
-dimensions:                 # 各维度评分
-  requirement: 2
-  technical: 2
-   2
-  business: 2
-aiNative:                   # AI Native 相关评估
-  involvesAI: true          # 是否涉及AI
-  aiComplexity: medium      # AI复杂度
-  needsAiEngineer: true     # 是否需要AI工程师
-```
-
-## 评估维度
-
-### 维度1：需求复杂度（1-3分）
-
-| 分数 | 描述 | 判断标准 |
-|------|------|----------|
-| 1 | 单一功能 | 只涉及一个独立功能点 |
-| 2 | 多功能关联 | 涉及多个相关功能，有依赖关系 |
-| 3 | 跨系统功能 | 涉及多个子系统，需要协调 |
-
-### 维度2：技术复杂度（1-3分）
-
-| 分数 | 描述 | 判断标准 |
-|------|------|----------|
-| 1 | 常规实现 | 使用现有技术栈，无新技术引入 |
-| 2 | 新技术/框架 | 引入新的技术或框架 |
-| 3 | 架构变更 | 涉及系统架构调整或重构 |
-
-### 维度3：数据敏感度（1-3分）
-
-| 分数 | 描述 | 判断标准 |
-|------|------|----------|
-| 1 | 非敏感数据 | 不涉及用户数据，仅内部配置/日志等 |
-| 2 | 内部数据 | 涉及内部业务数据 |
-| 3 | 用户隐私/资金 | 涉及用户隐私数据或资金相关 |
-
-### 维度4：业务复杂度（1-3分）
-
-| 分数 | 描述 | 判断标准 |
-|------|------|----------|
-| 1 | 简单流程 | 单一用户角色，线性流程 |
-| 2 | 多角色流程 | 涉及多个用户角色或分支流程 |
-| 3 | 复杂决策流程 | 涉及复杂的业务规则或决策逻辑 |
-
-### 维度5：AI复杂度（AI Native 新增）
-
-| 分数 | 描述 | 判断标准 |
-|------|------|----------|
-| 0 | 不涉及AI | 无AI相关功能 |
-| 1 | AI辅助功能 | AI作为辅助，不影响核心流程 |
-| 2 | AI核心功能 | AI是核心功能，需要效果验证 |
-| 3 | AI系统重构 | 涉及AI架构调整或模型更换 |
-
-## 执行步骤
-
-### Step 1: 读取配置文件
-
-**【强制】** 读取团队阶段配置：
-
-```
-1. 读取 ${KNOWLEDGE}/config/team-stage.yaml
-   - 获取当前团队阶段（seed/growth/mature）
-   - 默认使用 growth 阶段
-
-2. 读取 ${KNOWLEDGE}/config/role-composition.yaml
-   - 获取角色组合规则
-```
-
-### Step 2: 收集信息
-1. 读取任务描述和需求文档
-2. 读取项目配置（.autospec/runtime/config.json）
-3. 识别涉及的子系统
-4. 识别是否涉及AI功能
-
-### Step 3: 评估各维度
-逐个维度评估，记录判断依据：
-```
-需求复杂度：2分
-  - 理由：涉及用户管理+权限管理两个相关功能
-
-技术复杂度：1分
-  - 理由：使用现有技术栈，无新技术
-
-数据敏感度：3分
-  - 理由：涉及用户个人信息
-
-业务复杂度：2分
-  - 理由：涉及管理员和普通用户两个角色
-
-AI复杂度：2分
-  - 理由：AI推荐功能是核心功能，需要效果验证
-```
-
-### Step 4: 计算总分
-总分 = 各维度分数之和（4-12分，不含AI维度）
-
-AI维度单独评估，用于决定是否引入AI工程师。
-
-### Step 5: 确定角色列表（从配置读取）
-
-**【强制】** 从配置文件读取角色列表，不再硬编码：
-
-```
-角色确定流程：
-1. 从 team-stage.yaml 读取 {teamStage}.triggers.{level}
-2. 从 role-composition.yaml 读取 {stage}.{level}.roles
-3. 应用强制触发规则（mandatoryTriggers）
-4. 如果 AI复杂度 >= 1，确保 ai-engineer 在角色列表中
-```
-
-### Step 6: 输出报告
-生成结构化的复杂度评估报告
-
-## 复杂度级别判定
-
-| 总分 | 级别 | 说明 |
-|------|------|------|
-| 4-5 | simple | 简单任务，快速通道 |
-| 6-8 | medium | 中等任务，引入核心角色 |
-| 9-12 | complex | 复杂任务，引入完整团队 |
-
-## 强制触发规则（从配置读取）
-
-从 `team-stage.yaml` 的 `mandatoryTriggers` 读取：
-
-| 场景 | 强制引入角色 |
-|------|--------------|
-| 涉及用户数据 | security-engineer |
-| 涉及支付/资金交易 | security-engineer |
-| 涉及跨系统变更 | tech-lead, devops-engineer |
-| 涉及AI/模型 | ai-engineer |
-| 涉及数据分析/报表 | data-engineer |
-| 涉及AI效果评测 | ai-engineer, quality-engineer |
-
-## 示例
-
-### 示例1：简单任务
-
-**任务**：修改登录页面的提示文案
-
-**评估**：
-```yaml
-score: 4
-level: simple
-teamStage: growth
-needsFullTeam: false
-requiredRoles:
-  - ceo
-  - product-owner
-triggeredRoles: []
-dimensions:
-  requirement: 1  # 单一功能
-  technical: 1    # 常规实现
-  data: 1         # 非敏感数据
-  business: 1     # 简单流程
-aiNative:
-  involvesAI: false
-  aiComplexity: 0
-  needsAiEngineer: false
-```
-
-### 示例2：中等任务（含AI）
-
-**任务**：新增AI智能推荐功能
-
-**评估**：
-```yaml
-score: 7
-level: medium
-teamStage: growth
-needsFullTeam: false
-requiredRoles:
-  - ceo
-  - product-owner
-  - tech-lead
-  - backend-engineer
-  - ai-engineer           # AI Native：中等复杂度也引入AI工程师
-triggeredRoles:
-  - security-engineer     # 涉及用户数据
-dimensions:
-  requirement: 2  # 多功能关联
-  technical: 2    # 需要新增推荐模块
-   2         # 内部数据
-  business: 2     # 多场景触发
-aiNative:
-  involvesAI: true
-  aiComplexity: 2          # AI核心功能
-  needsAiEngineer: true
-```
-
-### 示例3：复杂任务
-
-**任务**：重构支付系统，支持多种支付方式
-
-**评估**：
-```yaml
-score: 11
-level: complex
-teamStage: growth
-needsFullTeam: true
-requiredRoles:
-  - product-owner
-  - tech-lead
-  - backend-engineer
-  - frontend-engineer
-  - ai-engineer            # AI Native：复杂任务引入AI工程师
-  - data-engineer
-  - quality-engineer
-triggeredRoles:
-  - security-engineer      # 涉及支付
-  - devops-engineer        # 涉及架构变更
-dimensions:
-  requirement: 3  # 跨系统功能
-  technical: 3    # 架构变更
-  data: 3         # 资金数据
-  business: 2     # 多支付渠道
-aiNative:
-  involvesAI: false
-  aiComplexity: 0
-  needsAiEngineer: false
-```
-
-## 反模式清单
-
-1. **过度评估**：简单任务评估为复杂任务。检测：检查每个维度的判断依据是否充分
-2. **忽略强制触发**：忘记检查强制触发规则。检测：强制触发检查必须在最后执行
-3. **维度理解偏差**：对维度定义理解不一致。检测：严格按判断标准评估
-4. **忽略AI维度**：AI时代项目普遍涉及AI，必须评估AI复杂度
-5. **硬编码角色列表**：必须从配置文件读取角色列表

package/knowledge/guides/support/component-discovery.md

@@ -1,183 +0,0 @@
----
-name: component-discovery
-description: 当需要发现项目中可复用的组件、工具、模块时触发。基于代码语义分析，识别与新需求相关的已有代码。
-type: meta
----
-
-## 定位
-
-元技能。分析项目已有代码，发现与新需求相关的可复用组件。
-
-## 输入
-
-- 必须输入：需求描述、项目结构分析结果
-- 可选输入：需求范围推断结果
-
-## 输出
-
-```json
-{
-  "reusableComponents": [
-    {
-      "name": "recommendation_engine",
-      "path": "ai/services/recommendation.py",
-      "type": "service",
-      "relevance": "high",
-      "description": "推荐引擎服务，支持用户个性化推荐",
-      "reusePotential": "可直接复用，需要扩展收藏场景"
-    },
-    {
-      "name": "pagination_util",
-      "path": "backend/utils/pagination.py",
-      "type": "utility",
-      "relevance": "medium",
-      "description": "通用分页工具",
-      "reusePotential": "可用于收藏夹列表分页"
-    }
-  ],
-  "relatedFiles": [
-    "backend/models/user.py",
-    "backend/models/product.py"
-  ],
-  "suggestions": [
-    "建议复用 recommendation_engine，扩展收藏场景支持",
-    "建议复用 pagination_util 处理收藏夹列表"
-  ]
-}
-```
-
-## 执行步骤
-
-### Step 1: 提取需求核心概念（确定性）
-
-从需求中提取核心概念：
-
-```
-核心概念类型：
-- 实体：用户、商品、订单、收藏夹
-- 操作：创建、查询、更新、删除、列表
-- 属性：名称、状态、时间
-```
-
-### Step 2: Grep搜索相关代码（高效）
-
-基于核心概念搜索代码：
-
-```bash
-# 搜索实体相关文件
-grep -r -l -i "user\|product\|favorite" --include="*.py" . | head -20
-
-# 搜索工具函数
-grep -r -l -i "pagination\|list\|query" --include="*.py" . | head -10
-```
-
-**效率控制**：
-- 按概念优先级搜索，最多 5 个概念
-- 每个概念最多返回 10 个文件
-
-### Step 3: 分析代码结构（确定性）
-
-对搜索到的文件进行结构分析：
-
-```
-分析维度：
-- 文件类型：service、model、util、controller
-- 导出内容：类、函数、常量
-- 依赖关系：import 语句
-```
-
-### Step 4: 语义判断复用潜力（模型）
-
-基于代码上下文判断复用潜力：
-
-```
-模型输入：
-{
-  "requirement": "需求描述",
-  "codeFiles": [
-    {
-      "path": "ai/services/recommendation.py",
-      "preview": "class RecommendationEngine:\n    def recommend(user_id, context): ..."
-    }
-  ],
-  "task": "判断这些代码是否可复用于当前需求，输出复用建议"
-}
-```
-
-### Step 5: 输出结果
-
-汇总可复用组件和相关文件，输出复用建议。
-
-## 组件类型
-
-| 类型 | 说明 | 复用潜力判断 |
-|------|------|-------------|
-| **service** | 业务服务 | 高 - 核心业务逻辑 |
-| **model** | 数据模型 | 高 - 数据结构定义 |
-| **util** | 工具函数 | 高 - 通用功能 |
-| **controller** | 控制器 | 中 - 需要适配 |
-| **config** | 配置 | 低 - 通常需要修改 |
-
-## 调用时机
-
-- 方案设计阶段，设计新功能前
-- 编码实现阶段，开始编码前
-- 评估工作量时
-
-## 示例
-
-**输入**：
-```
-需求：开发用户收藏夹功能
-
-项目结构：
-- backend/services/ (业务服务)
-- backend/models/ (数据模型)
-- backend/utils/ (工具函数)
-- ai/services/ (AI服务)
-```
-
-**Grep搜索**：
-```
-搜索 "user" → 找到 backend/models/user.py
-搜索 "product" → 找到 backend/models/product.py
-搜索 "list\|pagination" → 找到 backend/utils/pagination.py
-搜索 "recommend" → 找到 ai/services/recommendation.py
-```
-
-**输出**：
-```json
-{
-  "reusableComponents": [
-    {
-      "name": "User",
-      "path": "backend/models/user.py",
-      "type": "model",
-      "relevance": "high",
-      "description": "用户模型，包含用户基本信息",
-      "reusePotential": "可直接复用，收藏夹需要关联用户"
-    },
-    {
-      "name": "Product",
-      "path": "backend/models/product.py",
-      "type": "model",
-      "relevance": "high",
-      "description": "商品模型",
-      "reusePotential": "可直接复用，收藏夹需要关联商品"
-    },
-    {
-      "name": "paginate",
-      "path": "backend/utils/pagination.py",
-      "type": "utility",
-      "relevance": "high",
-      "description": "通用分页函数",
-      "reusePotential": "可直接复用，收藏夹列表需要分页"
-    }
-  ],
-  "relatedFiles": [],
-  "suggestions": [
-    "复用 User 和 Product 模型建立收藏夹关联",
-    "复用 paginate 函数处理收藏夹列表分页"
-  ]
-}
-```

package/knowledge/guides/support/environment-scanner.md

@@ -1,207 +0,0 @@
----
-name: environment-scanner
-description: 扫描项目代码检测中间件和组件使用模式
-type: skill
----
-
-# 环境知识扫描器
-
-## 定位
-
-扫描项目代码，检测中间件和组件的使用模式，为 `env-sync` 命令提供数据支撑。
-
----
-
-## 扫描范围
-
-### 1. 依赖文件扫描
-
-| 文件 | 包管理器 | 检测方式 |
-|------|---------|---------|
-| `package.json` | npm/yarn/pnpm | 解析 dependencies 和 devDependencies |
-| `requirements.txt` | pip | 逐行解析包名 |
-| `pyproject.toml` | poetry/pip | 解析 [project.dependencies] |
-| `pom.xml` | Maven | 解析 <dependency> 标签 |
-| `build.gradle` | Gradle | 解析 implementation 语句 |
-| `go.mod` | Go modules | 解析 require 语句 |
-| `Cargo.toml` | Cargo | 解析 [dependencies] |
-
-### 2. 代码模式扫描
-
-扫描源代码目录（src/, lib/, app/, backend/, frontend/ 等）：
-
-**检测模式**：
-```javascript
-// JavaScript/TypeScript
-import redis from 'redis'
-require('mysql2')
-import { MongoClient } from 'mongodb'
-
-// Python
-import redis
-from pymongo import MongoClient
-
-// Java
-import redis.clients.jedis.Jedis;
-import com.mongodb.client.MongoClients;
-
-// Go
-import "github.com/go-redis/redis/v8"
-```
-
-### 3. 环境变量扫描
-
-检测环境变量的使用：
-
-```javascript
-// JavaScript
-process.env.REDIS_URL
-process.env.DATABASE_URL
-
-// Python
-os.environ.get('REDIS_URL')
-os.getenv('DATABASE_URL')
-
-// Java
-System.getenv("REDIS_URL")
-
-// Go
-os.Getenv("REDIS_URL")
-```
-
----
-
-## 输出格式
-
-扫描结果输出到 `.autospec/runtime/env-scan-result.json`：
-
-```json
-{
-  "timestamp": "2024-01-15T10:30:00Z",
-  "project": {
-    "name": "my-project",
-    "techStack": ["Node.js", "TypeScript"]
-  },
-  "detected": {
-    "middleware": [
-      {
-        "name": "redis",
-        "type": "cache",
-        "confidence": 0.95,
-        "evidence": [
-          {
-            "type": "dependency",
-            "file": "package.json",
-            "package": "ioredis",
-            "version": "^5.3.0"
-          },
-          {
-            "type": "code",
-            "file": "src/cache/redis.ts",
-            "pattern": "import Redis from 'ioredis'",
-            "line": 1
-          },
-          {
-            "type": "env-var",
-            "file": "src/config/index.ts",
-            "envVars": ["REDIS_URL", "REDIS_PASSWORD"],
-            "line": 15
-          }
-        ]
-      },
-      {
-        "name": "mysql",
-        "type": "relational-database",
-        "confidence": 0.90,
-        "evidence": [...]
-      }
-    ],
-    "components": [
-      {
-        "name": "axios",
-        "type": "http-client",
-        "confidence": 0.95,
-        "evidence": [...]
-      }
-    ]
-  },
-  "envVars": {
-    "detected": ["REDIS_URL", "DATABASE_URL", "API_KEY"],
-    "missing": ["REDIS_PASSWORD", "DB_PASSWORD"]
-  }
-}
-```
-
----
-
-## 执行步骤
-
-### Step 1: 发现源码目录
-
-```
-1. 读取 .autospec/runtime/config.json 中的 subsystems
-2. 如果无 subsystems，扫描常见目录：
-   - src/, lib/, app/
-   - backend/, frontend/, api/
-   - server/, client/, web/
-```
-
-### Step 2: 扫描依赖文件
-
-```
-1. 检查项目根目录的依赖文件
-2. 解析依赖列表
-3. 匹配已知的中间件包名模式
-```
-
-### Step 3: 扫描代码模式
-
-```
-1. 遍历源码目录（深度限制 5 层）
-2. 跳过 node_modules, .git, dist, build 等
-3. 对每个代码文件：
-   - 匹配 import/require 模式
-   - 提取环境变量使用
-```
-
-### Step 4: 汇总结果
-
-```
-1. 合并依赖和代码扫描结果
-2. 计算置信度
-3. 输出到 .autospec/runtime/env-scan-result.json
-```
-
----
-
-## 已知中间件模式
-
-| 中间件 | npm 包 | pip 包 | Maven artifact |
-|--------|--------|--------|----------------|
-| Redis | ioredis, redis | redis | jedis |
-| MySQL | mysql2 | pymysql | mysql-connector |
-| PostgreSQL | pg | psycopg2 | postgresql |
-| MongoDB | mongodb | pymongo | mongodb-driver |
-| Kafka | kafkajs | kafka-python | kafka-clients |
-| RabbitMQ | amqplib | pika | rabbitmq-client |
-| Elasticsearch | @elastic/elasticsearch | elasticsearch | elasticsearch-java |
-
----
-
-## 注意事项
-
-1. **置信度计算**：
-   - 依赖存在: 0.7
-   - 代码引用: 0.8
-   - 环境变量: 0.85
-   - 多项匹配: 取最高并加权
-
-2. **避免误报**：
-   - 忽略测试文件中的引用（可选）
-   - 忽略注释中的引用
-   - 忽略 devDependencies 中的某些包
-
-3. **性能考虑**：
-   - 大项目限制扫描深度
-   - 使用文件扩展名过滤
-   - 缓存扫描结果