@chongyan/autospec 1.0.1

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

@@ -0,0 +1,268 @@
+---
+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

@@ -0,0 +1,183 @@
+---
+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

@@ -0,0 +1,207 @@
+---
+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. **性能考虑**：
+   - 大项目限制扫描深度
+   - 使用文件扩展名过滤
+   - 缓存扫描结果