chore: restructure skills repo with new agents and skill bundles
- Add new skills: deep-dive, docs-rag, meta-creator, ppt-maker, sdlc - Add agent configs: g-assistent, meta-creator, sdlc with prompt files - Add reference docs for custom agents and skills specification - Add utility scripts: install-agents.sh, orchestrate.py, puml2svg.sh - Update README and commit-message skill config - Remove deprecated skills: codereview, python, testing, typescript - Add .gitignore
This commit is contained in:
@@ -0,0 +1,27 @@
|
||||
@startuml deep-dive-architecture
|
||||
skinparam componentStyle rectangle
|
||||
skinparam defaultFontName Arial
|
||||
skinparam backgroundColor #FAFAFA
|
||||
|
||||
package "deep-dive Skill" {
|
||||
component "SKILL.md\n(instructions + triggers)" as SKILL
|
||||
component "assets/\nreport-template.md\n(11 section skeletons)" as TMPL
|
||||
component "evals/evals.json" as EVALS
|
||||
}
|
||||
|
||||
package "Input Sources" {
|
||||
component "File path(s)\n(src/, docs/, manifests)" as FILES
|
||||
component "URL\n(fetched content)" as URL
|
||||
component "Pasted text /\nTopic name" as TEXT
|
||||
}
|
||||
|
||||
package "Output" {
|
||||
component "deep-dive-{subject}.md\n(structured report)" as REPORT
|
||||
}
|
||||
|
||||
SKILL --> TMPL : loads 11-section template
|
||||
SKILL --> FILES : reads source files
|
||||
SKILL --> URL : fetches content
|
||||
SKILL --> TEXT : analyzes inline
|
||||
SKILL --> REPORT : writes report
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 8.3 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 8.7 KiB |
@@ -0,0 +1,143 @@
|
||||
# Deep Dive Report: {SUBJECT}
|
||||
|
||||
> Generated by the `deep-dive` skill.
|
||||
> Date: {DATE}
|
||||
> Source: {SOURCE}
|
||||
|
||||
---
|
||||
|
||||
## 1. Overview
|
||||
|
||||
- **What it is**:
|
||||
- **Problem it solves**:
|
||||
- **Target users**:
|
||||
- **Design philosophy**:
|
||||
- **Tech stack**:
|
||||
|
||||
---
|
||||
|
||||
## 2. Architecture
|
||||
|
||||
{description of high-level structure}
|
||||
|
||||
```plantuml
|
||||
@startuml
|
||||
' Replace with actual components
|
||||
package "Layer A" {
|
||||
[Component 1]
|
||||
}
|
||||
package "Layer B" {
|
||||
[Component 2]
|
||||
[Component 3]
|
||||
}
|
||||
[Component 1] --> [Component 2] : protocol
|
||||
[Component 2] --> [Component 3] : protocol
|
||||
@enduml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Key Concepts & Terminology
|
||||
|
||||
**Term** — definition and why it matters in this system.
|
||||
|
||||
---
|
||||
|
||||
## 4. Data Model
|
||||
|
||||
{description of primary entities and relationships}
|
||||
|
||||
```plantuml
|
||||
@startuml
|
||||
entity EntityA {
|
||||
* id : UUID
|
||||
--
|
||||
field : Type
|
||||
}
|
||||
entity EntityB {
|
||||
* id : UUID
|
||||
--
|
||||
field : Type
|
||||
}
|
||||
EntityA ||--o{ EntityB : relationship
|
||||
@enduml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Core Flows & Sequences
|
||||
|
||||
### Flow 1: {Name}
|
||||
|
||||
{one-paragraph description}
|
||||
|
||||
```plantuml
|
||||
@startuml
|
||||
actor User
|
||||
participant "Component A" as A
|
||||
participant "Component B" as B
|
||||
|
||||
User -> A : action
|
||||
A -> B : call
|
||||
B --> A : response
|
||||
A --> User : result
|
||||
@enduml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Public API / Interface Reference
|
||||
|
||||
| Method | Path / Signature | Purpose | Key Params | Returns |
|
||||
|--------|-----------------|---------|------------|---------|
|
||||
| GET | /resource | description | param | type |
|
||||
|
||||
**Auth**: {mechanism}
|
||||
|
||||
---
|
||||
|
||||
## 7. Configuration & Deployment
|
||||
|
||||
**Key config options:**
|
||||
|
||||
| Variable | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `ENV_VAR` | value | what it controls |
|
||||
|
||||
**Run locally:**
|
||||
```bash
|
||||
# minimal steps
|
||||
```
|
||||
|
||||
**Deployment topology**: {description}
|
||||
|
||||
---
|
||||
|
||||
## 8. Extension & Integration Points
|
||||
|
||||
- {plugin/hook/middleware description}
|
||||
- {how to add a new feature}
|
||||
- {external integration patterns}
|
||||
|
||||
---
|
||||
|
||||
## 9. Observability
|
||||
|
||||
- **Logging**:
|
||||
- **Metrics**:
|
||||
- **Tracing**:
|
||||
- **Health check**:
|
||||
|
||||
---
|
||||
|
||||
## 10. Known Limitations & Trade-offs
|
||||
|
||||
- {limitation or trade-off}
|
||||
|
||||
---
|
||||
|
||||
## 11. Further Reading
|
||||
|
||||
1. **[Topic]** — why it matters and where to find it
|
||||
2. **[Topic]** — why it matters and where to find it
|
||||
3. **[Topic]** — why it matters and where to find it
|
||||
@@ -0,0 +1,23 @@
|
||||
@startuml deep-dive-workflow
|
||||
skinparam defaultFontName Arial
|
||||
skinparam backgroundColor #FAFAFA
|
||||
|
||||
actor Developer
|
||||
participant "deep-dive\nSkill" as SKILL
|
||||
participant "Input Source" as SRC
|
||||
participant "report-template.md" as TMPL
|
||||
|
||||
Developer -> SKILL : "deep dive into X"\n(files / URL / topic / text)
|
||||
SKILL -> SRC : read files / fetch URL / analyze text
|
||||
SRC --> SKILL : raw material
|
||||
|
||||
SKILL -> TMPL : load 11-section template
|
||||
SKILL -> SKILL : analyze architecture,\ndata model, flows, APIs
|
||||
|
||||
loop each relevant section
|
||||
SKILL -> SKILL : generate PlantUML diagram\n(component / ER / sequence)
|
||||
SKILL -> SKILL : fill section content
|
||||
end
|
||||
|
||||
SKILL --> Developer : deep-dive-{subject}.md
|
||||
@enduml
|
||||
Reference in New Issue
Block a user