[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74925":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":14,"starSnapshotCount":14,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},74925,"rust-skills","actionbook\u002Frust-skills","actionbook","Rust Developer AI Assistance System — Meta-Problem-Driven Knowledge Indexing",null,"Shell",1229,101,10,0,13,39,103,100.53,false,"main",true,[],"2026-06-12 04:01:16","# Rust Skills\n\n[中文](.\u002FREADME-zh.md) | [日本語](.\u002FREADME-ja.md)\n\n> AI-powered Rust development assistant with meta-cognition framework\n\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.0.9-green.svg)](https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills\u002Freleases)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude%20Code-Plugin-blue)](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)\n\n## What is Rust Skills?\n\n**Rust Skills** is a Claude Code plugin that transforms how AI assists with Rust development. Instead of giving surface-level answers, it traces through cognitive layers to provide **domain-correct architectural solutions**.\n\n### The Problem\n\nTraditional AI assistance for Rust:\n```\nUser: \"My trading system reports E0382\"\nAI: \"Use .clone()\"  ← Surface fix, ignores domain constraints\n```\n\n### The Solution\n\nRust Skills with meta-cognition:\n```\nUser: \"My trading system reports E0382\"\n\nAI (with Rust Skills):\n├── Layer 1: E0382 = ownership error → Why is this data needed?\n│       ↑\n├── Layer 3: Trade records are immutable audit data → Should share, not copy\n│       ↓\n├── Layer 2: Use Arc\u003CTradeRecord> as shared immutable value\n│       ↓\n└── Recommendation: Redesign as Arc\u003CT>, not clone()\n```\n\n## Features\n\n- **Meta-Cognition Framework**: Three-layer cognitive model (Domain → Design → Mechanics)\n- **Real-time Information**: Fetch latest Rust versions and crate info via background agents\n- **Dynamic Skills**: Auto-generate skills from your Cargo.toml dependencies\n- **Domain Extensions**: FinTech, ML, Cloud-Native, IoT, Embedded, Web, CLI support\n- **Coding Guidelines**: Complete Rust coding conventions and best practices\n\n## Installation\n\nRust Skills supports two installation modes:\n\n- **Plugin Mode** (Claude Code): Full features including hooks, agents, and auto meta-cognition\n- **Skills-only Mode**: Works with any coding agent that supports skills (Claude Code, Vercel AI, etc.)\n\n---\n\n### Skills-only Install (Recommended)\n\nThe simplest way to get started. Works with **any coding agent** that supports skills, including Claude Code, [Vercel's `add-skills`](https:\u002F\u002Fgithub.com\u002Fnicepkg\u002Fadd-skills), and others.\n\nSkills now include **inline fallback logic** — when agent files are not available, skills execute directly using built-in tools (actionbook, agent-browser, WebFetch).\n\n#### Option A: NPX (Easiest)\n\n```bash\nnpx skills add actionbook\u002Frust-skills\n```\n\n#### Option B: CoWork CLI\n\nInstall via [CoWork](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fcowork), a Rust-based skills management tool:\n\n```bash\n# Install CoWork\ncargo install cowork\n\n# Method 1: Direct install\ncowork install actionbook\u002Frust-skills\n\n# Method 2: Config-based install (recommended for teams)\ncowork config init                    # Create .cowork\u002FSkills.toml\n# Edit Skills.toml to add rust-skills (see below)\ncowork config install                 # Install all configured skills\n```\n\n**Skills.toml configuration:**\n\n```toml\n[project]\nname = \"my-rust-project\"\n\n[skills.install]\nrust-skills = \"actionbook\u002Frust-skills\"\n\n[security]\ntrusted_authors = [\"ZhangHanDong\"]\n```\n\n> CoWork (`co` for short) provides version management, dependency resolution, lock files, and security auditing. See [CoWork documentation](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fcowork) for more details.\n\n#### Option C: Manual Copy\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills.git\ncp -r rust-skills\u002Fskills\u002F* ~\u002F.claude\u002Fskills\u002F\n```\n\n> **Note**: Skills-only mode does not include hooks, so meta-cognition won't trigger automatically. You can manually call `\u002Frust-router` or specific skills. Background agents fall back to inline execution automatically.\n\n---\n\n### Claude Code Plugin Install (Full Features)\n\nFor **Claude Code users** who want the complete experience with hooks, background agents, and auto meta-cognition triggering.\n\n#### Option A: Marketplace\n\n```bash\n# Step 1: Add the marketplace\n\u002Fplugin marketplace add actionbook\u002Frust-skills\n\n# Step 2: Install the plugin\n\u002Fplugin install rust-skills@rust-skills\n```\n\n> **Note**: Step 1 only adds the marketplace (plugin source). Step 2 actually installs the rust-skills plugin with all features enabled.\n\n#### Option B: Full Plugin (Local)\n\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills.git\n\n# Launch with plugin directory\nclaude --plugin-dir \u002Fpath\u002Fto\u002Frust-skills\n```\n\n---\n\n### Feature Comparison\n\n| Feature | Plugin (Marketplace) | Plugin (Local) | Skills-only (NPX\u002FCoWork\u002FManual) |\n|---------|---------------------|----------------|--------------------------------|\n| All 31 Skills | ✅ | ✅ | ✅ |\n| Auto meta-cognition trigger | ✅ | ✅ | ❌ (manual invoke) |\n| Hook-based routing | ✅ | ✅ | ❌ |\n| Background agents | ✅ | ✅ | ✅ (inline fallback) |\n| Easy updates | ✅ | ❌ | ✅ (NPX\u002FCoWork) |\n| Works with other agents | ❌ | ❌ | ✅ |\n\n### Permission Configuration\n\nBackground agents require permission to run `agent-browser`. Configure in your project:\n\n```bash\n# Copy example config\ncp \u002Fpath\u002Fto\u002Frust-skills\u002F.claude\u002Fsettings.example.json .claude\u002Fsettings.local.json\n```\n\nOr create manually:\n\n```bash\nmkdir -p .claude\ncat > .claude\u002Fsettings.local.json \u003C\u003C 'EOF'\n{\n  \"permissions\": {\n    \"allow\": [\n      \"Bash(agent-browser *)\"\n    ]\n  }\n}\nEOF\n```\n\nSee [.claude\u002Fsettings.example.json](.claude\u002Fsettings.example.json) for reference.\n\n### Other Platforms\n\n- **OpenCode**: See [.opencode\u002FINSTALL.md](.opencode\u002FINSTALL.md)\n- **Codex**: See [.codex\u002FINSTALL.md](.codex\u002FINSTALL.md)\n\n## Dependent Skills\n\nRust Skills relies on these external tools for full functionality:\n\n| Tool | Description | GitHub |\n|------|-------------|--------|\n| **actionbook** | MCP server for website action manuals. Used by agents to fetch structured web content (Rust releases, crate info, documentation). | [actionbook\u002Factionbook](https:\u002F\u002Fgithub.com\u002Factionbook\u002Factionbook) |\n| **agent-browser** | Browser automation tool for fetching real-time web data. Fallback when actionbook is unavailable. | [vercel-labs\u002Fagent-browser](https:\u002F\u002Fgithub.com\u002Fvercel-labs\u002Fagent-browser) |\n\n## Meta-Cognition Framework\n\n### Core Concept\n\n**Don't answer directly. Trace through cognitive layers first.**\n\n```\nLayer 3: Domain Constraints (WHY)\n├── Domain rules determine design choices\n└── Example: Financial systems require immutable, auditable data\n\nLayer 2: Design Choices (WHAT)\n├── Design patterns and architectural decisions\n└── Example: Use Arc\u003CT> for shared immutable data\n\nLayer 1: Language Mechanics (HOW)\n├── Rust language features and compiler rules\n└── Example: E0382 is a symptom of ownership design issues\n```\n\n### Routing Rules\n\n| User Signal | Entry Layer | Trace Direction | Primary Skill |\n|-------------|-------------|-----------------|---------------|\n| E0xxx errors | Layer 1 | Trace UP ↑ | m01-m07 |\n| \"How to design...\" | Layer 2 | Bidirectional | m09-m15 |\n| \"[Domain] app development\" | Layer 3 | Trace DOWN ↓ | domain-* |\n| Performance issues | Layer 1→2 | Up then Down | m10-performance |\n\n## Skills Overview\n\n### Core Skills\n- `rust-router` - Master router for all Rust questions (invoked first)\n- `rust-learner` - Fetch latest Rust\u002Fcrate version info\n- `coding-guidelines` - Coding conventions lookup\n\n### Layer 1: Language Mechanics (m01-m07)\n\n| Skill | Core Question | Triggers |\n|-------|---------------|----------|\n| m01-ownership | Who should own this data? | E0382, E0597, move, borrow |\n| m02-resource | What ownership pattern fits? | Box, Rc, Arc, RefCell |\n| m03-mutability | Why does this data need to change? | mut, Cell, E0596, E0499 |\n| m04-zero-cost | Compile-time or runtime polymorphism? | generic, trait, E0277 |\n| m05-type-driven | How can types prevent invalid states? | newtype, PhantomData |\n| m06-error-handling | Expected failure or bug? | Result, Error, panic, ? |\n| m07-concurrency | CPU-bound or I\u002FO-bound? | async, Send, Sync, thread |\n\n### Layer 2: Design Choices (m09-m15)\n\n| Skill | Core Question | Triggers |\n|-------|---------------|----------|\n| m09-domain | What role does this concept play? | DDD, entity, value object |\n| m10-performance | Where's the bottleneck? | benchmark, profiling |\n| m11-ecosystem | Which crate fits this task? | crate selection, dependencies |\n| m12-lifecycle | When to create, use, cleanup? | RAII, Drop, lazy init |\n| m13-domain-error | Who handles this error? | retry, circuit breaker |\n| m14-mental-model | How to think about this correctly? | learning Rust, why |\n| m15-anti-pattern | Does this pattern hide design issues? | code smell, common mistakes |\n\n### Layer 3: Domain Constraints (domain-*)\n\n| Skill | Domain | Core Constraints |\n|-------|--------|------------------|\n| domain-fintech | FinTech | Audit trail, precision, consistency |\n| domain-ml | Machine Learning | Memory efficiency, GPU acceleration |\n| domain-cloud-native | Cloud Native | 12-Factor, observability, graceful shutdown |\n| domain-iot | IoT | Offline-first, power management, security |\n| domain-web | Web Services | Stateless, latency SLA, concurrency |\n| domain-cli | CLI | UX, config precedence, exit codes |\n| domain-embedded | Embedded | No heap, no_std, real-time |\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `\u002Frust-features [version]` | Get Rust version features |\n| `\u002Fcrate-info \u003Ccrate>` | Get crate information |\n| `\u002Fdocs \u003Ccrate> [item]` | Get API documentation |\n| `\u002Fsync-crate-skills` | Sync skills from Cargo.toml dependencies |\n| `\u002Fupdate-crate-skill \u003Ccrate>` | Update specific crate skill |\n| `\u002Fclean-crate-skills` | Clean local crate skills |\n\n## Dynamic Skills\n\nGenerate skills on-demand from your project dependencies:\n\n```bash\n# Enter your Rust project\ncd my-rust-project\n\n# Sync all dependencies\n\u002Fsync-crate-skills\n\n# Skills are created at ~\u002F.claude\u002Fskills\u002F{crate}\u002F\n```\n\n### Features\n- **On-demand generation**: Created from Cargo.toml dependencies\n- **Local storage**: `~\u002F.claude\u002Fskills\u002F`\n- **Version tracking**: Each skill records crate version\n- **Workspace support**: Parses all workspace members\n\n## How It Works\n\n```\nUser Question\n     │\n     ▼\n┌─────────────────────────────────────────┐\n│           Hook Layer                     │\n│  400+ keywords trigger meta-cognition    │\n└─────────────────────────────────────────┘\n     │\n     ▼\n┌─────────────────────────────────────────┐\n│           rust-router                    │\n│  Identify entry layer + domain           │\n│  Decision: dual-skill loading            │\n└─────────────────────────────────────────┘\n     │\n     ├──────────────┬──────────────┐\n     ▼              ▼              ▼\n┌──────────┐  ┌──────────┐  ┌──────────┐\n│ Layer 1  │  │ Layer 2  │  │ Layer 3  │\n│ m01-m07  │  │ m09-m15  │  │ domain-* │\n└──────────┘  └──────────┘  └──────────┘\n     │\n     ▼\nDomain-correct architectural solution\n```\n\n## Documentation\n\n- [Architecture (中文)](.\u002Fdocs\u002Farchitecture-zh.md)\n- [Functional Overview (中文)](.\u002Fdocs\u002Ffunctional-overview-zh.md)\n- [Hook Mechanism (中文)](.\u002Fdocs\u002Fhook-mechanism-zh.md)\n- [Prompt Engineering (中文)](.\u002Fdocs\u002Fprompt-engineering-zh.md)\n- [Meta-Cognition Example: E0382](.\u002Fdocs\u002Fmeta-cognition-example-e0382.md)\n\n## Contributing\n\nContributions are welcome! Please read our contributing guidelines before submitting PRs.\n\n## Acknowledgments\n\n- [@pinghe](https:\u002F\u002Fgithub.com\u002Fpinghe) - `context: fork` support suggestion ([#4](https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills\u002Fissues\u002F4))\n- [@DoiiarX](https:\u002F\u002Fgithub.com\u002FDoiiarX) - OpenCode installation fix ([#6](https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills\u002Fissues\u002F6))\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Links\n\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills\n- **Issues**: https:\u002F\u002Fgithub.com\u002Factionbook\u002Frust-skills\u002Fissues\n","Rust Skills 是一个基于AI的Rust开发助手，通过元认知框架提供深层次的领域正确架构解决方案。其核心功能包括三层认知模型（领域→设计→机制）、实时获取最新Rust版本及crate信息、根据Cargo.toml依赖自动生成技能等。此外，它支持多种场景如金融科技、机器学习、云原生、物联网、嵌入式系统、Web和CLI开发，并遵循完整的Rust编码规范与最佳实践。适合需要深度理解项目背景并提供精准技术建议的Rust开发者使用，在处理复杂问题时尤为有用。",2,"2026-06-11 03:51:26","high_star"]