Compétences plugin-settings
⚙️

plugin-settings

Sûr ⚡ Contient des scripts📁 Accès au système de fichiers⚙️ Commandes externes

使用 YAML 前matter模式配置插件设置

Également disponible depuis: davila7,anthropics

插件设置可以存储在 .claude/plugin-name.local.md 文件中,使用 YAML 前matter和markdown。这种模式支持每个项目的插件配置、状态持久化以及用户可自定义的行为,无需复杂的数据库或配置文件。

Prend en charge: Claude Codex Code(CC)
🥉 76 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "plugin-settings". 创建一个设置文件,使用严格验证模式启用我的插件

Résultat attendu:

  • 设置文件已创建于 .claude/my-plugin.local.md
  • 配置:enabled=true, mode=strict, max_file_size=1000000
  • 要修改:请编辑文件并重启 Claude Code
  • 文件会自动被 gitignore

Utilisation de "plugin-settings". 配置我的插件以允许 JavaScript 和 TypeScript 文件,大小限制为 2MB

Résultat attendu:

  • 已使用新设置更新 .claude/my-plugin.local.md
  • 允许的扩展名:.js, .ts
  • 最大文件大小:2097152 字节
  • 重启 Claude Code 以使更改生效

Audit de sécurité

Sûr
v5 • 1/17/2026

Official Anthropic skill providing documentation on plugin settings pattern. Contains only educational content and utility scripts with safe bash practices including set -euo pipefail, file existence checks, and proper input validation. No network access, no dangerous operations, no external dependencies beyond standard POSIX tools.

9
Fichiers analysés
2,264
Lignes analysées
3
résultats
5
Total des audits

Score de qualité

64
Architecture
100
Maintenabilité
85
Contenu
21
Communauté
100
Sécurité
96
Conformité aux spécifications

Ce que vous pouvez construire

添加可配置行为

使用户能够通过设置文件自定义插件行为,而不是使用硬编码的默认值

跟踪代理状态

存储代理任务分配、迭代计数和协调器会话信息,跨会话保持

创建功能标志

无需修改插件代码即可启用或禁用插件功能

Essayez ces prompts

启用我的插件
创建一个 .claude/my-plugin.local.md 文件,使用标准模式和日志启用功能来启用我的插件
读取插件设置
检查 .claude/my-plugin.local.md 是否存在,并从前matter中读取 enabled 和 mode 字段
更新迭代计数器
更新 .claude/ralph-loop.local.md 中的 iteration 字段,从当前值递增
验证设置文件
验证 .claude/my-plugin.local.md 是否具有有效的 frontmatter,且 enabled 字段设置为 true

Bonnes pratiques

  • 当设置文件不存在时,始终提供合理的默认值
  • 使用快速退出模式在插件未配置时跳过钩子处理
  • 将 .claude/*.local.md 添加到项目的 .gitignore,以防止提交用户设置

Éviter

  • 不要对设置文件使用硬编码的绝对路径(应使用相对路径如 .claude/plugin-name.local.md)
  • 不要在读取设置前跳过文件存在性检查
  • 不要使用非原子性的文件更新,这可能会在中断时损坏设置

Foire aux questions

哪些工具支持此模式?
插件设置适用于 Claude、Codex 和 Claude Code。.claude 目录模式是 Claude Code 插件的原生的。
设置文件的大小限制是多少?
设置文件使用标准 markdown。没有硬性限制,但为了最佳钩子性能,请将文件保持在 1MB 以下。
如何与现有插件集成?
将设置文件创建添加到您的插件命令中,并将设置读取添加到您的钩子中。使用快速退出模式以保持向后兼容性。
设置文件安全吗?
设置文件存储在 .claude 目录中,这是用户本地的。始终在写入设置前验证和清理输入。添加到 .gitignore 以防止意外提交。
为什么我的更改不生效?
设置更改需要重启 Claude Code。钩子无法在会话中热切换。使用 'claude' 命令退出并重启。
这与 CLAUDE.md 相比如何?
CLAUDE.md 用于项目范围的上下文。.claude/*.local.md 用于插件特定的设置。使用 local.md 进行插件配置,CLAUDE.md 用于一般项目文档。