feat: archive zoo_backup for home sync
This commit is contained in:
Patrick Plate
@@ -0,0 +1,161 @@
|
||||
# Skill: domain-lookup
|
||||
|
||||
Structured domain knowledge search across all PAISY knowledge sources.
|
||||
|
||||
## Invoked by
|
||||
|
||||
Any mode (📋 Planner, ❓ Ask, 🔍 Reviewer, 💻 Code)
|
||||
|
||||
## Required Inputs
|
||||
|
||||
| Input | Source | Example |
|
||||
|-------|--------|---------|
|
||||
| `TOPIC` | Domain topic or question | `"EuBP Archivierung"`, `"DSAK Änderungserkennung"`, `"Fehlzeiten DBFZ"` |
|
||||
| `CONTEXT` | Additional context (optional) | `"for ESIDEPAISY-12081"`, `"Oracle migration syntax"` |
|
||||
|
||||
## Output
|
||||
|
||||
- Structured summary with sources cited
|
||||
- New findings stored in BigMind for future reuse
|
||||
|
||||
## Steps
|
||||
|
||||
### 1. Search BigMind facts
|
||||
|
||||
```python
|
||||
memory_search_facts("<2-3 keywords from TOPIC>")
|
||||
```
|
||||
|
||||
FTS5 rule: AND-matches every token. Max 3 short keywords. Long queries return 0 results.
|
||||
|
||||
### 2. Search BigMind chunks
|
||||
|
||||
```python
|
||||
memory_search_chunks("<2-3 keywords from TOPIC>")
|
||||
```
|
||||
|
||||
Check for past decisions, code snippets, or session notes related to the topic.
|
||||
|
||||
### 3. Semantic search (if 1+2 return nothing)
|
||||
|
||||
```python
|
||||
memory_search_semantic("<natural language description of what you're looking for>")
|
||||
```
|
||||
|
||||
Use this when keyword search fails — it matches by meaning, not exact words.
|
||||
|
||||
### 4. Check ADP Docs Wiki index
|
||||
|
||||
```python
|
||||
memory_search_facts("<topic> adpdocs")
|
||||
```
|
||||
|
||||
Known page IDs (from BigMind `adpdocs-index` facts):
|
||||
- EAU → 25123 | EuBP → 26666 | DaBPV → 27242 | DSBD → 26747 | DSAK → 26748
|
||||
- DSVV → 18714 | RvBEA → 21174 | EEL → 2724 | ELStAM → 2737 | DEÜV → 5876
|
||||
- Programmabläufe → 15201 | Einzelaufrufe BATCH → 15250 | Umgebungsvariablen → 22767
|
||||
- PAISY verwalten → 15180 | Datenbanken verwalten → 15184 | Fehlermeldungen → 15196
|
||||
|
||||
### 5. Fetch Wiki page (if page ID known)
|
||||
|
||||
```python
|
||||
set-wiki(uri="mcp://wikis/adpdocs.de.adp.com")
|
||||
get-page(title="<page title>")
|
||||
```
|
||||
|
||||
### 6. Search Wiki (if page ID not known)
|
||||
|
||||
```python
|
||||
set-wiki(uri="mcp://wikis/adpdocs.de.adp.com")
|
||||
search-page(query="<domain keywords>")
|
||||
```
|
||||
|
||||
Or browse by category:
|
||||
```python
|
||||
get-category-members(category="Meldeverfahren")
|
||||
```
|
||||
|
||||
Key categories: `Meldeverfahren`, `Verwalterhandbuch`, `Batchabläufe`, `Client Server (CS)`, `PAISYadvanced`, `Installationshandbuch für Windows und UNIX`
|
||||
|
||||
### 7. Search Confluence
|
||||
|
||||
```python
|
||||
search_confluence_by_cql("text ~ '<topic keywords>' AND space = 'ESIDEPAISY'")
|
||||
```
|
||||
|
||||
Or broader:
|
||||
```python
|
||||
search_confluence_by_cql("text ~ '<topic keywords>'")
|
||||
```
|
||||
|
||||
### 8. Search Bitbucket (for code-level context)
|
||||
|
||||
```python
|
||||
# Check recent PRs for related changes
|
||||
list_prs_for_repository(project_key="ESIDEPAISY", repo_slug="paisy", status="MERGED")
|
||||
|
||||
# Or find a specific file
|
||||
find_file(project_key="ESIDEPAISY", repo_slug="paisy", file_path="<path>", branch="current")
|
||||
```
|
||||
|
||||
### 9. Web scraper (last resort only)
|
||||
|
||||
```python
|
||||
webscraper_fetch(url="<relevant URL>")
|
||||
```
|
||||
|
||||
**Only use if all previous sources returned nothing.** Never skip to webscraper if BigMind or Wiki MCP can answer.
|
||||
|
||||
### 10. Store new findings
|
||||
|
||||
After finding useful information, immediately store it:
|
||||
|
||||
```python
|
||||
# For Wiki page discoveries
|
||||
memory_store_fact(
|
||||
category="adpdocs-index",
|
||||
fact=f"ADP Docs Wiki: '<page title>' (Page ID: {page_id}) — <brief description of content>"
|
||||
)
|
||||
|
||||
# For domain knowledge
|
||||
memory_store_fact(
|
||||
category="codebase",
|
||||
fact=f"<domain topic>: <key finding>. Source: <where it came from>"
|
||||
)
|
||||
|
||||
# For detailed findings
|
||||
memory_append_chunk(
|
||||
session_id=SESSION_ID,
|
||||
content=f"Domain lookup for '{TOPIC}':\n<detailed findings with sources>",
|
||||
flag_reason="domain knowledge"
|
||||
)
|
||||
```
|
||||
|
||||
## Expected Output
|
||||
|
||||
- Structured answer with cited sources
|
||||
- Priority: BigMind facts → BigMind chunks → ADP Docs Wiki → Confluence → Bitbucket → webscraper
|
||||
- New findings stored in BigMind for future lookups
|
||||
|
||||
## Error Handling
|
||||
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
| BigMind FTS returns 0 | Reduce to 2 keywords, try synonyms, then use semantic search |
|
||||
| Wiki page not found | Try `search-page` with different keywords, or browse category members |
|
||||
| Confluence returns nothing | Broaden CQL query, remove space filter |
|
||||
| All sources empty | Report "no information found" honestly — don't fabricate answers |
|
||||
| Wiki connection error | Ensure `set-wiki` was called first with correct URI |
|
||||
|
||||
## Search Strategy Tips
|
||||
|
||||
- **German domain terms** often work better than English: `Fehlzeiten` not `absences`, `Lohnkonto` not `payroll account`
|
||||
- **Abbreviations** are common: `DSAK`, `DSBD`, `DSVV`, `EuBP`, `DaBPV`, `RvBEA`, `EEL`
|
||||
- **PAISY program names** are searchable: `PAI022`, `PAI028`, `PAI030`, `PAIBATCH`
|
||||
- **Error codes** from PAISY start with `F;` — search for the specific code in Wiki Fehlermeldungen page (15196)
|
||||
|
||||
## Language
|
||||
|
||||
- Search queries: match the source language (German for Wiki/Confluence, English for code)
|
||||
- Output summary: match the user's language
|
||||
- Stored facts: English (BigMind convention)
|
||||
Reference in New Issue
Block a user