init: common-skills v1

2026-03-26 21:00:51 +08:00
commit 264dacf157
16 changed files with 859 additions and 0 deletions
@@ -0,0 +1,78 @@
+---
+name: docs-rag
+description: >
+  3GPP technical specification document retrieval and index management. Use when
+  the user asks about 3GPP specs, Release 19 features, mission critical services,
+  ambient IoT, ISAC, UAV/drone support, network sharing, SNPN interconnect,
+  traffic steering/split, or any question answered by the local docs/ directory.
+  Also use when the user wants to update, rebuild, or refresh the docs index,
+  or when new documents have been added to the docs/ directory.
+---
+
+# 3GPP Docs RAG Skill
+
+Lightweight retrieval-augmented generation over the local `docs/` directory of
+3GPP Release 19 specifications and study reports.
+
+## Directory Layout
+
+```
+.kiro/skills/docs-rag/
+├── SKILL.md          ← this file
+├── data/
+│   └── index.json    ← document index (spec, title, keywords, summary, file path)
+└── evals/
+    └── evals.json    ← evaluation cases
+scripts/
+└── build_index.py    ← index builder / updater
+```
+
+## Maintaining the Index
+
+**Full rebuild** (after adding many new docs):
+```bash
+python scripts/build_index.py
+```
+
+**Incremental update** (add new docs or refresh changed ones):
+```bash
+python scripts/build_index.py --update
+```
+
+The script scans `docs/` for `.docx` / `.doc` files, extracts the scope section
+and header metadata, and writes `data/index.json`. Unchanged files (same mtime)
+are skipped in `--update` mode.
+
+## How to Answer Queries
+
+1. Read `.kiro/skills/docs-rag/data/index.json`.
+2. Match the user's query against `keywords` and `summary` fields.
+3. If the summary is sufficient, answer directly from it.
+4. If deeper detail is needed, read the actual file at the `file` path.
+
+## Document Index Summary
+
+| Spec | Title | Key Topics |
+|------|-------|------------|
+| TS 22.280 | Mission Critical Services Common Requirements | MCPTT, MCData, MCVideo, public safety |
+| TS 22.369 | Service Requirements for Ambient IoT | battery-less IoT, energy harvesting |
+| TR 22.837 | Integrated Sensing and Communication (ISAC) | NR sensing, V2X, UAV, smart city |
+| TR 22.840 | Study on Ambient Power-enabled IoT | ambient IoT, 5G service requirements |
+| TR 22.841 | Traffic Steer/Switch/Split over Dual 3GPP Access | multi-access, PLMN, satellite NR |
+| TR 22.843 | UAV Phase 3 | drone, flight management, UTM, QoS |
+| TR 22.848 | Interconnect of SNPN | private network, SNPN, PLMN interconnect |
+| TR 22.851 | Network Sharing Feasibility Study | NG-RAN sharing, mobility, charging |
+
+## Retrieval Rules
+
+- **Keyword match**: scan `keywords` array for overlap with user query terms.
+- **Semantic match**: if no keyword hit, check `summary` for conceptual relevance.
+- **Multi-doc**: return all relevant docs when the query spans multiple topics.
+- **No match**: say so clearly rather than hallucinating.
+
+## Answer Format
+
+Always cite the spec number and version:
+
+> According to **3GPP TR 22.843 V19.2.0**, the 5G system supports UAV flight path
+> recommendation and inflight monitoring based on network QoS information.