菜单
Generate standardized project documentation using the 5-style system. Use when asked to create plans, specs, skills, RFCs, ADRs, or other project documentation. Ensures consistent, high-quality documentation across the codebase.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Design patterns for local-first AI desktop apps — provider abstraction (Ollama / OpenAI-compatible gateways), RAG retrieval and ingestion hygiene, citation UX that loops back to sources, streaming and scoped cancellation, chat-loop details, and demo-corpus design. Use when building or reviewing a local AI app, a RAG/notebook product, chat UX, or preparing AI product demos. Distilled from Alchemy (a local NotebookLM clone).
Automate, inspect, and verify a running Tauri app with tauri-browser — DOM snapshots, ref-based clicks, React-safe fills, screenshots, direct Tauri command invokes, and demo-data seeding. Use when driving a Tauri app for testing, screenshots, demo setup, or end-to-end verification of app changes.
Manage Homebrew taps for distributing CLI tools and macOS apps. Use when creating or updating Homebrew formulas and casks.
Build, code-sign, notarize, and release Tauri 2 desktop apps on macOS (Rust backend + web frontend), including dev-loop gotchas (capabilities/ACL, watcher, cargo patches) and CI fallbacks. Use when working on a Tauri app's release pipeline, Apple signing/notarization, GitHub Actions for macOS builds, or debugging a Tauri dev loop. Distilled from shipping Alchemy (a local NotebookLM clone).
Rust development workflow with quality gates, testing, and iteration patterns. Use when developing Rust code, running tests, or iterating on Rust projects.
HCP Terraform (Terraform Cloud) workflow for remote plan and apply. Use when working with Terraform that runs in Terraform Cloud, not locally.
| name | style-docs |
| description | Generate standardized project documentation using the 5-style system. Use when asked to create plans, specs, skills, RFCs, ADRs, or other project documentation. Ensures consistent, high-quality documentation across the codebase. |
Use this skill when creating project documentation, planning features, or organizing technical decisions.
| Style | Purpose | Location | Update Trigger |
|---|---|---|---|
| 1. Plan Mode | Deep exploration before coding | plans/ | Per feature |
| 2. Issues | Track work across sessions | .beads/ or GH | Throughout feature |
| 3. Evergreen Specs | System truth ("how it works") | specs/ | Architecture changes |
| 4. Skills | Agent guides ("how to implement") | .claude/skills/ | Pattern changes |
| 5. User Docs | Human communication | README, CLAUDE.md | Major features |
Purpose: Explore and design before coding
When to use:
File naming: plans/YYYY-MM-DD-feature-name.md
Template: See references/plan-template.md
Purpose: Track work items and dependencies
When to use:
Commands:
bd create --title="..." --type=task|bug|feature --priority=2
bd update <id> --status=in_progress
bd close <id>
Purpose: Document architectural truth - WHAT the system does
When to use:
Characteristics:
Template: See references/spec-template.md
Purpose: Guide agents on HOW to implement
When to use:
Characteristics:
Template: See references/skill-template.md
Purpose: Human-facing communication
When to use:
Files:
README.md: Project overview, installationCLAUDE.md: Agent instructionsAGENTS.md: Compiled agent instructions| Situation | Action |
|---|---|
| Starting new feature | Enter plan mode → write to plans/ |
| Feature spans sessions | Create beads issue |
| New architectural pattern | Update spec in specs/ |
| New implementation pattern | Update skill in .claude/skills/ |
| Public-facing change | Update README.md |
| Agent guidance needed | Update CLAUDE.md |
For specific use cases:
references/rfc-template.md): Formal proposals needing team inputreferences/adr-template.md): Architecture decision recordsreferences/bug-report-template.md): Bug documentationreferences/feature-request-template.md): Feature proposalsreferences/pull-request-template.md): PR descriptionsDON'T:
DO:
All templates available in references/:
plan-template.md - Plan mode templatespec-template.md - Evergreen spec templateskill-template.md - Skill document templaterfc-template.md - RFC templateadr-template.md - ADR templatebug-report-template.md - Bug report templatefeature-request-template.md - Feature request templatepull-request-template.md - PR description template