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,32 @@
+# 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/`