Habilidades plugin-settings
⚙️

plugin-settings

Seguro ⚡ Contém scripts📁 Acesso ao sistema de arquivos⚙️ Comandos externos

使用 YAML frontmatter 模式設定外掛設定

Também disponível em: anthropics,davila7

外掛設定可以使用 YAML frontmatter 和 markdown 儲存在 .claude/plugin-name.local.md 檔案中。此模式可實現每個專案的外掛設定、狀態持久化，以及使用者可自訂的行為，而不需要複雜的資料庫或設定檔。

Suporta: Claude Codex Code(CC)
🥉 76 Bronze
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "plugin-settings". 建立一個設定檔，以嚴格驗證模式啟用我的外掛

Resultado esperado:

  • Settings file created at .claude/my-plugin.local.md
  • Configuration: enabled=true, mode=strict, max_file_size=1000000
  • To modify: edit file and restart Claude Code
  • File is automatically gitignored

A utilizar "plugin-settings". 設定我的外掛以允許 JavaScript 和 TypeScript 檔案，限制為 2MB

Resultado esperado:

  • Updated .claude/my-plugin.local.md with new settings
  • Allowed extensions: .js, .ts
  • Maximum file size: 2097152 bytes
  • Restart Claude Code for changes to take effect

Auditoria de Segurança

Seguro
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
Arquivos analisados
2,264
Linhas analisadas
3
achados
5
Total de auditorias

Fatores de risco

⚡ Contém scripts (3)
scripts/parse-frontmatter.sh:1-60 scripts/validate-settings.sh:1-102 examples/read-settings-hook.sh:1-66
📁 Acesso ao sistema de arquivos (2)
scripts/parse-frontmatter.sh:30-35 scripts/validate-settings.sh:26-38
⚙️ Comandos externos (2)
scripts/parse-frontmatter.sh:37-51 SKILL.md:139-171
Auditado por: claude Ver Histórico de Auditoria →

Pontuação de qualidade

64
Arquitetura
100
Manutenibilidade
85
Conteúdo
21
Comunidade
100
Segurança
96
Conformidade com especificações

O Que Você Pode Construir

新增可設定行為

透過設定檔而非硬編碼預設值，讓使用者自訂外掛行為

追蹤代理程式狀態

儲存跨會話的代理程式任務分配、迭代計數器和協調器會話資訊

建立功能旗標

啟用或停用外掛功能，而無需修改外掛程式碼

Tente Estes Prompts

啟用我的外掛 
建立一個 .claude/my-plugin.local.md 檔案，以標準模式和日誌記錄啟用我的外掛
讀取外掛設定 
檢查 .claude/my-plugin.local.md 是否存在，並從 frontmatter 讀取 enabled 和 mode 欄位
更新迭代計數器 
更新 .claude/ralph-loop.local.md 中的 iteration 欄位，從目前值遞增
驗證設定檔 
驗證 .claude/my-plugin.local.md 具有有效的 frontmatter，且 enabled 欄位設定為 true

Melhores Práticas

  • 當設定檔不存在時，始終提供合理的預設值
  • 使用快速退出模式，在外掛未設定時跳過鉤子處理
  • 將 .claude/*.local.md 新增至專案 .gitignore，以防止提交使用者設定

Evitar

  • 不要對設定檔使用絕對路徑（請使用相對路徑，例如 .claude/plugin-name.local.md）
  • 不要在讀取設定前跳過檔案存在性檢查
  • 不要使用非原子性的檔案更新，這可能會在中断時損壞設定

Perguntas Frequentes

哪些工具支援此模式？
外掛設定適用於 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 用於一般專案文件。

Detalhes do Desenvolvedor

Licença

MIT

Repositório

https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/plugin-settings

Referência

main

Estrutura de arquivos

📁 examples/

📄 create-settings-command.md

📄 example-settings.md

📄 read-settings-hook.sh

📁 references/

📄 parsing-techniques.md

📄 real-world-examples.md

📁 scripts/

📄 parse-frontmatter.sh

📄 validate-settings.sh

📄 SKILL.md