SuperBizAgent-java/devflow/projects/2026-07-05-diagnosis-playbook-skills/brief.md

Brief: diagnosis-playbook-skills

Background

The MVP Agent has trace persistence, evidence tools, verifier gates, and fixed diagnosis eval cases, but scenario-specific diagnosis procedures were still embedded in broad prompts and knowledge-base documents.

Goal

Introduce versionable diagnosis playbook skills that agents can discover from a compact catalog and read on demand through a read_skill tool.

Scope

• Six initial diagnosis playbooks: payment timeout, MySQL connection pool, Redis timeout, slow response, JVM memory risk, and AIOps alert.
• Classpath skill catalog loader.
• read_skill Spring AI tool.
• Prompt catalog injection for Chat and AIOps Planner/Executor paths.
• Focused tests.

Non-goals

• No external API or database schema changes.
• No replacement of lookup_knowledge.
• No Verifier skill loading.
• No direct dependency on Java2AI SkillsAgentHook until local package names are verified.

Scale

standard

OpenSpec

openspec/changes/diagnosis-playbook-skills/