@chongyan/autospec 1.0.2 → 1.0.3

package/knowledge/03-guides/26-analyze-tech-stack.md

@@ -1,139 +0,0 @@
-# 技术栈分析器
-
-## 功能
-
-分析项目技术栈，识别框架、语言、工具链。对于配置规则中未定义的依赖，使用 AI 进行智能推测。
-
-## 触发条件
-
-- 检测器发现未识别的依赖
-- 需要更精确的技术栈分析
-- 项目结构复杂，需要 AI 辅助判断
-
-## 输入
-
-```json
-{
-  "projectDir": "项目根目录",
-  "buildFiles": [
-    {
-      "path": "package.json",
-      "content": "文件内容"
-    }
-  ],
-  "unknownDeps": ["未识别的依赖列表"],
-  "directoryStructure": "目录结构概览"
-}
-```
-
-## 输出
-
-```json
-{
-  "identifiedStacks": [
-    {
-      "framework": "框架名称",
-      "type": "frontend/backend/ai/data",
-      "confidence": "high/medium/low",
-      "reasoning": "判断依据"
-    }
-  ],
-  "suggestions": [
-    {
-      "dependency": "依赖名",
-      "possibleFramework": "可能的框架",
-      "type": "类型",
-      "confidence": "置信度"
-    }
-  ]
-}
-```
-
-## 执行步骤
-
-1. **分析构建文件**
-   - 读取 package.json、pom.xml、requirements.txt 等
-   - 提取依赖列表和版本信息
-
-2. **识别已知框架**
-   - 匹配配置规则中定义的框架
-   - 记录高置信度识别结果
-
-3. **分析未知依赖**
-   - 对于未在规则中的依赖，使用 AI 推测：
-     - 依赖名称语义分析
-     - 常见命名模式识别
-     - 版本号格式分析
-
-4. **推断项目类型**
-   - 结合目录结构判断项目类型
-   - monorepo: 有 packages/、apps/ 目录
-   - microservices: 多个独立服务模块
-   - single-app: 单一入口项目
-
-5. **生成分析报告**
-   - 汇总所有识别结果
-   - 提供置信度评估
-   - 建议是否需要添加新规则
-
-## 规则
-
-1. **优先使用确定性规则**
-   - 配置文件中定义的规则优先级最高
-   - AI 推测仅作为补充
-
-2. **置信度评估**
-   - high: 配置规则匹配
-   - medium: AI 基于语义推测
-   - low: AI 基于模式推测
-
-3. **避免过度推测**
-   - 不确定时不强行判断
-   - 建议人工确认
-
-## 示例
-
-### 输入
-
-```json
-{
-  "unknownDeps": ["@astrojs/vue", "astro"],
-  "directoryStructure": "src/pages/, src/components/, astro.config.mjs"
-}
-```
-
-### 输出
-
-```json
-{
-  "identifiedStacks": [
-    {
-      "framework": "Astro",
-      "type": "frontend",
-      "confidence": "high",
-      "reasoning": "检测到 astro 依赖和 astro.config.mjs 配置文件"
-    }
-  ],
-  "suggestions": [
-    {
-      "dependency": "@astrojs/vue",
-      "possibleFramework": "Astro Vue Integration",
-      "type": "frontend",
-      "confidence": "high"
-    }
-  ]
-}
-```
-
-## 配置更新建议
-
-当发现新的框架或工具时，建议将其添加到配置文件：
-
-```yaml
-# 添加到 knowledge/06-environment/01-detection-patterns.yaml
-frameworks:
-  javascript:
-    - deps: [astro]
-      framework: Astro
-      type: frontend
-```

package/knowledge/03-guides/27-scan-environment.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. **性能考虑**：
-   - 大项目限制扫描深度
-   - 使用文件扩展名过滤
-   - 缓存扫描结果

package/knowledge/03-guides/28-validate-environment.md

@@ -1,207 +0,0 @@
----
-name: environment-validator
-description: 校验环境知识配置文件的完整性和有效性
-type: skill
----
-
-# 环境配置校验器
-
-## 定位
-
-校验 `.autospec/environment/` 目录下的环境知识配置文件，确保格式正确、字段完整、内容有效。
-
----
-
-## 校验范围
-
-### 1. 文件格式校验
-
-| 文件类型 | 校验项 |
-|---------|--------|
-| YAML (.yaml, .yml) | 语法正确性、缩进一致性 |
-| JSON (.json) | 语法正确性、编码格式 |
-
-### 2. 必填字段校验
-
-**中间件配置** (`env-knowledge/middleware/*.yaml`)：
-```yaml
-apiVersion: autospec/v1     # 必填
-kind: Middleware            # 必填
-meta
-  name: string              # 必填
-  version: string           # 必填
-spec:
-  type: string              # 必填
-  connection:
-    template: string        # 必填
-```
-
-**组件配置** (`component-lib/components/*/component.yaml`)：
-```yaml
-apiVersion: autospec/v1     # 必填
-kind: Component             # 必填
-metadata:
-  name: string              # 必填
-  version: string           # 必填
-spec:
-  type: string              # 必填
-  description: string       # 必填
-```
-
-### 3. 类型一致性校验
-
-| 字段 | 期望类型 |
-|------|---------|
-| `metadata.version` | 语义化版本字符串 |
-| `spec.type` | 枚举值 |
-| `spec.configuration.required` | 数组 |
-| `spec.bestPractices` | 数组 |
-
-### 4. 引用完整性校验
-
-- 环境变量引用是否存在
-- 文件路径引用是否正确
-- 注册表与实际文件是否一致
-
----
-
-## 输出格式
-
-校验结果输出：
-
-```json
-{
-  "timestamp": "2024-01-15T10:30:00Z",
-  "summary": {
-    "total": 15,
-    "passed": 12,
-    "failed": 2,
-    "warnings": 3
-  },
-  "files": [
-    {
-      "path": "env-knowledge/middleware/redis.yaml",
-      "valid": true,
-      "errors": [],
-      "warnings": [
-        {
-          "field": "spec.connection.template",
-          "message": "连接模板中包含硬编码的主机地址",
-          "suggestion": "建议使用环境变量替换"
-        }
-      ]
-    },
-    {
-      "path": "env-knowledge/middleware/mysql.yaml",
-      "valid": false,
-      "errors": [
-        {
-          "field": "metadata.version",
-          "message": "版本号格式不正确",
-          "expected": "语义化版本 (如 1.0.0)",
-          "actual": "v1"
-        },
-        {
-          "field": "spec.type",
-          "message": "未知的中间件类型",
-          "expected": "relational-database, document-database, cache, message-queue, search-engine",
-          "actual": "db"
-        }
-      ],
-      "warnings": []
-    }
-  ]
-}
-```
-
----
-
-## 执行步骤
-
-### Step 1: 扫描配置文件
-
-```
-1. 扫描 .autospec/environment/ 下所有 YAML/JSON 文件
-2. 跳过隐藏文件和临时文件
-3. 构建文件列表
-```
-
-### Step 2: 逐文件校验
-
-```
-对每个文件：
-1. 解析文件内容
-2. 校验文件格式
-3. 校验必填字段
-4. 校验类型一致性
-5. 记录错误和警告
-```
-
-### Step 3: 注册表校验
-
-```
-1. 读取 registry.json
-2. 检查注册的文件是否存在
-3. 检查文件与注册信息是否一致
-```
-
-### Step 4: 汇总结果
-
-```
-1. 统计通过/失败/警告数量
-2. 输出校验报告
-```
-
----
-
-## 校验规则
-
-### 错误级别（必须修复）
-
-| 规则 | 说明 |
-|------|------|
-| YAML_SYNTAX | YAML 语法错误 |
-| JSON_SYNTAX | JSON 语法错误 |
-| REQUIRED_FIELD | 缺少必填字段 |
-| INVALID_TYPE | 字段类型不正确 |
-| INVALID_VERSION | 版本号格式不正确 |
-| FILE_NOT_FOUND | 注册表中引用的文件不存在 |
-
-### 警告级别（建议修复）
-
-| 规则 | 说明 |
-|------|------|
-| HARDCODED_VALUE | 硬编码值（建议使用环境变量） |
-| MISSING_OPTIONAL | 缺少可选但推荐的字段 |
-| DEPRECATED_FIELD | 使用了已弃用的字段 |
-| EMPTY_SECTION | 空的配置段落 |
-| INCONSISTENT_NAMING | 命名风格不一致 |
-
----
-
-## 自动修复（可选）
-
-对于某些问题，支持自动修复：
-
-| 问题 | 修复方式 |
-|------|---------|
-| 缺少 `apiVersion` | 自动填充 `autospec/v1` |
-| 缺少 `kind` | 根据文件路径推断 |
-| 版本号格式错误 | 尝试转换为语义化版本 |
-| 缩进不一致 | 自动格式化 YAML |
-
----
-
-## 注意事项
-
-1. **性能考虑**：
-   - 大文件分块解析
-   - 并行处理多个文件
-
-2. **兼容性**：
-   - 支持不同版本的配置格式
-   - 向后兼容旧版本字段
-
-3. **扩展性**：
-   - 支持自定义校验规则
-   - 支持插件扩展