Update sm-flow workflow docs

2026-07-06 09:15:51 +08:00
parent 6ccfd33ec5
commit 3e5c6a159c
20 changed files with 1645 additions and 61 deletions
@@ -0,0 +1,23 @@
+# 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.