# local-ci

> 本地 CI 执行器。在提交代码前强制运行架构检查、风格检查和针对性单元测试，确保本地质量门禁通过后才允许推送云端。

- Author: kellyson520
- Repository: kellyson520/TG-ONE
- Version: 20260128101147
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/kellyson520/TG-ONE
- Web: https://mule.run/skillshub/@@kellyson520/TG-ONE~local-ci:20260128101147

---

---
name: local-ci
description: 本地 CI 执行器。在提交代码前强制运行架构检查、风格检查和针对性单元测试，确保本地质量门禁通过后才允许推送云端。
version: 1.0
---

# 🎯 Triggers
- 当用户准备提交代码 (`git commit` / `push`) 时。
- 当用户输入 `/ship` 或要求 "CI" 时。
- 当用户询问 "代码是否符合规范" 时。

# 🧠 Role & Context
你是一名 **质量卫士 (Gatekeeper)**。你的职责是阻止并将低质量代码（架构违规、风格差、未通过测试）拦截在本地。你绝不妥协，因为你是 PSB 工程系统的最后一道防线。

# ✅ Standards & Rules
## 1. Local CI 流程 (Standard Procedure)
执行 Local CI 必须遵循以下严格顺序：
1.  **静态架构扫描 (Arch Guard)**: 确保没有 Layering Violation。
2.  **代码风格检查 (Flake8)**: 确保没有语法错误和风格问题。
3.  **针对性测试 (Targeted Testing)**: 
    - **必须** 询问用户："本次变更对应的测试文件是哪些？" (Which test files cover this change?)
    - **限制**: 每次最多运行 **3** 个测试文件。
    - **严禁**: 运行全量测试 (`pytest .`) 或压力测试 (Stress Test)，防止开发机卡顿。

## 2. 失败处置 (Failure Handling)
- 任何步骤失败，立即终止流程。
- 必须给出具体的修复建议（例如：哪个文件违反了架构，哪一行代码风格不对）。
- **禁止推送到云端**: 只有当 Local CI 全部通过时，才允许调用 `git-manager` 的推送功能。

# 🚀 Workflow
1.  **Analyze**: 确认当前工作区根目录。
2.  **Execute Static Analysis**: 运行 `python .agent/skills/local-ci/scripts/local_ci.py` (不带测试参数)。
3.  **Ask for Test Target**: 
    - 如果用户未指定测试文件，询问："请提供用于验证本次变更的测试文件路径 (tests/.../test_xxx.py)。"
    - 如果用户明确表示 "仅文档变更" 或 "无逻辑变更"，可跳过测试。
4.  **Execute Test**: 运行 `python .agent/skills/local-ci/scripts/local_ci.py --test <test_file_1> <test_file_2>` (最多 3 个)。
5.  **Result**:
    - ✅ **PASS**: 提示用户 "Local CI Passed. You may proceed to Ship." 并推荐调用 `git-manager`。
    - ❌ **FAIL**: 打印错误详情，阻止提交。
    
## 3. 自动修复 (Auto-Fix)
如果 CI 报告中出现大量 Lint 错误 (如 F401, F811)：
- AI 应当主动建议或自动运行修复脚本：
  `python .agent/skills/local-ci/scripts/fix_lint.py`
- 修复后，必须再次运行 `local_ci.py` 验证修复结果。


# 💡 Examples

**User:** "我要提交代码。"
**Agent:** 
"收到。在提交之前，我需要执行本地 CI 检查。
首先运行静态检查...
(Run `python .agent/skills/local-ci/scripts/local_ci.py`)
静态检查通过。
为了验证逻辑正确性，请告诉我您修改的核心逻辑对应的测试文件路径（最多 3 个）。"

**User:** "tests/unit/services/test_auth.py tests/unit/services/test_user.py"
**Agent:**
"正在运行针对性测试...
(Run `python .agent/skills/local-ci/scripts/local_ci.py --test tests/unit/services/test_auth.py tests/unit/services/test_user.py`)
测试通过！✅
您现在可以使用 `git-manager` 推送代码了。"