4.7 KiB
4.7 KiB
ADDED Requirements
Requirement: 测试必须不污染用户环境
工具的所有测试必须通过环境变量隔离配置和安装目录，不影响用户的实际数据和系统配置。
Scenario: 配置目录隔离
- WHEN 测试运行时设置
SKILLMGR_TEST_ROOT环境变量 - THEN 系统使用该环境变量指定的目录作为配置根目录，而非
~/.skillmgr/
Scenario: 安装目标目录隔离
- WHEN 测试运行时设置
SKILLMGR_TEST_BASE环境变量 - THEN 系统使用该环境变量指定的目录作为全局/项目基础路径，而非用户主目录或当前工作目录
Scenario: 生产模式不受影响
- WHEN 环境变量未设置（生产模式）
- THEN 系统使用默认路径（
~/.skillmgr/、~/.claude/等）
Requirement: 测试必须自动清理临时资源
所有测试创建的临时目录、文件和 git 仓库必须在测试结束后自动清理，不留垃圾文件。
Scenario: 使用 Go 测试框架自动清理
- WHEN 测试使用
t.TempDir()创建临时目录 - THEN Go 测试框架在测试结束时自动删除该目录及其所有内容
Scenario: 测试失败时也清理
- WHEN 测试失败或 panic
- THEN 临时资源仍然被自动清理
Requirement: 测试必须支持并行执行
测试设计必须允许多个测试并行运行，互不干扰，充分利用多核性能。
Scenario: 独立测试环境
- WHEN 使用
go test -parallel N并行运行多个测试 - THEN 每个测试使用独立的临时目录，不产生竞态条件
Scenario: 配置隔离
- WHEN 多个测试同时设置环境变量
- THEN 每个测试的环境变量设置独立生效（通过 t.Setenv 或 defer os.Unsetenv）
Requirement: 用户交互必须可 mock
所有涉及用户输入的功能必须支持测试时注入 mock 输入，不依赖真实的标准输入。
Scenario: Mock 用户确认输入
- WHEN 测试需要模拟用户输入 "y" 或 "n"
- THEN
prompt.ConfirmWithReader函数接受io.Reader参数，测试时传入strings.NewReader("y\n")
Scenario: 生产模式使用真实输入
- WHEN 生产代码调用
prompt.Confirm - THEN 内部调用
ConfirmWithReader(message, os.Stdin)读取真实用户输入
Requirement: 测试必须使用真实文件系统
测试应使用真实的文件系统操作和 git 命令，而非 mock，以确保行为与生产一致。
Scenario: 真实文件复制测试
- WHEN 测试文件复制功能
- THEN 在临时目录中创建真实文件，执行复制，验证结果
Scenario: 真实 git 操作测试
- WHEN 测试 git clone/pull 功能
- THEN 在临时目录中初始化真实的 git 仓库，执行 git 命令
Requirement: 测试数据必须可复用
测试应提供标准的 fixture 数据和辅助函数，避免每个测试重复构建测试环境。
Scenario: Fixture 仓库
- WHEN 测试需要一个标准的 skills/commands 仓库
- THEN 从
testdata/fixtures/test-repo/复制 fixture 并初始化为 git 仓库
Scenario: 测试辅助函数
- WHEN 测试需要设置隔离环境
- THEN 调用
setupTestEnv(t)函数自动设置环境变量和临时目录
Requirement: 测试覆盖必须全面
测试必须覆盖所有核心模块、关键路径和边界条件。
Scenario: 单元测试覆盖
- WHEN 实现任何核心函数（config、adapter、repo、installer）
- THEN 必须编写对应的单元测试，覆盖正常和异常情况
Scenario: 集成测试覆盖
- WHEN 实现跨模块功能（完整安装流程）
- THEN 必须编写集成测试，验证端到端行为
Scenario: 平台兼容性测试
- WHEN 支持多个平台（Claude Code、OpenCode）
- THEN 每个平台都必须有独立的兼容性测试
Requirement: 测试脚本必须简化运行
必须提供自动化脚本，简化测试环境设置和测试执行。
Scenario: 自动化测试脚本
- WHEN 开发者运行
./scripts/test.sh - THEN 脚本自动设置测试环境变量、运行所有测试、清理临时资源
Scenario: 沙盒测试环境
- WHEN 开发者运行
./scripts/sandbox.sh - THEN 脚本创建隔离的沙盒环境，允许手动测试而不影响系统
Requirement: CI/CD 集成必须无缝
测试必须能在 CI/CD 环境中稳定运行，不依赖本地环境配置。
Scenario: GitHub Actions 集成
- WHEN 在 CI 中运行测试
- THEN 通过环境变量设置测试路径，所有测试通过且自动清理
Scenario: 测试失败报告
- WHEN 测试失败
- THEN CI 系统捕获失败信息、日志和覆盖率报告