auto-trigger

自動トリガーフック

このスキルでは、スキル間のトリガーの意図を定義します。スキルがワークフローを完了すると、ホストランタイムまたはエージェントはこのメタデータを読み取り、後続処理を保留として記録できます。次のスキルを実行するのは、その処理が現在のセッションでサポートされ、安全な場合に限ります。

フックの定義

PRD 作成チェーン

prd_complete:
  triggers:
    - skill: self-improving-agent
      mode: background
      condition: PRD file exists and is complete
    - skill: session-logger
      mode: auto
      context: "PRD created for {feature_name}"

prd_implemented:
  triggers:
    - skill: session-logger
      mode: auto
      context: "Implemented PRD: {feature_name}"

実装チェーン

implementation_complete:
  triggers:
    - skill: code-reviewer
      mode: ask_first
      message: "Implementation complete. Run code review?"
    - skill: create-pr
      mode: ask_first
      condition: user_requested_submission

セッション管理

session_start:
  auto_triggers:
    - skill: session-logger
      action: create_session_file

session_end:
  auto_triggers:
    - skill: session-logger
      action: update_session_file

スキルでのフック形式

スキルに自動トリガー機能を追加するには、フロントマターに次の内容を追加します。

---
name: my-skill
description: Skill description
allowed-tools: Read, Write, Edit
hooks:
  before_start:
    - trigger: session-logger
      mode: auto
      context: "Start {skill_name}"
  after_complete:
    - trigger: self-improving-agent
      mode: background
    - trigger: session-logger
      mode: auto
  on_error:
    - trigger: self-improving-agent
      mode: background
---

実装ガイド

スキルがワークフローを完了したとき：

1. 自身のフロントマターの hooks を確認します（before_start、after_complete、on_error、on_progress）
2. 各フックについて：
   • mode: auto の場合、ホストランタイムがサポートしているときに限り、リスクの低い後続処理を記録するか実行します
   • mode: background の場合、ブロックしない後続処理を記録します。永続ファイルをひそかに変更してはいけません
   • mode: ask_first の場合、トリガーする前にユーザーに確認します
   • condition: がある場合は、最初に条件を確認します
3. コンテキストを渡します トリガーされたスキルに

統合例

prd-planner が追加する内容

---
name: prd-planner
description: Creates PRDs using persistent file-based planning...
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, WebSearch
hooks:
  after_complete:
    - trigger: self-improving-agent
      mode: background
      context: "PRD created at {prd_file}"
    - trigger: session-logger
      mode: auto
      context: "PRD creation complete"
---

self-improving-agent では、明示的な検証ゲートと適用ゲートを使用します

---
name: self-improving-agent
description: Captures redacted candidates, validates them with evidence, and records only explicitly applied rules...
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
---

Claude の失敗フックは CLI アダプターによってインストールされ、移植可能なスキルメタデータとして宣言されるものではありません。このスキルの hooks の例は宣言的な意図を示すものであり、ホストアダプターが明示的に実装しない限り、機能しません。他のホストでは、文書化されたアダプターまたは手動での記録を使用してください。

create-pr が追加する内容

---
name: create-pr
description: Creates pull requests with bilingual documentation updates...
allowed-tools: Read, Write, Edit, Bash, Grep, AskUserQuestion
hooks:
  after_complete:
    - trigger: session-logger
      mode: auto
      context: "PR created: {pr_title}"
---

チェーンの可視化

┌──────────────┐
│ prd-planner  │
└──────┬───────┘
       │ after_complete
       ├──→ self-improving-agent (background)
       │         └──→ create-pr (ask_first)
       │                  └──→ session-logger (auto)
       └──→ session-logger (auto)

エラー修正チェーン

on_error:
  triggers:
    - skill: self-improving-agent
      mode: background
      context: "Error occurred in {skill_name}"
    - skill: session-logger
      mode: auto
      context: "Error captured for {skill_name}"

重要なルール

1. 無限ループを作らないでください - チェーンが必ず終了するようにします
2. 重要な操作の前に確認してください - PR、デプロイ、永続ファイルの変更には mode: ask_first を使用します
3. バックグラウンドタスク - ブロックしない分析や提案用アーティファクトには mode: background を使用します
4. コンテキストを渡してください - トリガーされるスキルには、関連するコンテキストを必ず含めます