core-dynamic-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Dynamic Skills Manager

动态技能管理器

Version: 2.1.0 | Last Updated: 2025-01-27

Orchestrates on-demand generation of crate-specific skills based on project dependencies.

版本: 2.1.0 | 最后更新: 2025-01-27

根据项目依赖按需编排生成特定crate的技能。

Concept

概念

Dynamic skills are:

Generated locally at
```
~/.claude/skills/
```
Based on Cargo.toml dependencies
Created using llms.txt from docs.rs
Versioned and updatable
Not committed to the rust-skills repository

动态技能具备以下特性：

在本地
```
~/.claude/skills/
```
目录生成
基于Cargo.toml依赖项
利用docs.rs的llms.txt创建
可版本化和更新
不会提交到rust-skills仓库

Trigger Scenarios

触发场景

Prompt-on-Open

打开时提示

When entering a directory with Cargo.toml:

Detect Cargo.toml (single or workspace)
Parse dependencies list
Check which crates are missing skills
If missing: "Found X dependencies without skills. Sync now?"
If confirmed: run
```
/sync-crate-skills
```

进入包含Cargo.toml的目录时：

检测Cargo.toml（单个项目或工作区）
解析依赖列表
检查哪些crate缺少技能
若存在缺失：“发现X个无对应技能的依赖项。是否立即同步？”
若确认：运行
```
/sync-crate-skills
```

Manual Commands

手动命令

```
/sync-crate-skills
```
- Sync all dependencies
```
/clean-crate-skills [crate]
```
- Remove skills
```
/update-crate-skill <crate>
```
- Update specific skill

```
/sync-crate-skills
```
- 同步所有依赖项
```
/clean-crate-skills [crate]
```
- 删除技能
```
/update-crate-skill <crate>
```
- 更新特定技能

Execution Mode Detection

执行模式检测

CRITICAL: Check if agent and command infrastructure is available.

Try to read:

../../agents/

directory Check if

/create-llms-for-skills

and

/create-skills-via-llms

commands work.

关键：检查agent和命令基础设施是否可用。

尝试读取：

../../agents/

目录检查

/create-llms-for-skills

和

/create-skills-via-llms

命令是否可正常工作。

Agent Mode (Plugin Install)

Agent模式（插件安装）

When full plugin infrastructure is available:

当完整插件基础设施可用时：

Architecture

架构

Cargo.toml
    ↓
Parse dependencies
    ↓
For each crate:
  ├─ Check ~/.claude/skills/{crate}/
  ├─ If missing: Check actionbook for llms.txt
  │     ├─ Found: /create-skills-via-llms
  │     └─ Not found: /create-llms-for-skills first
  └─ Load skill

Cargo.toml
    ↓
解析依赖项
    ↓
针对每个crate：
  ├─ 检查~/.claude/skills/{crate}/
  ├─ 若缺失：检查actionbook中的llms.txt
  │     ├─ 找到：执行/create-skills-via-llms
  │     └─ 未找到：先执行/create-llms-for-skills
  └─ 加载技能

Workflow Priority

工作流优先级

actionbook MCP - Check for pre-generated llms.txt
/create-llms-for-skills - Generate llms.txt from docs.rs
/create-skills-via-llms - Create skills from llms.txt

actionbook MCP - 检查预生成的llms.txt
/create-llms-for-skills - 从docs.rs生成llms.txt
/create-skills-via-llms - 基于llms.txt创建技能

Sync Command

同步命令

bash

/sync-crate-skills [--force]

Parse Cargo.toml for dependencies
For each dependency:
- Check if skill exists at
```
~/.claude/skills/{crate}/
```
- If missing (or --force): generate skill
Report results

bash

/sync-crate-skills [--force]

解析Cargo.toml获取依赖项
针对每个依赖项：
- 检查技能是否存在于
```
~/.claude/skills/{crate}/
```
- 若缺失（或使用--force参数）：生成技能
报告结果

Inline Mode (Skills-only Install)

内联模式（仅技能安装）

When agent/command infrastructure is NOT available, execute manually:

当agent/命令基础设施不可用时，手动执行：

Step 1: Parse Cargo.toml

步骤1：解析Cargo.toml

bash

undefined

bash

undefined

Read dependencies

读取依赖项

cat Cargo.toml | grep -A 100 '[dependencies]' | grep -E '^[a-zA-Z]'


Or use Read tool to parse Cargo.toml and extract:
- `[dependencies]` section
- `[dev-dependencies]` section (optional)
- Workspace members (if workspace project)

cat Cargo.toml | grep -A 100 '[dependencies]' | grep -E '^[a-zA-Z]'


或使用读取工具解析Cargo.toml并提取：
- `[dependencies]`章节
- `[dev-dependencies]`章节（可选）
- 工作区成员（若为工作区项目）

Step 2: Check Existing Skills

步骤2：检查现有技能

bash

undefined

bash

undefined

List existing skills

列出已有技能

ls ~/.claude/skills/


Compare with dependencies to find missing skills.

ls ~/.claude/skills/


与依赖项对比，找出缺失的技能。

Step 3: Generate Missing Skills

步骤3：生成缺失的技能

For each missing crate:

bash

undefined

针对每个缺失的crate：

bash

undefined

1. Fetch crate documentation

1. 获取crate文档

agent-browser open "https://docs.rs/{crate}/latest/{crate}/" agent-browser get text ".docblock"

Save content

保存内容

2. Create skill directory

2. 创建技能目录

mkdir -p ~/.claude/skills/{crate} mkdir -p ~/.claude/skills/{crate}/references

3. Create SKILL.md

3. 创建SKILL.md

Use template from rust-skill-creator inline mode

使用rust-skill-creator内联模式的模板

4. Create reference files for key modules

4. 为关键模块创建参考文件

agent-browser open "https://docs.rs/{crate}/latest/{crate}/{module}/" agent-browser get text ".docblock"

Save to ~/.claude/skills/{crate}/references/{module}.md

保存到~/.claude/skills/{crate}/references/{module}.md

agent-browser close


**WebFetch fallback:**

WebFetch("https://docs.rs/{crate}/latest/{crate}/", "Extract API documentation overview, key types, and usage examples")

undefined

agent-browser close


**WebFetch备选方案：**

WebFetch("https://docs.rs/{crate}/latest/{crate}/", "提取API文档概述、关键类型和使用示例")

undefined

Step 4: Workspace Support

步骤4：工作区支持

For Cargo workspace projects:

bash

undefined

针对Cargo工作区项目：

bash

undefined

1. Parse root Cargo.toml for workspace members

1. 解析根目录Cargo.toml获取工作区成员

cat Cargo.toml | grep -A 10 '[workspace]'

2. For each member, parse their Cargo.toml

2. 针对每个成员，解析其Cargo.toml

for member in members; do cat ${member}/Cargo.toml | grep -A 100 '[dependencies]' done

3. Aggregate and deduplicate dependencies

3. 聚合并去重依赖项

4. Generate skills for missing crates

4. 为缺失的crate生成技能

undefined

undefined

Clean Command (Inline)

清理命令（内联模式）

bash

undefined

bash

undefined

Clean specific crate

清理特定crate

rm -rf ~/.claude/skills/{crate_name}

Clean all generated skills

清理所有生成的技能

rm -rf ~/.claude/skills/*

undefined

rm -rf ~/.claude/skills/*

undefined

Update Command (Inline)

更新命令（内联模式）

bash

undefined

bash

undefined

Remove old skill

删除旧技能

rm -rf ~/.claude/skills/{crate_name}

Re-generate (same as sync for single crate)

重新生成（与单个crate的同步操作相同）

Follow Step 3 above for the specific crate

按照上述步骤3针对特定crate执行

---

---

Local Skills Directory

本地技能目录

~/.claude/skills/
├── tokio/
│   ├── SKILL.md
│   └── references/
├── serde/
│   ├── SKILL.md
│   └── references/
└── axum/
    ├── SKILL.md
    └── references/

~/.claude/skills/
├── tokio/
│   ├── SKILL.md
│   └── references/
├── serde/
│   ├── SKILL.md
│   └── references/
└── axum/
    ├── SKILL.md
    └── references/

Related Commands

Error Handling

错误处理

Error	Cause	Solution
Commands not found	Skills-only install	Use inline mode
Cargo.toml not found	Not in Rust project	Navigate to project root
docs.rs unavailable	Network issue	Retry or skip crate
Permission denied	Directory issue	Check ~/.claude/skills/ permissions

错误	原因	解决方案
命令未找到	仅安装了技能	使用内联模式
未找到Cargo.toml	不在Rust项目目录	导航到项目根目录
docs.rs不可用	网络问题	重试或跳过该crate
权限被拒绝	目录问题	检查~/.claude/skills/的权限

core-dynamic-skills

Original

Translation

Dynamic Skills Manager

动态技能管理器

Concept

概念

Trigger Scenarios

触发场景

Prompt-on-Open

打开时提示

Manual Commands

手动命令

Execution Mode Detection

执行模式检测

Agent Mode (Plugin Install)

Agent模式（插件安装）

Architecture

架构

Workflow Priority

工作流优先级

Sync Command

同步命令

Inline Mode (Skills-only Install)

内联模式（仅技能安装）

Step 1: Parse Cargo.toml

步骤1：解析Cargo.toml

Read dependencies

读取依赖项

Step 2: Check Existing Skills

步骤2：检查现有技能

List existing skills

列出已有技能

Step 3: Generate Missing Skills

步骤3：生成缺失的技能

1. Fetch crate documentation

1. 获取crate文档

Save content

保存内容

2. Create skill directory

2. 创建技能目录

3. Create SKILL.md

3. 创建SKILL.md

Use template from rust-skill-creator inline mode

使用rust-skill-creator内联模式的模板

4. Create reference files for key modules

4. 为关键模块创建参考文件

Save to ~/.claude/skills/{crate}/references/{module}.md

保存到~/.claude/skills/{crate}/references/{module}.md

Step 4: Workspace Support

步骤4：工作区支持

1. Parse root Cargo.toml for workspace members

1. 解析根目录Cargo.toml获取工作区成员

2. For each member, parse their Cargo.toml

2. 针对每个成员，解析其Cargo.toml

3. Aggregate and deduplicate dependencies

3. 聚合并去重依赖项

4. Generate skills for missing crates

4. 为缺失的crate生成技能

Clean Command (Inline)

清理命令（内联模式）

Clean specific crate

清理特定crate

Clean all generated skills

清理所有生成的技能

Update Command (Inline)

更新命令（内联模式）

Remove old skill

删除旧技能

Re-generate (same as sync for single crate)

重新生成（与单个crate的同步操作相同）

Follow Step 3 above for the specific crate

按照上述步骤3针对特定crate执行

Local Skills Directory

本地技能目录

Related Commands

相关命令

Error Handling

错误处理