config-reader

cruzanstx 的头像作者 cruzanstx

使用 <daplug_config> 块从 CLAUDE.md 读取和管理 daplug 配置,并支持旧版回退和迁移。

📖 中文导读:使用 <daplug_config> 块从 CLAUDE.md 读取和管理 daplug 配置,并支持旧版回退和迁移。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: config-reader description: Read and manage daplug configuration from CLAUDE.md using blocks, with legacy fallback and migration support. allowed-tools: - Bash(python3:) - Bash(jq:) - Read

Daplug Config Reader

Centralized configuration reader/migrator for daplug settings stored in <daplug_config> blocks inside CLAUDE.md. Provides backwards compatibility with legacy plaintext settings and safe migrations.

When to Use This Skill

  • Any command/skill needs daplug settings (preferred agent, worktree dir, llms_txt dir, ai usage awareness, cli logs dir)
  • Before writing to CLAUDE.md for daplug settings
  • When a user asks to migrate or audit CLAUDE.md config

Config Format

<daplug_config>
preferred_agent: codex
worktree_dir: .worktrees/
llms_txt_dir: /storage/projects/docker/llms_txt
ai_usage_awareness: enabled
cli_logs_dir: ~/.claude/cli-logs/
</daplug_config>

Usage

PLUGIN_ROOT=$(jq -r '.plugins."daplug@cruzanstx"[0].installPath' ~/.claude/plugins/installed_plugins.json)
CONFIG_READER="$PLUGIN_ROOT/skills/config-reader/scripts/config.py"

Get Single Setting

python3 "$CONFIG_READER" get preferred_agent

Dump All Settings (JSON)

python3 "$CONFIG_READER" dump --json

Dump as ENV Vars

python3 "$CONFIG_READER" dump --env

Status / Verification

python3 "$CONFIG_READER" status
python3 "$CONFIG_READER" status --json

Check Legacy Settings

python3 "$CONFIG_READER" check-legacy

Migrate Legacy Settings

# Project and user
python3 "$CONFIG_READER" migrate --all

# Project only
python3 "$CONFIG_READER" migrate --project

# User only
python3 "$CONFIG_READER" migrate --user

Set a Setting

# Project scope
python3 "$CONFIG_READER" set worktree_dir ".worktrees/" --scope project

# User scope
python3 "$CONFIG_READER" set preferred_agent "codex" --scope user

Notes

  • Lookup order: project CLAUDE.md (repo root) → user ~/.claude/CLAUDE.md
  • Legacy plaintext settings are still supported but trigger warnings
  • Migrations create a timestamped backup before writing