pdlc-settings
交互式配置 PDLC(当前:状态栏 statusline 的启用/停用/展示项)
SKILL.mdskills/pdlc-settings/SKILL.md
GitHubPDLC 交互式设置
以交互菜单方式配置 PDLC,让用户少敲命令行。包含两节:
- 状态栏(statusline):把 PDLC 运行状态(当前功能 / 阶段 / 下一步 / 检查 / blocked)显示到 Claude Code 底部状态栏
- 护栏(hooks):在当前项目开关插件自带的两个 Claude Code hooks——拦下直接写状态文件、收尾时体检本次改动的状态文件
⚠️ 安全底线:本命令会读写用户全局
~/.claude/settings.json(高影响)。任何写入前必须: 先备份 → 展示 diff → 用户确认。写全局配置可能被 Claude Code 安全层拦截——届时不谎报成功, 优雅降级为「已算好这一行,请你确认后手动粘贴」。重复运行幂等,绝不覆盖用户其它配置。
交互入口
根据本命令的参数分派;参数为空则显示主菜单:
⚙️ PDLC 设置
1) 状态栏 · 启用 在状态栏独占一行显示 PDLC 状态
2) 状态栏 · 停用 从状态栏移除本段(不动你其它配置)
3) 状态栏 · 展示项 勾选显示哪些内容(进度条/检查/停留时长…)
4) 状态栏 · 状态 查看当前是否已接线 + 生效配置 + 预览
5) 护栏 · 开关 在当前项目开启 / 关闭 PDLC hooks
6) 护栏 · 状态 查看当前项目的护栏开关
请选择(1-6):
- 参数以
hooks开头 →hooks on/hooks off直接走「护栏 · 开关」,hooks status或只有hooks走「护栏 · 状态」 - 参数含
status→ 直接走「状态栏 · 状态」 - 参数含
statusline→ 进入状态栏子菜单 - 否则显示上面主菜单,等用户选
定位脚本(稳定源优先)
接线依赖状态栏脚本 bin/pdlc-statusline.sh。按以下顺序找第一个存在的副本作为符号链接源,
优先稳定源(升级不改路径):
~/.claude/plugins/marketplaces/pdlc-skills/bin/pdlc-statusline.sh(marketplace 克隆,最稳)${CLAUDE_PLUGIN_ROOT}/bin/pdlc-statusline.sh(当前插件根,若该环境变量存在)- 最新版本缓存:
ls -d ~/.claude/plugins/cache/pdlc-skills/pdlc/*/bin/pdlc-statusline.sh | sort -V | tail -1(按版本号取最大,不按修改时间:升级时旧版本目录的修改时间可能反而更新)
用 Bash 依次探测,记下命中的路径记为 $SL。都找不到 → 提示用户先 claude plugin install pdlc@pdlc-skills 再来。
动作一:状态栏 · 启用
- 建稳定链接:
bash "$SL" --install- 它在固定路径
~/.claude/pdlc-statusline建符号链接指向$SL(升级后重跑本命令即重指,用户侧命令不变)。
- 它在固定路径
- 读现有状态栏命令:读
~/.claude/settings.json(不存在则视为{})。取.statusLine.command(可能为空)。 - 幂等计算新命令:
- 若现有命令已包含
pdlc-statusline(任意形式)→ 告知「已接线,无需重复」,转去「展示项」或结束。 - 否则新命令 =
<现有命令>; ~/.claude/pdlc-statusline(现有为空则新命令就是~/.claude/pdlc-statusline)。 - 若
.statusLine不存在,需同时补"statusLine": { "type": "command", "command": "<新命令>" }。
- 若现有命令已包含
- 备份 + 展示 diff:把
~/.claude/settings.json复制为~/.claude/settings.json.pdlc-bak(已存在则加时间戳后缀)。 向用户展示将要变更的那一行 diff(旧 command → 新 command)。 - 确认后写入:用户确认 → 用 Edit/Write 写回
settings.json(保持其余字段与格式不变)。 - 写入被拦截 / 失败时优雅降级(关键):
- 不谎报已启用。明确告知:「写全局 settings.json 被安全层拦截。已备份到
<bak>。 请把~/.claude/settings.json的statusLine.command手动改为:」,并给出完整新命令原文一行,供用户复制粘贴。
- 不谎报已启用。明确告知:「写全局 settings.json 被安全层拦截。已备份到
- 预览:调用一次脚本渲染当前项目状态给用户看:
printf '{"workspace":{"current_dir":"%s"}}' "$PWD" | bash "$SL"(当前项目非 PDLC / 无状态文件则为空,属正常。) - 提示:状态栏是每个终端会话/刷新生效,可能需重开会话或等下次刷新。
动作二:状态栏 · 停用
- 读
.statusLine.command。若不含pdlc-statusline→ 告知「未接线,无需停用」。 - 只摘自己那段:从命令串里去掉
; ~/.claude/pdlc-statusline(及等价的仅本段情形;若本段是唯一内容则清空 command 或移除 statusLine——按用户意愿)。绝不动用户其它命令片段。 - 备份 → 展示 diff → 确认 → 写入;被拦截同样降级为「请手动改回:
<旧命令去掉本段后的值>」。 4.(可选)询问是否一并bash "$SL" --uninstall移除稳定链接。
动作三:状态栏 · 展示项
交互勾选,写入配置文件(不碰 settings.json,无 gate 风险):
逐项询问(回车用默认):
项 键 默认 迷你进度条 show_progress_baron 下一步 show_nexton 运行态图标 show_run_iconon 检查结果(auto=仅 autonomous 显) show_checksauto 停留时长(auto=blocked/autonomous 显) show_elapsedauto 显示完整 ID(否则仅功能名) show_full_idoff 多 feature 选谁(auto/latest/具体 ID) pick_featureauto 颜色 coloron 询问写全局还是项目级:
- 全局:
~/.claude/pdlc-statusline.json - 项目级(覆盖全局):
<当前项目>/docs/.pdlc-state/statusline.json
- 全局:
用 Write 写入选定 JSON(参考
references/templates/pdlc-statusline.example.json的键)。这两个文件不受安全层 gate(非 settings.json)。当场预览:同上用脚本渲染一行给用户确认效果。
动作四:状态栏 · 状态
只读、不改任何东西:
- 是否已接线:读
.statusLine.command,报告是否含pdlc-statusline。 - 稳定链接:
~/.claude/pdlc-statusline是否存在、指向哪。 - 生效配置:合并
~/.claude/pdlc-statusline.json与项目级docs/.pdlc-state/statusline.json(后者覆盖),列出各项当前值(缺省即默认)。 - 预览:渲染当前项目一行。
动作五:护栏 · 开关
开关写在当前项目的 docs/00_standards/pdlc-hooks.yml(随仓库提交、团队共享),不碰 settings.json:
插件的 hooks 随插件启用就已注册,脚本 bin/pdlc-guard.sh 每次先读这个文件,没有它或对应项不是 on 就直接放行。
- 确认当前目录是 PDLC 项目(有
docs/);不是就说明并结束,不替用户建目录 - 开启:
- 文件不存在 → 以
assets/pdlc-hooks-template.yml为模板写入(两项默认都是on);用户只想开一项时把另一项改成off - 文件已存在 → 只改用户要动的那一项,其余内容与注释原样保留
- 文件不存在 → 以
- 关闭:把两项改成
off(保留文件,方便以后再开);用户明确要求时才删除文件 - 写之前把将要变更的内容展示给用户,确认后再写;重复执行幂等
- 告知两件事:
- 只在 Claude Code 里生效;Codex 等工具没有这套 hooks,状态推进仍靠 skill 里的
scripts/pdlc-advance.sh - 这是护栏不是沙箱:在 Bash 里用重定向写状态文件拦不到,收尾体检会兜底
- 只在 Claude Code 里生效;Codex 等工具没有这套 hooks,状态推进仍靠 skill 里的
动作六:护栏 · 状态
只读:读 docs/00_standards/pdlc-hooks.yml,列出 state_write_guard、lint_on_stop 的当前值(文件不存在 = 两项都关)。
项目是 git 仓库时顺带说明:收尾体检只看 git status 里有改动的状态文件;不是 git 仓库时这一项不起作用。
要求
<!-- @include templates/prompts/output-language.md(已内联于下方,无需另读) -->🌐 Output language for generated artifacts
All generated artifacts (PRDs, design docs, code comments, review reports, test plans, deployment manuals, changelog entries, etc.) follow this policy:
Default — match the conversation language exactly:
- 用户用中文与 Claude 对话 → 产中文文档、中文代码注释、中文报告
- User talks to Claude in English → produce English artifacts
- User talks in another language → produce artifacts in that language
- Never silently default to a fixed language regardless of the user's input.
Explicit override always wins: when the user specifies a language for an artifact (e.g. "write the PRD in English", "用英文写 API 设计文档", "output the deploy doc in Japanese"), use that language for that artifact, regardless of conversation language.
Mixed-language requirements: if the user wants some artifacts in one language and others in a different language (common: Chinese PRD + English API docs for partners), honour each per-artifact instruction.
Uncertain: if you cannot reliably detect the conversation language, ask once before producing the first artifact.
This policy applies to content (prose, comments, headings). It does not override technical conventions like English variable names, English git commit subjects, or English error codes when the project's conventions require them.
<!-- @include-end templates/prompts/output-language.md -->- 只读脚本、不改状态机:本命令不读写
docs/.pdlc-state/<id>.json的业务字段,只读它们用于预览。护栏开关只写docs/00_standards/pdlc-hooks.yml。 - 写
settings.json必须备份 + diff + 确认;被 gate 时降级为「算好 + 用户粘贴」,严禁假装已写成功。 - 幂等:重复启用不叠加;停用只摘本段。
- 不安装依赖、不联网。jq 缺失时预览可能为空——如实告知,不阻断配置。
参数:$ARGUMENTS