← Back to AI

AI Agent Skills

The AgentSkills Maturity Model — from semantic contracts to verification and release

Phase 1: Semantic Contracts

Days 1–4 · Spec, YAML, cosine routing, RFC 2119, PRS exemplars

Explore Phase 1 →

Phase 2: Deterministic Tooling

Days 5–7 · CLI runners, stderr loops, AST extraction

Explore Phase 2 →

Phase 3: Enterprise Composition

Days 8–10 · References, token budgets, polyglot capstone

Explore Phase 3 →

Phase 4: Verification & Release

Days 11–12 · Golden evals and cross-host distribution

Explore Phase 4 →

The AgentSkills Maturity Model

Phase 1: Semantic Contracts

Days 1–4
  • Spec & YAML Frontmatter
  • Cosine Routing & Triggers
  • RFC 2119 Negative Invariants
  • PRS Few-Shot Exemplars

Phase 2: Deterministic Tooling

Days 5–7
  • Standalone CLI Runners
  • Stderr Self-Correction Loop
  • AST & Local Project Extraction

Phase 4: Verification & Release

Days 11–12
  • Golden Benchmark Eval Suites
  • Cross-Host Distribution
  • Claude Code / Copilot / Cursor

Phase 3: Enterprise Composition

Days 8–10
  • References & Token Budgeting
  • Dynamic Exemplar Mining
  • Capstone: Polyglot Spring/MockK

Phase 1: Specification Anatomy & Semantic Routing

สร้าง In-Context Boundary, Metadata Validation และ Trigger Control เพื่อคุม Probabilistic Space ของ LLM ก่อนเริ่มเขียนโค้ด. เปิด Phase 1 →

Day 1

agentskills Anatomy & YAML Frontmatter

โครงสร้างไดเรกทอรีมาตรฐาน (SKILL.md, scripts/, references/, assets/), Metadata Schema Validation และ Lazy Hydration ใน Host Agents

Artifacts: .github/skills/spring-boot-unit-tester/SKILL.md, scripts/verify-skill-spec.sh · Deliverable: Production Frontmatter Metadata Spec พร้อม Host Parser Verification Harness

เปิดบทเรียน →
Day 2

Trigger Engineering & Semantic Routing

Embedding Cosine Similarity, Threshold τ และ Dual-Barrier Negative Triggers เพื่อขจัด False Activations และ Collision

Artifacts: Dual-Barrier Routing, scripts/eval-triggers.sh · Deliverable: Precision Semantic Trigger Spec พร้อม JSON Fixture Evaluation Harness

เปิดบทเรียน →
Day 3

In-Context Constraints & Anti-Patterns

RFC 2119 (MUST NOT, SHALL NOT) สำหรับ Negative Boundary Enforcement และ Invariant Replacement Tables

Artifacts: Architectural Invariants, scripts/verify-constraints.sh · Deliverable: Non-Negotiable Boundary Spec สกัดกั้น Mockito และ @SpringBootTest

เปิดบทเรียน →
Day 4

PRS Few-Shot Exemplar Engineering

Pattern-Reasoning-Solution ใน Markdown เพื่อตรึง Attention Weights และกันการเดา syntax ผิดประเภท

Artifacts: Coroutines & MockK PRS, scripts/verify-exemplar-syntax.sh · Deliverable: Canonical PRS Exemplars ครอบคลุม runTest, coEvery, confirmVerified

เปิดบทเรียน →

Phase 2: Deterministic Tooling & Sandbox Scripts

ย้ายจาก LLM Self-Check ไปสู่ Executable Machine Interface บน Host CLI. เปิด Phase 2 →

Day 5

The scripts/ Directory & CLI Execution

Standalone Verification Runners ภายใต้ POSIX, Zero-Dependency และ Non-Interactive CLI Mode

Artifacts: scripts/run-unit-tests.sh, Tool Invocation Schema · Deliverable: Host-Executable Shell Runner ผสาน Maven Batch Flag และ Regex Pre-filter

เปิดบทเรียน →
Day 6

Sandboxed Execution & Stderr Triage

Exit Code Matrix (0, 1, 2, 3, 4, 124), Stream Isolation และ Stderr Triage Engine ในงบ < 350 tokens

Artifacts: scripts/triage-test-failure.py, scripts/run-unit-tests.sh · Deliverable: Closed-Loop Remediation Pipeline พร้อม 45s Timeout Guard

เปิดบทเรียน →
Day 7

AST & Static Analysis Scripts

สกัด Live Target Class Skeleton (Tree-sitter/Regex/AST) เพื่อป้อน Constructor และ Method Signatures ก่อนเจนโค้ด

Artifacts: scripts/extract-target-ast.py, scripts/inspect-class-context.sh · Deliverable: Zero-Dependency AST Context Harvester สำหรับ Public API Contract

เปิดบทเรียน →

Phase 3: Reference Architecture & Complex Skills

จัดการ Token Economy และประกอบ Subsystem เป็น Enterprise-Grade Skill บน codebase ขนาดใหญ่. เปิด Phase 3 →

Day 8

The references/ Layer & Context Budgeting

Dynamic Progressive Disclosure: แยก Schemas, DTOs และ API Contracts ไปที่ references/ เพื่อตัด Context Bloat

Artifacts: references/billing-domain-contracts.json, scripts/query-reference.sh · Deliverable: Modular On-Demand Reference Architecture พร้อม CLI Slice Querying

เปิดบทเรียน →
Day 9

Dynamic Exemplar Mining

Heuristic Quality Scoring (Q) เพื่อขุด Best Practice Tests ใน repo มาเป็น Few-Shot สด

Artifacts: scripts/harvest-exemplars.py, Harvesting Protocol · Deliverable: Automated Exemplar Mining Engine พร้อม Anti-Pattern Exclusion Filter

เปิดบทเรียน →
Day 10

Capstone: Polyglot Backend Unit Test Skill

รวม Phase 1–3 เป็น End-to-End Enterprise Skill Package สำหรับระบบ Backend การเงินจริง

Artifacts: Complete spring-boot-unit-tester/ package · Deliverable: Production-Grade Agent Skill ติดตั้งพร้อมใช้ใน Codebase

เปิดบทเรียน →

Phase 4: Verification, Evaluation & Distribution

วัดความแม่นยำเชิงตัวเลข และ transpile ออกสู่ IDEs/terminals ระดับองค์กร. เปิด Phase 4 →

Day 11

Golden Benchmark Suites for Skills

Benchmark Harness วัด Confusion Matrix (Precision ≥ 95%, Recall ≥ 90%) และ Pass@1 ผ่าน CI

Artifacts: evals/datasets/trigger-golden-suite.json, evals/run-skill-evals.py, .github/workflows/skill-ci-gate.yml · Deliverable: Quantitative Evaluation Suite พร้อม GitHub Actions gate

เปิดบทเรียน →
Day 12

Cross-Host Packaging & Distribution

Universal Transpiler แปลง SKILL.md สู่ GitHub Copilot, Cursor Rules (.mdc) และ Claude Code (CLAUDE.md)

Artifacts: tools/package-cross-host.py, .cursor/rules/spring-boot-unit-tester.mdc, CLAUDE.md · Deliverable: Universal Shim Compiler สำหรับทุก Host Engine

เปิดบทเรียน →