initial checkin

This commit is contained in:
2026-09-29 09:40:32 +00:00
commit 50b7ccd65f
34 changed files with 11874 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
# AI Skill Prompt Files — Index
15 prompt files for all LLM-using AI skills. Each file contains: system prompt, user prompt template
with `{{variable}}` placeholders, output schema, confidence scoring guidance, and examples.
Regex-only skills (SKILL-001 Classifier, SKILL-008 MismatchDetector, SKILL-008a VersionDetector)
do not need prompt files — they use pure pattern matching.
## Prompt File Inventory
### Tier 1 — High Impact
| File | Skill | Model | Notes |
|---|---|---|---|
| `SKILL-001a-DocumentScopeDetector.md` | Scope detection (customer/fair/job) | gpt-4o-mini | Receives upload context + entity IDs |
| `SKILL-002-ContactExtractor.md` | Contact extraction | gpt-4o-mini | Regex primary, LLM fallback |
| `SKILL-003-DeadlineDetector.md` | Deadline detection (German focus) | gpt-4o-mini | Regex primary, LLM fallback for context |
| `SKILL-004-ChecklistGenerator.md` | Action item extraction | gpt-4o-mini | German output, 20-item limit, source quoting |
| `SKILL-004b-MultiFairDetector.md` | Multi-fair detection | gpt-4o-mini | Returns fair array from consultation docs |
| `SKILL-004c-BudgetExtractor.md` | Budget/cost extraction | gpt-4o-mini | Regex primary, LLM for context classification |
| `SKILL-004d-PainPointSummarizer.md` | Pain points + expectations | gpt-4o-mini | German output, structured summary |
### Tier 2 — Validation
| File | Skill | Model | Notes |
|---|---|---|---|
| `SKILL-005-StandDataExtractor.md` | Stand dimension extraction | gpt-4o | Handles multi-booth specs + hall info |
| `SKILL-006-ConfirmationParser.md` | Booking confirmation parsing | gpt-4o-mini | Service-type detection, discrepancy flagging |
| `SKILL-007-BrandConsistencyChecker.md` | Brand vs. photo comparison | gpt-4o (vision) | Compares brandbook palette to booth photos |
### Tier 3 — Enhancement
| File | Skill | Model | Notes |
|---|---|---|---|
| `SKILL-009-MaterialListExtractor.md` | Material/furniture extraction | gpt-4o-mini | Categorizes items into 4 types, German names |
| `SKILL-009a-LeadMagnetIdeator.md` | Activation idea generation | gpt-4o | Creative output, temperature 0.7, 3 ideas |
| `SKILL-010-AcceptanceReportGenerator.md` | Acceptance report generation | gpt-4o | Structured JSON for Gotenberg PDF template |
| `SKILL-011-SetupProgressAnalyzer.md` | Photo progress comparison | gpt-4o (vision) | Detects construction changes, suggests checklist |
| `SKILL-012-WeeklyProtocolSummarizer.md` | Protocol summarization | gpt-4o-mini | German output, timeline-friendly structure |
## Usage
Each prompt file is a Markdown document containing:
1. **Front matter** (YAML): skill ID, name, tier, model, temperature, response format
2. **System Prompt**: instructions for the LLM
3. **User Prompt Template**: the message sent to the LLM, with `{{variable}}` placeholders
that are populated at runtime by the PHP handler with extracted document text,
entity context, and metadata
4. **Output Schema**: the expected JSON structure
5. **Example** (some files): sample input/output pairs for testing
These files are the canonical prompt source. The PHP handler (`AiSkillTriggerListener`)
loads the prompt, replaces `{{placeholders}}` with runtime data, sends to the LLM API,
and parses the response against the schema.