Drupal开发指南集成器：自动加载TDD、SOLID、DRY等架构方法论与最佳实践

guide-integrator by camoa/claude-skills

1 周安装量

17 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/camoa/claude-skills --skill guide-integrator

方法论开发代码质量

🇨🇳中文介绍

指南集成器

加载开发参考资料并集成到架构文档中。三种来源：插件方法论参考、在线开发指南和用户自定义指南。

内置参考资料（方法论）

主题	参考文件
测试驱动开发	`references/tdd-workflow.md`
SOLID 原则	`references/solid-drupal.md`
DRY 模式	`references/dry-patterns.md`
库优先/CLI优先	`references/library-first.md`
质量门禁	`references/quality-gates.md`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

插件参考资料（方法论）

从插件的 references/ 文件夹加载：

检测到的关键词	要加载的参考
"test"、"TDD"、"unit test"、"kernel test"	`references/tdd-workflow.md`
"service"、"dependency"、"inject"、"SOLID"	`references/solid-drupal.md`
"duplicate"、"reuse"、"DRY"、"extract"	`references/dry-patterns.md`
"form"、"drush"、"command"、"service first"	`references/library-first.md`
"complete"、"done"、"quality"、"gate"	`references/quality-gates.md`

用户自定义指南（可选）

如果用户在 project_state.md 中配置了 guides_path，则根据文件名中的关键词在配置的路径中搜索相关文件。

1. 加载插件参考资料（方法论）

基于任务中检测到的关键词：

确定哪些方法论参考资料适用（参见自动加载规则）
读取每个适用的参考文件
提取与当前任务相关的模式

2. 获取在线开发指南

对于 Drupal 特定的架构决策：

通过 WebFetch 获取 https://camoa.github.io/dev-guides/llms.txt 以发现可用主题
将任务关键词与主题列表以及可能相关主题提示进行匹配
通过 WebFetch 获取决策指南索引的相关主题页面
通过 WebFetch 获取模式和最佳实践的特定原子指南

仅获取与当前任务相关的主题——而非所有主题。

3. 检查自定义指南（可选）

读取 {project_path}/project_state.md 并查找 **Guides Path:** {path}。

如果已配置：使用 Glob 匹配 {guides_path}/*.md，将文件名与任务关键词匹配，加载匹配项。如果未配置：仅继续使用插件参考资料和开发指南。

4. 提取适用模式

从所有加载的来源中，识别：

适用于当前功能的模式
需要遵循的检查清单
警告或反模式
推荐的方法

使用 Edit 将参考资料部分添加到架构文件：

## 开发参考资料

### 插件参考资料（方法论）
| 参考 | 关键模式 |
|-----------|--------------|
| solid-drupal.md | 单一职责、依赖注入 |
| library-first.md | 服务 → 表单 → 路由 |
| tdd-workflow.md | 红-绿-重构 |

### 应用的开发指南（Drupal 领域）
| 主题 | 关键决策 |
|-------|--------------|
| drupal/forms/ | ConfigFormBase 与 FormBase |
| drupal/entities/ | 内容实体与配置实体 |

### 应用的自定义指南（如有）
| 指南 | 相关章节 |
|-------|-------------------|
| {user_guide}.md | {sections} |

### 执行点
| 阶段 | 原则 | 来源 |
|-------|-----------|--------|
| 设计 | 库优先 | references/library-first.md |
| 设计 | SOLID | references/solid-drupal.md |
| 设计 | Drupal 模式 | dev-guides (在线) |
| 实现 | TDD | references/tdd-workflow.md |
| 实现 | DRY | references/dry-patterns.md |
| 完成 | 质量门禁 | references/quality-gates.md |
| 完成 | 安全 | dev-guides drupal/security/ |

告知用户从每个来源集成了什么：插件方法论、开发指南主题和自定义指南。

类型	位置
插件参考资料（方法论）	`{plugin_path}/references/*.md`
开发指南（Drupal 领域）	`https://camoa.github.io/dev-guides/`
自定义指南	用户配置的 `guides_path`

停止并询问用户：

如果多个自定义指南可能适用（询问优先使用哪个）
如果自定义指南路径已配置但未找到文件
在添加与现有架构冲突的模式之前

🇺🇸English

Guide Integrator

Load development references and integrate into architecture documents. Three sources: plugin methodology refs, online dev-guides, and user's custom guides.

Built-in References (Methodology)

Topic	Reference File
Test-Driven Development	`references/tdd-workflow.md`
SOLID Principles	`references/solid-drupal.md`
DRY Patterns	`references/dry-patterns.md`
Library-First/CLI-First	`references/library-first.md`
Quality Gates	`references/quality-gates.md`
Purposeful Code	`references/purposeful-code.md`

Online Dev-Guides

For Drupal domain knowledge beyond bundled references, fetch the guide index:

Index: https://camoa.github.io/dev-guides/llms.txt

Likely relevant topics: forms, config-forms, entities, plugins, routing, services, caching, config-management, render-api, security, sdc, js-development, views, blocks, layout-builder, media, migration, recipes, taxonomy, jsonapi, image-styles, icon-api, eca, github-actions, ai-content, custom-field, klaro, testing, tdd, solid-principles, dry-principles

Usage: WebFetch the index to discover available topics, then fetch specific topic pages for decision guides, patterns, and best practices.

Activation

Activate when:

Designing features that match reference topics
User mentions specific patterns (TDD, SOLID, DRY)
Architecture drafting for any feature
Auto-triggered by architecture-drafter agent

Auto-Load Rules

Plugin References (Methodology)

Loaded from plugin's references/ folder:

Keywords Detected	Reference to Load
"test", "TDD", "unit test", "kernel test"	`references/tdd-workflow.md`
"service", "dependency", "inject", "SOLID"	`references/solid-drupal.md`
"duplicate", "reuse", "DRY", "extract"	`references/dry-patterns.md`
"form", "drush", "command", "service first"	`references/library-first.md`
"complete", "done", "quality", "gate"	`references/quality-gates.md`

User's Custom Guides (Optional)

If user has configured a guides_path in project_state.md, search the configured path for relevant files based on keywords in filenames.

Workflow

1. Load Plugin References (Methodology)

Based on detected keywords in the task:

Identify which methodology references apply (see Auto-Load Rules)
Read each applicable reference file
Extract patterns relevant to current task

2. Fetch Online Dev-Guides

For Drupal-specific architecture decisions:

WebFetch https://camoa.github.io/dev-guides/llms.txt to discover available topics
Match task keywords against the topic list and the likely relevant topics hint
WebFetch the relevant topic page for the decision guide index
WebFetch specific atomic guides for patterns and best practices

Only fetch topics relevant to the current task — not all topics.

3. Check for Custom Guides (Optional)

Read {project_path}/project_state.md and look for **Guides Path:** {path}.

If configured: Glob {guides_path}/*.md, match filenames to task keywords, load matches. If not configured: continue with plugin refs and dev-guides only.

4. Extract Applicable Patterns

From all loaded sources, identify:

Patterns that apply to current feature
Checklists to follow
Warnings or anti-patterns
Recommended approaches

5. Add to Architecture

Use Edit to add references section to architecture file:

## Development References

### Plugin References (Methodology)
| Reference | Key Patterns |
|-----------|--------------|
| solid-drupal.md | Single responsibility, DI |
| library-first.md | Service → Form → Route |
| tdd-workflow.md | Red-Green-Refactor |

### Dev-Guides Applied (Drupal Domain)
| Topic | Key Decisions |
|-------|--------------|
| drupal/forms/ | ConfigFormBase vs FormBase |
| drupal/entities/ | Content entity vs config entity |

### Custom Guides Applied (if any)
| Guide | Relevant Sections |
|-------|-------------------|
| {user_guide}.md | {sections} |

### Enforcement Points
| Phase | Principle | Source |
|-------|-----------|--------|
| Design | Library-First | references/library-first.md |
| Design | SOLID | references/solid-drupal.md |
| Design | Drupal patterns | dev-guides (online) |
| Implement | TDD | references/tdd-workflow.md |
| Implement | DRY | references/dry-patterns.md |
| Complete | Quality Gates | references/quality-gates.md |
| Complete | Security | dev-guides drupal/security/ |

6. Summarize

Tell user what was integrated from each source: plugin methodology, dev-guides topics, and custom guides.

Reference Locations

Type	Location
Plugin references (methodology)	`{plugin_path}/references/*.md`
Dev-guides (Drupal domain)	`https://camoa.github.io/dev-guides/`
Custom guides	User-configured `guides_path`

Stop Points

STOP and ask user:

If multiple custom guides could apply (ask which to prioritize)
If custom guide path is configured but no files found
Before adding patterns that conflict with existing architecture

Weekly Installs

Repository

camoa/claude-skills

GitHub Stars

First Seen

Today

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

109,600 周安装