关于 generate-subsystem-skills
这是一个 Claude Code skill,用于分析 LlamaFarm monorepo 中的子系统,并生成语言通用及子系统专属指南,供代码库维护者使用。它着重整理安全、性能和语言实践方面的理想做法。
主要功能
- 01分析注册表中的子系统
- 02生成语言通用技能
- 03生成子系统专属技能
- 04添加框架检查清单
- 05并行运行生成 Agent
适用场景
- 01为子系统创建编码指南
- 02记录特定语言实践
- 03统一 monorepo 中的代码模式
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ llama-farm/ llamafarm --skill generate-subsystem-skills安装后在 Claude Code 中输入/generate-subsystem-skills确认已加载。
附带文件subsystem-registry.md
详细介绍
生成子系统技能
此技能会分析 LlamaFarm monorepo 中的每个子系统,并针对安全性、性能和特定语言的最佳实践生成专门的 Claude Code 技能。
用法
/generate-subsystem-skills
生成内容
通用语言技能(4 个)
python-skills/- 用于:server、rag、runtime、config、commongo-skills/- 用于:clitypescript-skills/- 用于:designer、electronreact-skills/- 用于:designer
子系统专属技能(8 个)
cli-skills/- Cobra、Bubbletea 模式server-skills/- FastAPI、Celery、Pydantic 模式rag-skills/- LlamaIndex、ChromaDB 模式runtime-skills/- PyTorch、Transformers 模式designer-skills/- TanStack Query、Tailwind、Radix 模式electron-skills/- Electron IPC、安全模式config-skills/- Pydantic、JSONSchema 模式common-skills/- HuggingFace Hub 模式
生成流程
步骤 1:读取注册表
从 subsystem-registry.md 加载子系统定义。
步骤 2:生成通用语言技能
并行启动子 Agent,生成以下技能:
-
Python 技能 Agent - 分析 Python 子系统(server、rag、runtime、config、common),找出理想模式,并生成
python-skills/ -
Go 技能 Agent - 分析 CLI 子系统,找出理想的 Go 模式,并生成
go-skills/ -
TypeScript 技能 Agent - 分析 designer 和 electron,找出理想的 TS 模式,并生成
typescript-skills/ -
React 技能 Agent - 分析 designer,找出理想的 React 18 模式,并生成
react-skills/
步骤 3:生成子系统技能
针对每个子系统并行启动子 Agent:
对于每个子系统,Agent 应:
- 读取子系统的依赖文件(package.json、pyproject.toml、go.mod)
- 使用 Grep 和 Read 分析代码模式
- 生成链接到通用语言技能的 SKILL.md
- 生成框架专属的检查清单文件
- 将所有文件写入
.claude/skills/{subsystem}-skills/
步骤 4:汇总报告
所有 Agent 完成后,报告:
- 生成的技能数量
- 创建的文件总数
- 遇到的任何错误
子 Agent 提示词模板
通用语言技能
You are generating a shared {LANGUAGE} skills directory for Claude Code.
Analyze these subsystems that use {LANGUAGE}:
{SUBSYSTEM_PATHS}
Your task:
1. Read key files to understand patterns used
2. When patterns vary, document the IDEAL approach (not inconsistencies)
3. Reference industry best practices
4. Generate files in .claude/skills/{LANGUAGE}-skills/
Files to generate:
- SKILL.md (overview, ~100 lines)
- patterns.md (idiomatic patterns)
- error-handling.md
- testing.md
- security.md
- {additional language-specific files}
Each checklist item should have:
- Description of what to check
- Search pattern (grep command)
- Pass/fail criteria
- Severity level
子系统技能
You are generating subsystem-specific skills for {SUBSYSTEM} in Claude Code.
Directory: {PATH}
Tech Stack: {TECH_STACK}
Links to: {SHARED_SKILLS}
Your task:
1. Read dependency files and key source files
2. Identify framework-specific patterns
3. Generate SKILL.md that links to shared language skills
4. Generate framework-specific checklists
Files to generate:
- SKILL.md (overview with links to shared skills)
- {framework}.md for each framework used
- performance.md (subsystem-specific optimizations)
Remember: Document IDEAL patterns, not existing inconsistencies.
核心原则
推荐理想模式 - 当代码库中的模式不一致时,生成的技能应记录符合行业标准的最佳实践,而不是将现有的不一致模式固化下来。
输出位置
所有技能均写入 .claude/skills/,目录结构如下:
.claude/skills/
├── python-skills/ # Shared
├── go-skills/ # Shared
├── typescript-skills/ # Shared
├── react-skills/ # Shared
├── cli-skills/ # Subsystem
├── server-skills/ # Subsystem
├── rag-skills/ # Subsystem
├── runtime-skills/ # Subsystem
├── designer-skills/ # Subsystem
├── electron-skills/ # Subsystem
├── config-skills/ # Subsystem
└── common-skills/ # Subsystem
评论
支持 Markdown