AgentSkillsCN

steering-matcher

根据引导文件的 glob 模式匹配文件路径，以确定适用的引导方针。当编排器需要根据正在修改的文件，注入具备情境感知的引导建议时，请使用此功能。

SKILL.md
--- frontmatter
name: steering-matcher
description: Match file paths against steering file glob patterns to determine applicable steering guidance. Use when orchestrator needs to inject context-aware guidance based on files being modified.
license: MIT
agents:
  - orchestrator
metadata:
version: 1.0.0
model: claude-haiku-4-5

Steering File Matcher Skill

Purpose

This skill helps orchestrator determine which steering files to inject into agent context based on the files being modified.

  • •Match file paths against glob patterns in steering file front matter
  • •Return applicable steering files sorted by priority
  • •Enable token-efficient context injection (30%+ savings)

When to Use

Invoke this skill when you need to:

  • •Determine which steering guidance applies to a task
  • •Inject context-aware guidance into agent prompts
  • •Optimize token usage by scoping guidance to relevant files
  • •Match files against applyTo patterns in steering files

Quick Usage

Using Get-ApplicableSteering.ps1 Script

The script in .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 handles pattern matching.

powershell
# Match files against steering patterns
$files = @(
    "src/claude/analyst.md",
    ".agents/security/TM-001-auth-flow.md"
)

$steering = pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 `
    -Files $files `
    -SteeringPath ".agents/steering"

# Output: Array of hashtables with Name, Path, ApplyTo, Priority
foreach ($s in $steering) {
    Write-Host "Matched: $($s.Name) (Priority: $($s.Priority))"
}

Workflow Integration

This skill integrates with the orchestrator workflow:

  1. •Task Analysis: Orchestrator identifies files affected by task
  2. •Pattern Matching: Use this skill to find applicable steering
  3. •Context Injection: Include matched steering in agent prompt
  4. •Token Optimization: Only inject relevant guidance

Standard Orchestrator Workflow

powershell
# 1. Identify files from task
$filesAffected = @(
    "src/claude/security.md",
    ".agents/security/SR-001-oauth-review.md"
)

# 2. Get applicable steering
$applicableSteering = pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 `
    -Files $filesAffected

# 3. Inject into agent context
# "Relevant steering: agent-prompts.md (Priority 9), security-practices.md (Priority 10)"

Implementation

See Get-ApplicableSteering.ps1 for the PowerShell implementation.

Testing

Run Pester tests to verify pattern matching:

powershell
Invoke-Pester .claude/skills/steering-matcher/tests/Get-ApplicableSteering.Tests.ps1

Related