SuperAPI AI 工具集

self-improvement-ci

部署与运维

查看项目

更新于 10-15 18:09

技能介绍

用途

Self-Improvement CI 用于在 CI 中运行自改进流程,无需交互式聊天循环。它主要完成以下工作:

  • 检查 PR 检查结果和 CI 失败
  • 从 simplify-and-harden-ci 摄取学习候选
  • 从 .learnings/HEALS.md 摄取 Handoff 块(由 self-healing / self-healing-ci 提交),并将其作为晋升候选呈现
  • 按稳定的 pattern_key 对反复出现的模式去重
  • 输出可供晋升的建议,用于智能体上下文/系统提示

该技能对仓库是只读的(见 CI 契约):它不写入 .learnings/ 条目。其候选以机器可读输出形式发出,晋升以 PR 或评论形式提出,供人工审核。

交互式/本地会话请使用 self-improvement。

上下文限制(重要)

CI 智能体不具备原始实现会话的峰值任务上下文。应使用此技能跨运行聚合反复出现的模式,而不是推断细微的一次性意图。

影响:

  • 优先采用稳定的 pattern_key 复现信号,而非单次运行结论
  • 晋升前要求达到复现阈值
  • 将不确定或高影响的建议转交交互式审核

前置条件

  • 仓库已启用 GitHub Actions
  • GitHub CLI 已认证(gh auth status)
  • 已安装 gh-aw 用于编写/验证:
gh extension install github/gh-aw

安装

gh skill install pskoett/pskoett-skills self-improvement-ci

使用 Agent Skills CLI 的备用方式:

npx skills add pskoett/pskoett-skills/skills/self-improvement-ci

CI 契约

CI 技能必须:

  • 只读取 PR 范围内的数据(检查、工作流结果、现有学习条目)
  • 避免在 CI 中直接修改代码
  • 发出机器可读的学习输出
  • 仅在达到复现阈值时建议晋升

输出模式

self_improvement_ci:
  source:
    pr_number: 123
    commit_sha: "abc123"
  candidates:
    - pattern_key: "harden.input_validation"
      source: "simplify-and-harden-ci"
      recurrence_count: 3
      first_seen: "2026-02-01"
      last_seen: "2026-02-20"
      severity: "high"
      suggested_rule: "Validate and bound-check external inputs before use."
      promotion_ready: true
  summary:
    candidates_total: 4
    promotion_ready_total: 1
    followup_required: true

复现与晋升规则

  • 按 pattern_key 跟踪复现
  • 默认晋升阈值:
    • recurrence_count >= 3
    • 出现在 >= 2 个不同任务/运行中
    • 在 30 天窗口内
  • 晋升目标:
    • CLAUDE.md
    • AGENTS.md
    • .github/copilot-instructions.md
    • 使用 openclaw 工作区记忆时的 SOUL.md / TOOLS.md

编写工作流(gh-aw)

仅示例模板位于 references/workflow-example.md。在明确决定启用 CI 自动化之前,请将示例保留在 .github/workflows 之外。

准备就绪后:

  1. 将模板复制到 .github/workflows/self-improvement-ci.md
  2. 自定义工具访问、输出和策略阈值
  3. 验证:
gh aw compile --validate --strict
  1. 手动触发测试运行:
gh aw run self-improvement-ci --push

Heal Handoff 摄取

self-healing-ci 将 Handoff 块追加到满足晋升规则的 .learnings/HEALS.md 条目中。每次运行时:

  • 读取 .learnings/HEALS.md(只读),收集带有 Handoff 块的条目
  • 将每个条目映射为候选:pattern_key 来自 HEAL 的 Pattern-Key,suggested_rule 来自 Distilled Rule,复现字段来自条目元数据
  • 当晋升规则成立时标记 promotion_ready: true,并将该候选与 simplify-and-harden-ci 候选一起包含在输出模式中
  • 将晋升(目标文件 + 规则文本)作为 PR 或评论提出——绝不从 CI 直接写入指令文件

与其他技能的集成

  • 与 simplify-and-harden-ci 配对,以摄取 simplify_and_harden.learning_loop.candidates
  • 与 self-healing-ci 配对,本技能消费其 HEALS.md Handoff 块(见 Heal Handoff 摄取)
  • 将晋升的模式反馈到 self-improvement 记忆工作流,形成持久的预防规则