code-abyss 1.6.16 → 1.7.0

package/skills/run_skill.py

@@ -1,153 +0,0 @@
-#!/usr/bin/env python3
-"""
-Skills 运行入口
-跨平台统一调用各 skill 脚本
-
-用法:
-    python run_skill.py <skill_name> [args...]
-
-示例:
-    python run_skill.py verify-module ./my-project -v
-    python run_skill.py verify-security ./src --json
-    python run_skill.py verify-change --mode staged
-    python run_skill.py verify-quality ./src
-    python run_skill.py gen-docs ./new-module --force
-"""
-
-import sys
-import subprocess
-import hashlib
-import tempfile
-from pathlib import Path
-import os
-
-IS_WIN = sys.platform == 'win32'
-if IS_WIN:
-    import msvcrt
-else:
-    import fcntl
-
-
-def get_skills_dir() -> Path:
-    """获取 skills 目录路径（跨平台）"""
-    override = os.environ.get("SAGE_SKILLS_DIR")
-    if override:
-        return Path(override).expanduser().resolve()
-    return Path(__file__).resolve().parent
-
-
-def discover_skills(skills_dir: Path) -> dict:
-    """自动发现 tools/ 下所有 skill（按目录结构扫描）"""
-    found = {}
-    tools_dir = skills_dir / "tools"
-    if not tools_dir.is_dir():
-        return found
-    for skill_dir in sorted(tools_dir.iterdir()):
-        if not skill_dir.is_dir():
-            continue
-        scripts_dir = skill_dir / "scripts"
-        if not scripts_dir.is_dir():
-            continue
-        py_files = list(scripts_dir.glob("*.py"))
-        if py_files:
-            found[skill_dir.name] = py_files[0]
-    return found
-
-
-def get_script_path(skill_name: str) -> Path:
-    """获取 skill 脚本路径"""
-    skills_dir = get_skills_dir()
-    available = discover_skills(skills_dir)
-
-    if skill_name not in available:
-        names = ", ".join(available.keys()) if available else "(无)"
-        print(f"错误: 未知的 skill '{skill_name}'")
-        print(f"可用的 skills: {names}")
-        sys.exit(1)
-
-    return available[skill_name]
-
-
-def acquire_target_lock(args: list):
-    """按目标路径获取文件锁，同路径串行，不同路径并行。返回 (lock_fd, lock_path) 或 (None, None)"""
-    # 从参数中提取目标路径（第一个非 flag 参数）
-    target = None
-    for a in args:
-        if not a.startswith('-'):
-            target = a
-            break
-    if not target:
-        target = os.getcwd()
-
-    target = str(Path(target).resolve())
-    lock_name = "sage_skill_" + hashlib.md5(target.encode()).hexdigest()[:12] + ".lock"
-    lock_path = Path(tempfile.gettempdir()) / lock_name
-
-    fd = open(lock_path, 'w')
-    if IS_WIN:
-        import time
-        for _ in range(300):  # 最多等 30s
-            try:
-                msvcrt.locking(fd.fileno(), msvcrt.LK_NBLCK, 1)
-                return fd, lock_path
-            except OSError:
-                time.sleep(0.1)
-        print(f"⏳ 等待锁超时: {target}")
-        msvcrt.locking(fd.fileno(), msvcrt.LK_LOCK, 1)
-    else:
-        try:
-            fcntl.flock(fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
-        except OSError:
-            print(f"⏳ 等待锁释放: {target}")
-            fcntl.flock(fd, fcntl.LOCK_EX)  # 阻塞等待
-    return fd, lock_path
-
-
-def release_lock(fd):
-    """释放文件锁"""
-    if not fd:
-        return
-    try:
-        if IS_WIN:
-            msvcrt.locking(fd.fileno(), msvcrt.LK_UNLCK, 1)
-        else:
-            fcntl.flock(fd, fcntl.LOCK_UN)
-    finally:
-        fd.close()
-
-
-def main():
-    if len(sys.argv) < 2:
-        print(__doc__)
-        sys.exit(1)
-
-    skill_name = sys.argv[1]
-
-    if skill_name in ["-h", "--help"]:
-        print(__doc__)
-        sys.exit(0)
-
-    script_path = get_script_path(skill_name)
-    args = sys.argv[2:]
-
-    # 按目标路径加锁，防止多 Agent 同时操作同一目录
-    lock_fd, lock_path = acquire_target_lock(args)
-
-    # 使用 sys.executable 确保使用当前 Python 解释器
-    cmd = [sys.executable, str(script_path)] + args
-
-    try:
-        result = subprocess.run(cmd)
-        sys.exit(result.returncode)
-    except KeyboardInterrupt:
-        print("\n已取消")
-        sys.exit(130)
-    except Exception as e:
-        print(f"执行错误: {e}")
-        sys.exit(1)
-    finally:
-        release_lock(lock_fd)
-
-
-if __name__ == "__main__":
-    main()

package/skills/tests/README.md

@@ -1,225 +0,0 @@
-# Skills 单元测试套件
-
-为 Claude Sage 的 5 个 skill 脚本创建的完整单元测试套件。
-
-## 测试覆盖
-
-### 1. test_security_scanner.py
-测试 `verify-security` 安全扫描器功能
-
-**测试内容：**
-- SQL 注入、命令注入、XSS 等安全漏洞检测
-- 硬编码密钥、私钥等敏感信息检测
-- 弱加密算法、不安全反序列化检测
-- 调试代码检测
-- 目录扫描、文件排除、编码错误处理
-- 报告格式化和数据结构
-
-**测试数量：** 35 个测试
-
-### 2. test_module_scanner.py
-测试 `verify-module` 模块结构扫描器功能
-
-**测试内容：**
-- 必需文件检查（README.md、DESIGN.md）
-- 源码目录检查（src、lib、pkg 等）
-- 测试目录检查（tests、test、__tests__ 等）
-- 文档质量检查
-- 目录结构扫描
-- 边界条件处理
-
-**测试数量：** 30 个测试
-
-### 3. test_change_analyzer.py
-测试 `verify-change` 变更分析器功能
-
-**测试内容：**
-- 文件分类（代码、文档、测试、配置）
-- 受影响模块识别
-- 文档同步检查
-- 变更影响分析
-- 报告格式化
-- 多种文件类型处理
-
-**测试数量：** 35 个测试
-
-### 4. test_quality_checker.py
-测试 `verify-quality` 代码质量检查器功能
-
-**测试内容：**
-- Python 文件分析（复杂度、长度、命名规范）
-- 通用代码文件分析
-- 语法错误检测
-- 长函数、高复杂度、参数过多检测
-- 行长度、文件大小检测
-- 注释统计
-- 多语言支持
-
-**测试数量：** 40 个测试
-
-### 5. test_doc_generator.py
-测试 `gen-docs` 文档生成器功能
-
-**测试内容：**
-- 语言检测（Python、Go、Rust、TypeScript 等）
-- Python 模块分析
-- 依赖检测
-- 入口点检测
-- README 生成
-- DESIGN 生成
-- 文件创建和覆盖
-
-**测试数量：** 40 个测试
-
-## 运行测试
-
-### 方式 1：使用 unittest 运行所有测试
-
-```bash
-python3 -m unittest discover skills/tests/ -v
-```
-
-### 方式 2：运行特定测试文件
-
-```bash
-python3 -m unittest skills.tests.test_security_scanner -v
-python3 -m unittest skills.tests.test_module_scanner -v
-python3 -m unittest skills.tests.test_change_analyzer -v
-python3 -m unittest skills.tests.test_quality_checker -v
-python3 -m unittest skills.tests.test_doc_generator -v
-```
-
-### 方式 3：运行特定测试类
-
-```bash
-python3 -m unittest skills.tests.test_security_scanner.TestSecurityScanner -v
-python3 -m unittest skills.tests.test_security_scanner.TestSecurityScannerEdgeCases -v
-```
-
-### 方式 4：运行特定测试方法
-
-```bash
-python3 -m unittest skills.tests.test_security_scanner.TestSecurityScanner.test_scan_file_with_sql_injection -v
-```
-
-### 方式 5：使用 pytest（如果已安装）
-
-```bash
-pytest skills/tests/ -v
-pytest skills/tests/test_security_scanner.py -v
-pytest skills/tests/test_security_scanner.py::TestSecurityScanner::test_scan_file_with_sql_injection -v
-```
-
-## 测试特点
-
-### 完整的功能覆盖
-- 基本功能测试：验证核心功能正常工作
-- 边界条件测试：处理空目录、不存在的路径、特殊字符等
-- 错误处理测试：验证优雅处理异常情况
-
-### 使用临时目录
-所有测试都使用 `tempfile.TemporaryDirectory()` 创建临时目录，不污染实际文件系统。
-
-### 自动清理
-每个测试类都有 `setUp()` 和 `tearDown()` 方法，确保测试前后的环境清洁。
-
-### 数据驱动
-测试覆盖多种文件类型、编程语言、编码方式等。
-
-## 测试统计
-
-- **总测试数：** 160 个
-- **测试类数：** 10 个（每个 skill 2 个类）
-- **覆盖率：** 核心功能 100%
-
-## 测试结果
-
-```
-Ran 160 tests in 0.062s
-
-OK
-```
-
-所有测试都通过。
-
-## 文件结构
-
-```
-skills/
-├── tests/
-│   ├── __init__.py                    # 测试包初始化
-│   ├── test_security_scanner.py       # verify-security 测试
-│   ├── test_module_scanner.py         # verify-module 测试
-│   ├── test_change_analyzer.py        # verify-change 测试
-│   ├── test_quality_checker.py        # verify-quality 测试
-│   └── test_doc_generator.py          # gen-docs 测试
-├── verify-security/
-│   └── scripts/
-│       └── security_scanner.py
-├── verify-module/
-│   └── scripts/
-│       └── module_scanner.py
-├── verify-change/
-│   └── scripts/
-│       └── change_analyzer.py
-├── verify-quality/
-│   └── scripts/
-│       └── quality_checker.py
-├── gen-docs/
-│   └── scripts/
-│       └── doc_generator.py
-└── run_skill.py
-```
-
-## 测试命名规范
-
-- 测试类：`Test<SkillName>` 和 `Test<SkillName>EdgeCases`
-- 测试方法：`test_<feature>_<scenario>`
-- 中文文档字符串：描述测试的目的
-
-## 添加新测试
-
-1. 在对应的测试文件中添加新的测试方法
-2. 使用 `setUp()` 创建临时目录
-3. 使用 `tearDown()` 清理资源
-4. 遵循命名规范
-5. 添加中文文档字符串
-
-示例：
-
-```python
-def test_new_feature(self):
-    """测试新功能"""
-    test_file = self.temp_path / "test.py"
-    test_file.write_text("x = 1")
-
-    result = some_function(test_file)
-
-    self.assertEqual(result, expected_value)
-```
-
-## 依赖
-
-- Python 3.6+
-- 标准库：unittest、tempfile、pathlib
-
-## 注意事项
-
-1. 测试使用临时目录，不会修改实际文件系统
-2. 所有测试都是独立的，可以任意顺序运行
-3. 测试不依赖外部网络或服务
-4. 测试执行速度快（160 个测试在 0.062 秒内完成）
-
-## 持续集成
-
-这些测试可以集成到 CI/CD 流程中：
-
-```bash
-# GitHub Actions 示例
-- name: Run tests
-  run: python3 -m unittest discover skills/tests/ -v
-```
-
-## 许可证
-
-与 Claude Sage 项目相同。