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:
Team
2026-04-18 13:07:46 +08:00
parent 72f16d26b8
commit c0d14c6ac1
74 changed files with 5726 additions and 324 deletions
+82
View File
@@ -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
![Architecture](assets/deep-dive-architecture.svg)
## Workflow
![Workflow](assets/deep-dive-workflow.svg)
## 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
```