mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-06 07:49:37 +08:00
f5e63fd06a
* @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator * @W-22252932 [Meta Skill] Skill Creator
110 lines
2.5 KiB
Markdown
110 lines
2.5 KiB
Markdown
---
|
|
name: <SKILL_NAME>
|
|
description: "<DESCRIPTION — 20+ words, <= 1024 chars, must contain 'use'. Include TRIGGER when and DO NOT TRIGGER when clauses.>"
|
|
license: LICENSE.txt has complete terms
|
|
metadata:
|
|
version: "1.0"
|
|
stage: Draft
|
|
---
|
|
|
|
# <Skill Title>
|
|
|
|
<1-3 sentence overview: what this skill does and why it exists.>
|
|
|
|
## Scope
|
|
|
|
- **In scope**: <what this skill handles>
|
|
- **Out of scope**: <what this skill does NOT handle — delegate to other skills>
|
|
|
|
---
|
|
|
|
## Required Inputs
|
|
|
|
Gather or infer before proceeding:
|
|
|
|
- <Input 1>: <description and how to obtain>
|
|
- <Input 2>: <description and how to obtain>
|
|
- <Input 3>: <description and how to obtain>
|
|
|
|
Defaults unless specified:
|
|
- <Default 1>
|
|
- <Default 2>
|
|
|
|
If the user provides a clear, complete request, generate immediately without unnecessary back-and-forth.
|
|
|
|
---
|
|
|
|
## Workflow
|
|
|
|
All steps are sequential. Do not skip or reorder. If blocked, stop and ask for missing context.
|
|
|
|
1. **<Step name>**
|
|
- <Action to take>
|
|
- <Expected outcome>
|
|
|
|
2. **Read the template** — load `assets/<template-file>` before generating.
|
|
|
|
3. **<Step name>**
|
|
- <Action to take>
|
|
- For <specific sub-topic>, read `references/<topic>.md`.
|
|
|
|
4. **<Step name>**
|
|
- <Action to take>
|
|
- Compare output against `examples/<example-file>`.
|
|
|
|
---
|
|
|
|
## Rules / Constraints
|
|
|
|
<!-- Short table. If > 15 rows, move extras to references/. -->
|
|
|
|
| Constraint | Rationale |
|
|
|-----------|-----------|
|
|
| <Rule 1> | <Why this matters> |
|
|
| <Rule 2> | <Why this matters> |
|
|
|
|
---
|
|
|
|
## Gotchas
|
|
|
|
<!-- Short table — max 10 rows. Common pitfalls and fixes. -->
|
|
|
|
| Issue | Resolution |
|
|
|-------|------------|
|
|
| <Problem 1> | <How to fix it> |
|
|
| <Problem 2> | <How to fix it> |
|
|
|
|
---
|
|
|
|
## Output Expectations
|
|
|
|
Deliverables:
|
|
- <File 1>: `<path pattern>`
|
|
- <File 2>: `<path pattern>`
|
|
|
|
File structure follows the template in `assets/<template-file>`.
|
|
|
|
---
|
|
|
|
## Cross-Skill Integration
|
|
|
|
<!-- When to delegate to other skills. Remove section if not applicable. -->
|
|
|
|
| Need | Delegate to |
|
|
|------|-------------|
|
|
| <Need 1> | `<other-skill>` skill |
|
|
| <Need 2> | `<other-skill>` skill |
|
|
|
|
---
|
|
|
|
## Reference File Index
|
|
|
|
<!-- MANDATORY if any assets/, references/, or examples/ files exist. -->
|
|
<!-- Map every subdirectory file to the specific scenario that needs it. -->
|
|
|
|
| File | When to read |
|
|
|------|-------------|
|
|
| `assets/<template-file>` | Before generating — use as the starting structure |
|
|
| `references/<topic>.md` | When handling <specific scenario> |
|
|
| `examples/<example-file>` | To verify generated output matches expected format |
|