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

Decisions: diagnosis-playbook-skills

Key Decisions

• Use "diagnosis playbook skills" as the canonical term: skill is the runtime loading unit, playbook is the diagnosis workflow content.
• Keep factual knowledge in knowledge_base/; skills contain workflow, evidence order, stop conditions, and report rules.
• Implement a project-local progressive disclosure mechanism first because local Maven cache did not confirm Java2AI skill hook package names.
• Keep Verifier unchanged so it only validates existing tool evidence.
• Do not persist read_skill as evidence in tool_invocation; diagnostic facts must still come from evidence tools.

Interface Impact

L2 internal interface:

• New SkillCatalogService.
• New ReadSkillTool.
• Chat/AIOps internal method tools include read_skill.
• No HTTP, DTO, database, or external response contract changes.

Verification

• mvn -q "-Dtest=SkillCatalogServiceTest,ChatServiceSequentialAgentTest,AiOpsServiceTest,DiagnosisTraceEvaluatorTest" test
• Result: passed.