SuperAPI AI 工具集

simplify-and-harden-ci

部署与运维

查看项目

更新于 10-16 04:53

技能介绍

用途:在 Pull Request 的 CI 流程中运行 Simplify & Harden 的 CI 专用变体。CI 中不修改代码,仅审查变更文件,输出结构化发现项,并可选按严重性门控阻断合并。交互式/本地编码场景应使用 simplify-and-harden。

主要能力: CI 契约强制以下要求:范围锁定(只审查 PR 中变更的文件);无头执行(只报告发现,不应用补丁或重构);结构化输出(emit simplify_and_harden summary payload);门控策略:存在 critical harden 发现时检查失败;advisory(可选)发现被配置为阻断时检查失败。工作流包含 simplify(死代码、命名清晰度、控制流复杂度、多余 API 面、过度抽象)、harden(输入校验缺口、注入向量、认证/授权问题、密钥暴露、数据泄露、并发风险)、document(以发现项形式建议非显而易见的注释,不编辑文件)三条检查通道,并输出含计数、review_followup_required 与 learning loop 候选的结构化 YAML。

使用方式: 安装:gh skill install pskoett/pskoett-skills simplify-and-harden-ci,或回退用 npx skills add pskoett/pskoett-skills/skills/simplify-and-harden-ci。 前置条件:仓库启用 GitHub Actions;GitHub CLI 已认证(gh auth status);本地安装 gh-aw:gh extension install github/gh-aw。在 GitHub Actions 任务中用 setup-cli 安装:

  • uses: github/gh-aw/actions/setup-cli@main with: version: v0.2.0-beta 编写工作流:将 references/workflow-example.md 模板块复制到 .github/workflows/simplify-and-harden-ci.md(.md 扩展名是刻意的:gh-aw 工作流是 markdown,由 gh aw compile 编译为 GitHub Actions 实际运行的 .lock.yml,并非手写 YAML)。编译校验:gh aw compile --validate --strict。触发并推送:gh aw run simplify-and-harden-ci --push。

适用场景与限制:适用于在 PR 中对变更文件做结构化审查与合并门控。重要限制:CI 智能体不具备编写变更的编码智能体那样的峰值实现上下文,应将 CI 发现视为结构化审查信号,而非完整的意图感知重写;优先扫描/报告与合并门控,不要在 CI 中自动应用代码改动,模糊发现升级到交互式审查。

与自我改进集成:将 simplify_and_harden.learning_loop.candidates 经由 self-improvement 工作流转发到 .learnings/LEARNINGS.md,使重复模式提升为长期智能体上下文规则。