Files
SuperBizAgent-java/devflow/projects/2026-07-05-diagnosis-playbook-skills/decisions.md
T
2026-07-06 09:15:51 +08:00

24 lines
1.0 KiB
Markdown

# 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.