bollwerk/.github/skills/knowledge-conduit/SKILL.md

67 lines
3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Knowledge Conduit
Automatische Erkennung und Übertragung von Verbesserungen am KI-Tooling (Skills, Agents, Prompts, Instructions) zwischen Dev+AI-Teams.
## Trigger-Phrasen
`knowledge conduit`, `conduit`, `transfer`, `improvements übertragen`, `capabilities synchronisieren`, `kc extract`, `kc transfer`
## Konzept
Der Knowledge Conduit erkennt Verbesserungen an KI-Konfigurationsdateien über Git-History, destilliert sie in übertragbare "Insights" und schlägt konkrete Patches für andere Repos vor.
**Begriffe:**
- **Capability** Ein Skill, Agent, Prompt(-Verbund) oder Instructions-File
- **Conduit** Der Kanal, durch den Wissen zwischen Dev+AI-Teams fließt
- **Improvement** Ein Git-Commit-Delta an einer Capability
- **Insight** Destilliertes, bewertetes Improvement (bereinigt, klassifiziert, gescored)
- **Transfer** Konkreter Änderungsvorschlag für ein Ziel-Repo
## Pipeline
| Phase | Tool | Input → Output |
| --------------- | ----------------------- | ----------------------------------------------- |
| 1. Extraction | `kc-extract.py` | Git-History → `raw-improvements.md` |
| 2. Distillation | `kc-distill.prompt.md` | `raw-improvements.md``distilled-insights.md` |
| 3. Transfer | `kc-transfer.prompt.md` | `distilled-insights.md` + Ziel-Repo → Patches |
## Usage
```
/knowledge-conduit
```
Der Router-Prompt fragt nach Quell-Repo und Zeitspanne, dann orchestriert er alle 3 Phasen.
## Dateien
| Datei | Ort | Zweck |
| ----------------------------- | ----------------------------------- | -------------------------------------------- |
| `SKILL.md` | `.github/skills/knowledge-conduit/` | Diese Dokumentation |
| `kc-extract.py` | `.github/skills/knowledge-conduit/` | Phase 1: Git-Scanning + Capability-Erkennung |
| `knowledge-conduit.prompt.md` | `.github/prompts/` | Orchestrator (Router für alle 3 Phasen) |
| `kc-distill.prompt.md` | `.github/prompts/` | Phase 2: Klassifizierung + Scoring |
| `kc-transfer.prompt.md` | `.github/prompts/` | Phase 3: Transfer-Vorschläge für Ziel |
| `Concept.md` | `.github/knowledge-conduit/` | Vollständiges Konzept-Dokument |
## Capability-Erkennung
Pfade werden automatisch zu Capability-Keys aufgelöst:
```
.github/skills/forgejo-tickets/SKILL.md → skill/forgejo-tickets
.github/agents/code-reviewer.agent.md → agent/code-reviewer
.github/prompts/nextstep.prompt.md → prompt/nextstep (inkl. Sub-Prompts)
.github/copilot-instructions.md → instructions/copilot-instructions
```
## Scope
Folgende Pfade bilden die KI-Tooling-Landschaft:
- `.github/skills/**`
- `.github/agents/**`
- `.github/prompts/**`
- `.github/copilot-instructions.md`
- `.github/*.instructions.md`