autosnippet/skills/autosnippet-structure/SKILL.md

Extract code patterns into a knowledge base for AI coding assistants

---
name: autosnippet-structure
description: Discover project structure (targets, files, dependency graph) and browse the knowledge graph (relations between Recipes). Use when the user asks about module structure, project targets, dependency relationships, or knowledge graph navigation.
---

# AutoSnippet — Structure & Dependencies & Knowledge Graph

Use this skill when the user asks about **project structure**, **module targets**, **dependency graph**, or **knowledge graph relationships**.

---

## Project Structure Tools

| Tool | Purpose | Key Input |
|------|---------|-----------|
| `autosnippet_structure(operation=targets)` | List all module Targets (file count, language stats, inferred role) | `includeSummary` |
| `autosnippet_structure(operation=files)` | Get source files for a Target | `targetName` (required) |
| `autosnippet_structure(operation=metadata)` | Target metadata (dependencies, package info, graph edges) | `targetName` (required) |

### Workflow
1. `targets` → see all Targets with roles
2. `files` → drill into specific Target
3. `metadata` → get dependencies and relations

---

## Knowledge Graph Tools

Captures **relationships between Recipes** (dependencies, extensions, conflicts, etc.).

| Tool | Purpose | Key Input |
|------|---------|-----------|
| `autosnippet_graph(operation=query)` | Get all relations for a Recipe node | `nodeId`, `relation`, `direction` |
| `autosnippet_graph(operation=impact)` | Impact analysis: downstream dependencies | `nodeId`, `maxDepth` |
| `autosnippet_graph(operation=path)` | Shortest path between two Recipes (BFS) | `fromId`, `toId` |
| `autosnippet_graph(operation=stats)` | Global graph statistics | — |

### When to use
- "修改这个 Recipe 会影响什么？" → `impact`
- "这两个模块有什么关联？" → `path`
- "知识图谱统计" → `stats`

---

## Dependency Structure File

SPM dependency structure: `AutoSnippet/AutoSnippet.spmmap.json`
- Run `asd spm-map` to refresh (supports SPM / Node / Go / JVM / Python / Dart / Rust)

---

## Related Skills

- **autosnippet-recipes**: Recipe content used as project standards
- **autosnippet-create**: After understanding structure, submit knowledge candidates