autosnippet 3.2.18 → 3.2.20

package/skills/autosnippet-guard/SKILL.md

@@ -1,122 +1,53 @@
 ---
 name: autosnippet-guard
-description: Guard checks code against project Recipe standards. Passive (// as:audit + watch) or active (MCP tool autosnippet_guard — auto-routes by code/files params). Use when the user wants to audit, lint, or verify code compliance.
+description: Guard checks code against project Recipe standards via MCP tool autosnippet_guard (auto-routes by code/files params). Use when the user wants to audit, lint, or verify code compliance.
 ---
 
 # AutoSnippet Guard — Code Compliance Checking
 
-> Self-check & Fallback: MCP 工具返回统一 JSON Envelope（{ success, errorCode?, message?, data?, meta }）。重操作前调用 `autosnippet_health`；失败时不在同一轮重试，转用静态上下文或缩小范围后再试。
-
 **Use this skill when**: The user wants to **check** whether code meets **project standards** (规范 / Audit / Guard / Lint).
 
 ---
 
-## Two Modes of Guard
-
-### Mode 1: Passive — `// as:audit` trigger (requires `asd watch` or `asd ui`)
-
-When the user wants **quick inline audit**:
-1. Add `// as:audit` (or `// as:audit keyword`) in the file
-2. Save the file → watch detects the save → runs AI review against Recipe standards
-3. Results output to terminal / notification
-
-**Recommendation wording**: "在文件中加 `// as:audit`，保存后 watch 会用知识库标准审查代码，结果输出到终端。"
-
-### Mode 2: Active — MCP tools (Agent-driven, no watch needed)
-
-Agent can directly invoke Guard checks via MCP:
-
-#### Single Code Check: `autosnippet_guard` (with `code` param)
-Check a code snippet against Guard rules. Best for quick inline checks.
+## MCP Tool: `autosnippet_guard`
 
+**Single code check** (`code` param):
 ```json
-{
-  "code": "URLSession.shared.dataTask(with: url) { ... }",
-  "language": "objc",
-  "filePath": "Sources/Network/OldAPI.m"
-}
+{ "code": "URLSession.shared.dataTask(with: url) { ... }", "language": "objc", "filePath": "Sources/Network/OldAPI.m" }
 ```
 
-Returns: List of violations with `{ ruleId, severity, message, line, pattern }`.
-
-**When to use**: 
-- User pastes code and asks "这段符合规范吗？"
-- Agent is reviewing code before suggesting changes
-- Quick single-file compliance check
-
-#### Multi-file Audit: `autosnippet_guard` (with `files[]` param)
-Batch audit multiple files against Guard rules. Results are automatically recorded to ViolationsStore (visible in Dashboard Guard page).
-
+**Multi-file audit** (`files[]` param):
 ```json
-{
-  "files": [
-    { "path": "/path/to/Sources/Network/APIClient.m" },
-    { "path": "/path/to/Sources/Network/RequestManager.m", "content": "..." }
-  ],
-  "scope": "project"
-}
+{ "files": [{ "path": "Sources/Network/APIClient.m" }, { "path": "Sources/Network/RequestManager.m" }], "scope": "project" }
 ```
 
-Returns: Per-file violation details with severity and suggestions.
-
-**When to use**:
-- User says "审查一下网络模块" / "检查这几个文件"
-- After batch code changes, verify compliance
-- Periodic module-level audit
+Returns violations with `{ ruleId, severity, message, line, pattern }`. Batch results auto-recorded to ViolationsStore.
 
 ---
 
 ## Guard Knowledge Source
 
-Guard uses the **same Recipe content** in `AutoSnippet/recipes/` as the standard:
-- **kind=rule** Recipes are enforced as Guard rules (severity: error/warning/info)
-- **kind=pattern** Recipes serve as best-practice references
-- Guard rules with `constraints.guards[].pattern` define regex patterns for automated detection
-- No separate config needed — Recipe IS the Guard standard
+Guard uses **Recipe content** as the standard — no separate config:
+- **kind=rule** → enforced as Guard rules (severity: error/warning/info)
+- **kind=pattern** → best-practice references
+- `constraints.guards[].pattern` → regex patterns for automated detection
 
 ---
 
-## MCP Tools for Guard
+## Agent Workflow
 
-| Tool | Purpose | Input |
-|------|---------|-------|
-| `autosnippet_guard` | Code Guard check (single or batch — auto-routed by params) | `code` for single, `files[]` for batch, `language`, `filePath`, `scope` |
-| `autosnippet_bootstrap` | Full project scan + Guard audit (no params, returns Mission Briefing) | — |
-| `autosnippet_knowledge(operation=list, kind=rule)` | List all Guard rules (kind=rule) | `limit`, `status`, `language`, `category` |
+### Quick Check ("检查这段代码")
+1. `autosnippet_guard` with code → present violations + fix suggestions
 
----
-
-## Typical Agent Workflow
-
-### Quick Check (user asks "检查这段代码")
-1. Call `autosnippet_guard` with the code
-2. Present violations to user with severity and fix suggestions
-3. If user adopts fixes, optionally `autosnippet_knowledge(operation=confirm_usage)` for the relevant Recipe
-
-### Module Audit (user asks "审查网络模块")
-1. Call `autosnippet_structure(operation=files)` to get file list
-2. Call `autosnippet_guard` with the file paths
-3. Summarize violations grouped by severity
-4. Suggest fixes based on Recipe standards
-
-### Project-wide Compliance
-1. Call `autosnippet_bootstrap` (no params) for full project scan
-2. Present high-severity findings first
+### Module Audit ("审查网络模块")
+1. `autosnippet_structure(operation=files)` → get file list
+2. `autosnippet_guard` with file paths → summarize by severity
 
----
-
-## Audit trigger syntax
-
-- `// as:audit` — audit entire file against all rules
-- `// as:audit keyword` — audit with specific keyword focus  
-- `// as:lint` — **deprecated**, use `// as:audit`
+### Project-wide
+1. `autosnippet_bootstrap` → full project scan including Guard audit
 
 ---
 
 ## Related Skills
 
-- **autosnippet-recipes**: Recipe content IS the Guard standard. Use for looking up what the standard says.
-- **autosnippet-intent**: General router; may route Guard-related intents here.
-- **autosnippet-analysis**: Deep project scan + Guard baseline via `autosnippet_bootstrap`.
-
-```
+- **autosnippet-recipes**: Recipe content IS the Guard standard

package/skills/autosnippet-recipes/SKILL.md

@@ -5,147 +5,65 @@ description: Provides this project's Recipe-based context to the agent. Recipes
 
 # AutoSnippet Recipe Context (Project Context)
 
-> Self-check and Fallback: MCP tools return unified JSON Envelope. Before heavy ops call `autosnippet_health`. On failure do not retry in same turn; use static context or narrow scope.
-
 This skill provides the agent with this project's context from AutoSnippet Recipes. Recipes are the project's standard knowledge base: code patterns, usage guides, and structured relations.
 
 ---
 
-## Core Rule: Agent Permission Boundary
-
-**Agent CANNOT directly produce or modify Recipes.** Agent's role is:
+## Knowledge Base Overview
 
-| Allowed | Forbidden |
-|---------|-----------|
-| Submit Recipe candidates (submit_candidate / submit_candidates / submit_draft_recipes) | Directly create Recipe |
-| Validate candidates (validate_candidate / check_duplicate) | Modify existing Recipe content |
-| Search/query Recipes (list_recipes / get_recipe / context_search / list_facts) | Publish/deprecate/delete Recipe |
-| Confirm usage (confirm_usage) - record adoption/application telemetry | Modify Recipe quality scores |
-| Enhance candidate info (add rationale/steps/codeChanges etc.) | Bypass candidate review to write to recipes/ |
+| Part | Location | Purpose |
+|------|----------|---------|
+| **Recipes** | `AutoSnippet/recipes/*.md` | Standard code patterns + usage guides; used for AI context, Guard, search |
+| **Snippets** | `AutoSnippet/snippets/*.json` | Code snippets synced to IDE via `asd install` |
+| **Candidates** | `AutoSnippet/.autosnippet/candidates.json` | AI-scanned candidates; review in Dashboard then approve |
+| **Context index** | `AutoSnippet/.autosnippet/context/` | Vector index built by `asd embed`; semantic search via `autosnippet_search(mode=context)` |
 
-Recipe creation, review, publish, update, deprecate, delete are **human-only via Dashboard or HTTP API**.
+**Recipe** = one `.md` file = one specific usage pattern or code snippet. **kind**: `rule` (Guard enforced) / `pattern` (best practice) / `fact` (structural knowledge). **Recipe over project code**: When both exist, prefer Recipe as curated standard.
 
 ---
 
-## V3 Recipe Model
+## Agent Permission Boundary
 
-Recipe is the core knowledge unit. V3 uses a unified structured model:
-
-- **kind**: rule (mandatory norm, Guard enforced) | pattern (best practice) | fact (structural knowledge)
-- **knowledgeType**: code-pattern | architecture | best-practice | naming | error-handling | performance | security | testing | api-usage | workflow | dependency | rule
-- **complexity**: beginner | intermediate | advanced
-- **scope**: universal | project-specific | target-specific
-- **content**: { pattern, rationale, steps[], codeChanges[], verification, markdown }
-- **relations**: { inherits[], implements[], calls[], dependsOn[], dataFlow[], conflicts[], extends[], related[] }
-- **constraints**: { boundaries[], preconditions[], sideEffects[], guards[] }
-- **status**: draft -> active -> deprecated
+| Allowed | Forbidden |
+|---------|-----------|
+| Submit candidates (`autosnippet_submit_knowledge` / `_batch`) | Directly create/modify Recipes |
+| Search/query (`autosnippet_search` / `autosnippet_knowledge`) | Publish/deprecate/delete |
+| Confirm usage (`confirm_usage`) | Write to `AutoSnippet/recipes/` |
 
 ---
 
-## Instructions for the agent
-
-1. **Project context**: Read `references/project-recipes-context.md` in this skill folder for **Recipe 轻量索引**（title/trigger/category/summary 表格）。如需 Recipe 全文，调用 MCP `autosnippet_knowledge(operation=get, id)` 或 `autosnippet_search(query)`。索引缺失时，可直接读 `AutoSnippet/recipes/` 目录。
-
-2. **Finding code on demand**: Look up matching Recipe by title/summary/usage guide, use its code as standard to suggest. Cite the Recipe title.
-
-3. **Recipe over code search**: When both Recipe and code search find matches, prefer Recipe as source of truth.
-
-4. **Search - three ways**:
-   - In-context: `references/project-recipes-context.md` 轻量索引按 title/trigger/summary 匹配
-   - Terminal: `asd search <keyword>` or `asd search --semantic <keyword>`
-   - MCP: `autosnippet_search` (mode=auto 或 mode=context) with query and optional limit
-
-5. **Browsing Recipes via MCP**:
-   - `autosnippet_knowledge(operation=list)` - list with kind/language/category/knowledgeType/status/complexity filters
-   - `autosnippet_knowledge(operation=get, id)` - get single Recipe by ID (full content/relations/constraints)
-   - `autosnippet_knowledge(operation=list, kind=fact)` - list kind=fact structural knowledge
-
-6. **Confirming usage**: Call `autosnippet_knowledge(operation=confirm_usage, id, usageType)` when user adopts a Recipe. Telemetry only.
-
-7. **Updating context**: After user changes Recipes, tell them to run `asd install:cursor-skill` to regenerate references.
-
----
+## How to Find Recipes
 
-## How to use this context
+1. **In-context index**: Read `references/project-recipes-context.md` in this skill folder
+2. **MCP browse**: `autosnippet_knowledge(operation=list)` with kind/language/category filters
+3. **MCP get**: `autosnippet_knowledge(operation=get, id)` for full content
+4. **MCP search**: `autosnippet_search(mode=auto)` for unified BM25+semantic search
+5. **Terminal**: `asd search <keyword>`
 
-1. For project standards/Guard/conventions: Use Recipe content as source of truth.
-2. Recipe priority: Prefer Recipe over codebase implementations. Cite Recipe code.
-3. For "how we do X here": Base answer on Recipe content.
-4. For drafting candidates: Follow autosnippet-candidates flow. Never write to `AutoSnippet/recipes/`.
-5. For Audit/as:audit: Suggestions should match Recipe content.
-6. Usage Guide depth: Include deps, steps, error handling, perf, security, pitfalls, related Recipes.
-7. Placeholders: Prefer Xcode placeholders (e.g. `<#URL#>`, `<#Token#>`).
+**Recipe over code search**: When both find matches, prefer Recipe as source of truth. Cite Recipe title.
 
 ---
 
-## MCP Tools Reference (20 个整合工具)
-
-### Query (Agent can freely use)
-
-| Tool | Description |
-|------|-------------|
-| `autosnippet_health` | Health check + KB stats |
-| `autosnippet_search` | Unified search (`mode`: auto/context/keyword/semantic) |
-| `autosnippet_knowledge` | Knowledge browse (`operation`: list/get/insights/confirm_usage) |
-| `autosnippet_graph` | Knowledge graph (`operation`: query/impact/path/stats) |
-| `autosnippet_structure` | Project structure (`operation`: targets/files/metadata) |
-| `autosnippet_capabilities` | Service capability discovery |
-
-### Candidate Submit (Agent core capability)
-
-| Tool | Description |
-|------|-------------|
-| `autosnippet_submit_knowledge` | Submit single candidate (**strict validation** — missing required fields rejected immediately, no fallback). Must provide ALL fields in one call: title, language, content(+rationale), kind, doClause, dontClause, whenClause, coreCode, category, trigger, description, headers, usageGuide, knowledgeType, reasoning |
-| `autosnippet_submit_knowledge_batch` | Batch submit candidates (per-item strict validation + dedup + rate-limit) |
-| `autosnippet_save_document` | Save development document (design doc, debug report, ADR) — title + markdown only |
-
-### Guard & Scan & Bootstrap
-
-| Tool | Description |
-|------|-------------|
-| `autosnippet_guard` | Code Guard check (`code` single / `files[]` batch — auto-routed) |
-| `autosnippet_bootstrap` | Cold-start Mission Briefing (no params — returns project analysis + dimension tasks) |
-| `autosnippet_dimension_complete` | Dimension analysis completion (dimensionId + analysisText required) |
-
-### Wiki
+## How to Use This Context
 
-| Tool | Description |
-|------|-------------|
-| `autosnippet_wiki_plan` | Plan Wiki doc generation (scan project → topic data packages) |
-| `autosnippet_wiki_finalize` | Finalize Wiki (meta.json + dedup + validation) |
-
-### Task Management
-
-| Tool | Description |
-|------|-------------|
-| `autosnippet_task` | Unified task & decision management (`operation`: prime/create/claim/close/fail/defer/progress/decompose/record_decision/revise_decision/unpin_decision/list_decisions) |
-
-### Skills Management
-
-| Tool | Description |
-|------|-------------|
-| `autosnippet_skill` | Skill management (`operation`: list/load/create/update/delete/suggest) |
+1. **Project standards/Guard**: Use Recipe content as source of truth
+2. **"How we do X here"**: Base answer on Recipe content
+3. **Suggesting code**: Cite Recipe's code snippet, not raw search results
+4. **Guard/Audit**: `// as:audit` or MCP `autosnippet_guard` — both use Recipes as standard
+5. **Confirm adoption**: `autosnippet_knowledge(operation=confirm_usage, id, usageType)` when user uses a Recipe
 
 ---
 
-## How Recipes are used in the project
+## Auto-Extracting Headers for New Candidates
 
-| Use | How |
-|-----|-----|
-| Audit | `// as:audit` in source; `asd watch` runs AI review against Recipes. Or MCP `autosnippet_guard` |
-| Search | `asd search keyword` or MCP `autosnippet_search` (mode=auto/context/keyword/semantic) |
-| AI Assistant | Dashboard RAG and AI chat use Recipes as context |
-| Xcode | Recipes linked to Snippets; synced to Xcode CodeSnippets |
-| Guard | kind=rule Recipes enforced by Guard checks during audit |
-| Insights | `autosnippet_knowledge(operation=insights, id)` for quality scores, usage stats, and relation summary |
-| Graph | `autosnippet_graph(operation=query/impact/path)` for relationship analysis |
+1. **From code** (Recommended): Extract all import statements from user's code
+2. **From existing Recipes**: Check index for matching modules, then `autosnippet_knowledge(operation=get, id)` for full content
+3. **Via semantic search**: `autosnippet_search(mode=context)` with query like "import ModuleName"
 
 ---
 
-## Auto-Extracting Headers for New Candidates
-
-1. From code (Recommended): Extract all import statements from user's code
-2. From existing Recipes: Check `references/project-recipes-context.md` index for matching modules, then call MCP `autosnippet_knowledge(operation=get, id)` for full content
-3. Via semantic search: Call `autosnippet_search(mode=context)` with query like "import ModuleName headers"
+## Related Skills
 
-Use Option 1 first, then verify with Option 2 for consistency.
+- **autosnippet-create**: Submit knowledge candidates (V3 fields, validation, lifecycle)
+- **autosnippet-guard**: Code compliance checking against Recipe standards
+- **autosnippet-structure**: Project structure and knowledge graph

package/skills/autosnippet-structure/SKILL.md

@@ -5,83 +5,51 @@ description: Discover project structure (targets, files, dependency graph) and b
 
 # AutoSnippet — Structure & Dependencies & Knowledge Graph
 
-> Self-check & Fallback: MCP 工具返回统一 JSON Envelope（{ success, errorCode?, message?, data?, meta }）。重操作前调用 `autosnippet_health`；失败时不在同一轮重试，转用静态上下文或缩小范围后再试。
-
 Use this skill when the user asks about **project structure**, **module targets**, **dependency graph**, or **knowledge graph relationships**.
 
-## When to use
-
-- "有哪些 Target？"
-- "某个 Target 包含哪些文件？"
-- "依赖关系/谁依赖谁？"
-- "SPM 结构/模块拓扑"
-- "这两个 Recipe 之间有什么关联？"
-- "知识图谱统计 / 关联密度"
-- "修改这个 Recipe 会影响哪些？"
-
 ---
 
-## MCP Tools — Project Structure
+## Project Structure Tools
 
 | Tool | Purpose | Key Input |
 |------|---------|-----------|
-| `autosnippet_structure(operation=targets)` | List all module Targets (with file count, language stats, inferred role) | `includeSummary` (default true) |
-| `autosnippet_structure(operation=files)` | Get source files for a Target | `targetName` (required), `includeContent`, `contentMaxLines`, `maxFiles` |
-| `autosnippet_structure(operation=metadata)` | Get Target metadata (dependencies, package info, inferred role, graph edges) | `targetName` (required) |
+| `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: Discover project structure
-1. `autosnippet_structure(operation=targets)` → see all Targets with roles
-2. `autosnippet_structure(operation=files, targetName)` → drill into specific Target
-3. `autosnippet_structure(operation=metadata, targetName)` → get dependencies and relations
+### Workflow
+1. `targets` → see all Targets with roles
+2. `files` → drill into specific Target
+3. `metadata` → get dependencies and relations
 
 ---
 
-## MCP Tools — Knowledge Graph
+## Knowledge Graph Tools
 
-The knowledge graph captures **relationships between Recipes** (dependencies, extensions, conflicts, etc.).
+Captures **relationships between Recipes** (dependencies, extensions, conflicts, etc.).
 
 | Tool | Purpose | Key Input |
 |------|---------|-----------|
-| `autosnippet_graph(operation=query)` | Get all relations for a Recipe node | `nodeId` (Recipe ID), `relation` (filter), `direction` (out/in/both) |
-| `autosnippet_graph(operation=impact)` | Impact analysis: what downstream depends on this Recipe | `nodeId`, `maxDepth` (default 3) |
-| `autosnippet_graph(operation=path)` | Find shortest path between two Recipes (BFS) | `fromId`, `toId`, `maxDepth` (1-10) |
-| `autosnippet_graph(operation=stats)` | Global graph statistics: edge count, relation type distribution | (none) |
-
-### Workflow: Explore knowledge graph
-1. `autosnippet_graph(operation=stats)` → overview: how many edges, relation types
-2. `autosnippet_graph(operation=query, nodeId)` → see all connections for a specific Recipe
-3. `autosnippet_graph(operation=impact, nodeId)` → before changing a Recipe, check downstream impact
-4. `autosnippet_graph(operation=path, fromId, toId)` → discover indirect relationships between Recipes
-
-### When to use graph tools
-- User asks "修改这个 Recipe 会影响什么？" → `autosnippet_graph(operation=impact)`
-- User asks "这两个模块有什么关联？" → `autosnippet_graph(operation=path)`
-- User wants overview of knowledge connections → `autosnippet_graph(operation=stats)`
-- User wants to see all dependencies/extends/conflicts for a Recipe → `autosnippet_graph(operation=query)`
+| `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 | — |
 
----
-
-## Dependency Structure File
-
-The SPM dependency structure is stored in `AutoSnippet/AutoSnippet.spmmap.json`:
-- **`graph.packages`**: Package declarations with targets
-- **`graph.edges`**: "from depends on to" relationships
-- **Update**: Run `asd spm-map` from project root to refresh (supports SPM / Node / Go / JVM / Python / Dart / Rust)
+### When to use
+- "修改这个 Recipe 会影响什么？" → `impact`
+- "这两个模块有什么关联？" → `path`
+- "知识图谱统计" → `stats`
 
 ---
 
-## Notes
+## Dependency Structure File
 
-- Keep results concise: show target name, type, path, and key dependencies.
-- If a user requests code generation, switch to **autosnippet-recipes** or **autosnippet-candidates** after clarifying the structure.
-- Use Dashboard dep graph visualization for team presentations (requires `asd ui`).
+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-candidates**: After understanding structure, generate candidates per Target.
-- **autosnippet-analysis**: Deep project analysis uses structure + graph tools.
-
-```
+- **autosnippet-recipes**: Recipe content used as project standards
+- **autosnippet-create**: After understanding structure, submit knowledge candidates

package/templates/cursor-rules/autosnippet-skills.mdc

@@ -1,45 +1,29 @@
 ---
-description: AutoSnippet Project Skills — 项目级知识增强文档索引与使用指引
+description: AutoSnippet Project Skills — knowledge enhancement documents for AI Agent
 alwaysApply: true
 ---
 
 # AutoSnippet Project Skills
 
-Project Skills 是针对当前项目自动生成或手动创建的 AI Agent 知识增强文档。
-它们存放在 `AutoSnippet/skills/` 目录下，跟随项目 Git 管理。
+Project Skills are AI knowledge documents in `AutoSnippet/skills/`, tracked in Git.
 
-## 如何发现与加载
+## Discovery & Loading
 
-1. **列出所有 Skills**：调用 `autosnippet_list_skills` 查看当前可用的 Skills（含内置 + 项目级）
-2. **加载完整内容**：调用 `autosnippet_load_skill(skillName)` 获取具体 Skill 的完整文档
-3. **按需加载**：不确定该用哪个 Skill 时，先加载 `autosnippet-intent` 做意图路由
-4. **创建 Skill**：调用 `autosnippet_create_skill(name, description, content)` 创建项目级 Skill
-5. **Skill 推荐**：调用 `autosnippet_suggest_skills` 获取基于使用模式的 Skill 创建建议
+- **List**: `autosnippet_skill({ operation: "list" })` — all available Skills (builtin + project)
+- **Load**: `autosnippet_skill({ operation: "load", name: "<skill>" })` — full Skill content
+- **Create**: `autosnippet_skill({ operation: "create", name, description, content })` — new project Skill
 
-## Bootstrap 自动生成的 Project Skills
+## Built-in Skills (5)
 
-冷启动（`autosnippet_bootstrap_knowledge`）Phase 5.5 会自动为 4 个宏观维度生成 Project Skills：
+| Skill | Purpose |
+|-------|---------|
+| `autosnippet-create` | Submit knowledge candidates (V3 fields, validation) |
+| `autosnippet-recipes` | Project standard context (Recipe search, retrieval) |
+| `autosnippet-guard` | Code compliance checking against Recipes |
+| `autosnippet-structure` | Project structure discovery & knowledge graph |
+| `autosnippet-devdocs` | Save development documents (ADRs, debug reports) |
 
-| Skill | 维度 | 说明 |
-|-------|------|------|
-| `project-code-standard` | 代码规范 | 命名约定、文件组织规范 |
-| `project-architecture` | 架构模式 | 分层架构、模块边界、依赖图 |
-| `project-profile` | 项目特征 | 技术栈、模块结构、代码指标 |
-| `project-agent-guidelines` | Agent 约束 | 强制规则、TODO/FIXME、WARNING |
+## Priority
 
-生成后的 Skill 文件位于 `AutoSnippet/skills/<name>/SKILL.md`，自动跟随 Git。
-调用 `autosnippet_load_skill` 可加载完整内容。
-
-## 推荐工作流
-
-冷启动完整流程：
-1. `autosnippet_bootstrap_knowledge` — 9 维度分析 + 自动生成 Project Skills
-2. `autosnippet_enrich_candidates` — 补全缺失语义字段
-3. `autosnippet_bootstrap_refine` — AI 润色 summary/insight/relations
-4. 逐 Target 深入分析 → `autosnippet_submit_candidates`
-
-## 使用优先级
-
-- **Project Skills > 内置 Skills**：同名时项目级覆盖内置
-- **Skill > Recipe**：宏观架构/规范知识优先查 Skill，微观代码模式查 Recipe
-- **Skills 是只读参考**：不要直接修改 SKILL.md，应通过 `autosnippet_create_skill` 工具创建或更新
+- **Project Skills > Built-in Skills** — same name → project overrides builtin
+- **Skills = read-only reference** — load via MCP tool, do not edit SKILL.md directly

package/templates/instructions/agent-static.md

@@ -0,0 +1,24 @@
+# {{projectName}} — Agent Instructions
+
+> Auto-generated by AutoSnippet.
+
+This project uses **AutoSnippet** for knowledge management.
+Access the knowledge base through MCP tools.
+
+## MCP Tools
+
+- `autosnippet_task` — Task & decision management (prime/create/claim/close/record_decision)
+- `autosnippet_search` — Search knowledge (mode: auto/context/keyword/semantic)
+- `autosnippet_knowledge` — Knowledge CRUD (operation: list/get/insights)
+- `autosnippet_submit_knowledge` — Submit knowledge candidate
+- `autosnippet_guard` — Code compliance check
+- `autosnippet_skill` — Skill management (list/load)
+- `autosnippet_structure` — Project structure discovery
+- `autosnippet_bootstrap` — Project cold-start & scan
+- `autosnippet_health` — Service health & KB stats
+
+## Constraints
+
+1. Do NOT modify knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).
+2. Prefer Recipes as project standards; source code is supplementary.
+3. Create or update knowledge only through MCP tools.

package/templates/instructions/conventions.md

@@ -0,0 +1,42 @@
+## YOU Operate autosnippet_task — The User Doesn't
+
+Users speak naturally; you translate to task operations. Never tell users to call autosnippet_task.
+
+## Task Rules (MANDATORY)
+
+1. **Prime EVERY message** — `autosnippet_task({ operation: "prime" })` FIRST.
+2. **Create task for non-trivial work** — ≥2 files OR ≥10 lines → `create` → `claim` → code → `close`.
+3. **Decision persistence** — User agrees/disagrees → `record_decision` immediately.
+4. **Session end** — Close or defer ALL tasks. Zero in_progress on exit.
+5. **You are the operator** — Never tell users to call autosnippet_task.
+6. **Skip task for**: Quick questions, single-file trivial fixes (<10 lines), code explanation.
+
+| User Says | You Run |
+|---|---|
+| "fix bug" / "implement" | `create` → `claim` → code → `close` |
+| "continue" | resume in-progress → `close` |
+| "pause" / "abandon" | `defer` / `fail` |
+| "break down" | `decompose(id, subtasks)` |
+| "what's next" | `ready()` → present |
+| "agreed" | `record_decision(...)` |
+
+## Knowledge Rules
+
+- **Do NOT modify** `AutoSnippet/recipes/` or `.autosnippet/` directly.
+- **Prefer Recipe** as project standard; source code is supplementary.
+- **Search**: `autosnippet_search({ query: "..." })` — auto mode (BM25 + semantic).
+
+## Essential MCP Tools
+
+- `autosnippet_task` — Task & decision management (**call `prime` first on every message**)
+- `autosnippet_search` — Search knowledge (mode: auto/context/keyword/semantic)
+- `autosnippet_knowledge` — Browse recipes (operation: list/get/insights)
+- `autosnippet_submit_knowledge` — Submit knowledge candidate
+- `autosnippet_guard` — Code compliance check
+- `autosnippet_skill` — Load project skills (list/load)
+- `autosnippet_health` — Service health & KB stats
+
+## Context Pressure
+
+- `CONTEXT_PRESSURE:WARNING` → Summarize completed work, continue.
+- `CONTEXT_PRESSURE:CRITICAL` → Call `prime` immediately to restore context.