CI Preflight — 推前预检 Skill（参考文档）

说明

CI 预检行为已在 APPEND_SYSTEM.md 中作为永久系统指令启用。 本 skill 作为参考文档，包含详细的命令和逻辑说明。

完整执行流程

Step 1: 检查 CI 配置

ls .github/workflows/*.yml 2>/dev/null || echo "NO_CI"

如果有 CI 配置 → 读取全部 workflow 文件，提取步骤 如果无 CI 配置 → 根据检测到的项目类型走默认检查

Step 2: 按项目类型执行检查

Node.js 项目（每项设 60s 超时）

timeout 60 npm ci --ignore-scripts 2>/dev/null    # 依赖一致性
timeout 60 npx tsc --noEmit 2>/dev/null            # 类型检查
timeout 60 npx eslint src/ --max-warnings 0 2>/dev/null  # 代码规范
timeout 60 node --test tests/*.test.ts 2>/dev/null # 单元测试
timeout 60 npm run build 2>/dev/null               # 构建

Python 项目

pip install -r requirements.txt -q 2>/dev/null     # 依赖
mypy src/ 2>/dev/null                              # 类型
ruff check src/ 2>/dev/null                        # 规范
pytest tests/ -q 2>/dev/null                       # 测试

Rust 项目

cargo check 2>/dev/null
cargo clippy 2>/dev/null
cargo test 2>/dev/null

Go 项目

go mod tidy 2>/dev/null
go vet ./... 2>/dev/null
go test ./... 2>/dev/null
go build ./... 2>/dev/null

无法确定项目类型 → 至少检查：

• README/文档是否完整
• 是否有明文密钥/硬编码凭据
• 编码风格是否与项目已有代码一致
• 新文件是否有对应的测试

Step 3: 自动修复（带上限）

每项失败时：

1. 读取完整错误输出（不是只看最后几行）
2. 定位根因 — 类型错误？格式问题？缺少依赖？
3. 做最小修复 — 不要重构周围代码，不要改 CI 配置文件
4. 重新运行该项（最多 3 次）
5. 3 次仍失败 → 记录到报告中，跳过，继续下一项
6. 修完当前项后必须从 Step 2 开头重跑整个检查链条
7. 连续 5 轮重跑后仍有失败 → 停止并向用户报告

Step 4: 输出预检报告

✅ CI Preflight 完成
  ├── npm ci:       通过
  ├── tsc --noEmit: 通过  (1 个新错误→已修复)
  ├── eslint:       通过  (0 warnings)
  ├── tests:        通过  (12/12)
  └── build:        通过

有 3 次修复仍失败的项 → 输出失败详情 → 不要标记完成

特殊情况