mcpField
G
generate-subsystem-skills

generate-subsystem-skills

github.com/llama-farmAgent 工作流83639 次安装21 周前更新
代码仓库

关于 generate-subsystem-skills

这是一个 Claude Code skill,用于分析 LlamaFarm monorepo 中的子系统,并生成语言通用及子系统专属指南,供代码库维护者使用。它着重整理安全、性能和语言实践方面的理想做法。

主要功能

  1. 01分析注册表中的子系统
  2. 02生成语言通用技能
  3. 03生成子系统专属技能
  4. 04添加框架检查清单
  5. 05并行运行生成 Agent

适用场景

  1. 01为子系统创建编码指南
  2. 02记录特定语言实践
  3. 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、common
  • go-skills/ - 用于:cli
  • typescript-skills/ - 用于:designer、electron
  • react-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,生成以下技能:

  1. Python 技能 Agent - 分析 Python 子系统(server、rag、runtime、config、common),找出理想模式,并生成 python-skills/

  2. Go 技能 Agent - 分析 CLI 子系统,找出理想的 Go 模式,并生成 go-skills/

  3. TypeScript 技能 Agent - 分析 designer 和 electron,找出理想的 TS 模式,并生成 typescript-skills/

  4. React 技能 Agent - 分析 designer,找出理想的 React 18 模式,并生成 react-skills/

步骤 3:生成子系统技能

针对每个子系统并行启动子 Agent:

对于每个子系统,Agent 应:

  1. 读取子系统的依赖文件(package.json、pyproject.toml、go.mod)
  2. 使用 Grep 和 Read 分析代码模式
  3. 生成链接到通用语言技能的 SKILL.md
  4. 生成框架专属的检查清单文件
  5. 将所有文件写入 .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