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,82 @@
|
||||
# deep-dive
|
||||
|
||||
A Kiro agent skill that analyzes codebases, documentation, APIs, or product specs and produces a structured technical report for developers.
|
||||
|
||||
## Architecture
|
||||
|
||||

|
||||
|
||||
## Workflow
|
||||
|
||||

|
||||
|
||||
## What it does
|
||||
|
||||
Given any technical material — source code, README, OpenAPI spec, pasted docs, or just a topic name — the agent produces a detailed Markdown report covering:
|
||||
|
||||
- System overview and design philosophy
|
||||
- Architecture diagram (PlantUML)
|
||||
- Key concepts & terminology glossary
|
||||
- Data model with ER diagram
|
||||
- Core flows with sequence diagrams
|
||||
- API / interface reference
|
||||
- Configuration & deployment notes
|
||||
- Extension and integration points
|
||||
- Observability (logging, metrics, tracing)
|
||||
- Known limitations and trade-offs
|
||||
- Actionable further reading recommendations
|
||||
|
||||
## When to Use
|
||||
|
||||
Activate this skill when a developer says things like:
|
||||
- "help me understand this codebase"
|
||||
- "deep dive into X"
|
||||
- "onboard me to this service"
|
||||
- "how does X work"
|
||||
- "analyze this doc / spec"
|
||||
- "详细分析 X 架构 / 部署流程"
|
||||
|
||||
## Accepted Inputs
|
||||
|
||||
| Input type | Example |
|
||||
|---|---|
|
||||
| File path(s) | `src/`, `docs/api.yaml`, `main.go` |
|
||||
| Pasted text | README content, architecture notes |
|
||||
| Topic name | "Kafka consumer groups", "Redis internals" |
|
||||
| URL | Link to documentation or spec |
|
||||
|
||||
When given a directory, the skill automatically scans `README*`, `docs/`, entry-point files, and package manifests.
|
||||
|
||||
## Example Prompts
|
||||
|
||||
```
|
||||
Give me a deep dive on the Kafka consumer group rebalancing protocol.
|
||||
```
|
||||
|
||||
```
|
||||
Analyze this FastAPI service and explain how it works: [paste README]
|
||||
```
|
||||
|
||||
```
|
||||
Help me understand the worker pool in src/worker/pool.go
|
||||
```
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
skills/deep-dive/
|
||||
├── SKILL.md
|
||||
├── README.md # this file
|
||||
├── assets/
|
||||
│ ├── report-template.md
|
||||
│ ├── workflow.puml
|
||||
│ └── deep-dive-workflow.svg
|
||||
└── evals/
|
||||
└── evals.json
|
||||
```
|
||||
|
||||
## Evals
|
||||
|
||||
```bash
|
||||
python scripts/run_evals.py deep-dive
|
||||
```
|
||||
Reference in New Issue
Block a user