---
name: pdlc-settings
description: 交互式配置 PDLC：状态栏 statusline 的启用/停用/展示项，以及项目级护栏 hooks 的开关
argument-hint: "[statusline | status | hooks [on|off|status]]"
allowed-tools: Read, Edit, Write, Bash, Glob
layer: 3
stage: ops
produces: []
requires: []
next_step: null
terminal_state: null
# 只对 Claude Code 有用：通用安装器 npx skills 见到 internal 默认不列出、不安装
metadata:
  internal: true
---

# PDLC 交互式设置

以**交互菜单**方式配置 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`。按以下顺序找**第一个存在**的副本作为符号链接源，
**优先稳定源**（升级不改路径）：

1. `~/.claude/plugins/marketplaces/pdlc-skills/bin/pdlc-statusline.sh` （marketplace 克隆，最稳）
2. `${CLAUDE_PLUGIN_ROOT}/bin/pdlc-statusline.sh` （当前插件根，若该环境变量存在）
3. 最新版本缓存：`ls -d ~/.claude/plugins/cache/pdlc-skills/pdlc/*/bin/pdlc-statusline.sh | sort -V | tail -1`（按版本号取最大，不按修改时间：升级时旧版本目录的修改时间可能反而更新）

用 Bash 依次探测，记下命中的路径记为 `$SL`。都找不到 → 提示用户先 `claude plugin install pdlc@pdlc-skills` 再来。

## 动作一：状态栏 · 启用

1. **建稳定链接**：`bash "$SL" --install`
   - 它在固定路径 `~/.claude/pdlc-statusline` 建符号链接指向 `$SL`（升级后重跑本命令即重指，用户侧命令不变）。
2. **读现有状态栏命令**：读 `~/.claude/settings.json`（不存在则视为 `{}`）。取 `.statusLine.command`（可能为空）。
3. **幂等计算新命令**：
   - 若现有命令已包含 `pdlc-statusline`（任意形式）→ 告知「已接线，无需重复」，转去「展示项」或结束。
   - 否则新命令 = `<现有命令>; ~/.claude/pdlc-statusline`（现有为空则新命令就是 `~/.claude/pdlc-statusline`）。
   - 若 `.statusLine` 不存在，需同时补 `"statusLine": { "type": "command", "command": "<新命令>" }`。
4. **备份 + 展示 diff**：把 `~/.claude/settings.json` 复制为 `~/.claude/settings.json.pdlc-bak`（已存在则加时间戳后缀）。
   向用户展示将要变更的**那一行** diff（旧 command → 新 command）。
5. **确认后写入**：用户确认 → 用 Edit/Write 写回 `settings.json`（保持其余字段与格式不变）。
6. **写入被拦截 / 失败时优雅降级**（关键）：
   - **不谎报已启用**。明确告知：「写全局 settings.json 被安全层拦截。已备份到 `<bak>`。
     请把 `~/.claude/settings.json` 的 `statusLine.command` 手动改为：」，并给出**完整新命令原文**一行，供用户复制粘贴。
7. **预览**：调用一次脚本渲染当前项目状态给用户看：
   `printf '{"workspace":{"current_dir":"%s"}}' "$PWD" | bash "$SL"`
   （当前项目非 PDLC / 无状态文件则为空，属正常。）
8. 提示：状态栏是**每个终端会话/刷新**生效，可能需重开会话或等下次刷新。

## 动作二：状态栏 · 停用

1. 读 `.statusLine.command`。若不含 `pdlc-statusline` → 告知「未接线，无需停用」。
2. **只摘自己那段**：从命令串里去掉 `; ~/.claude/pdlc-statusline`（及等价的仅本段情形；若本段是唯一内容则清空 command 或移除 statusLine——按用户意愿）。**绝不动**用户其它命令片段。
3. 备份 → 展示 diff → 确认 → 写入；**被拦截同样降级**为「请手动改回：`<旧命令去掉本段后的值>`」。
4.（可选）询问是否一并 `bash "$SL" --uninstall` 移除稳定链接。

## 动作三：状态栏 · 展示项

交互勾选，写入配置文件（**不碰 settings.json**，无 gate 风险）：

1. 逐项询问（回车用默认）：

   | 项 | 键 | 默认 |
   |---|---|---|
   | 迷你进度条 | `show_progress_bar` | on |
   | 下一步 | `show_next` | on |
   | 运行态图标 | `show_run_icon` | on |
   | 检查结果（auto=仅 autonomous 显） | `show_checks` | auto |
   | 停留时长（auto=blocked/autonomous 显） | `show_elapsed` | auto |
   | 显示完整 ID（否则仅功能名） | `show_full_id` | off |
   | 多 feature 选谁（auto/latest/具体 ID） | `pick_feature` | auto |
   | 颜色 | `color` | on |

2. 询问写全局还是项目级：
   - 全局：`~/.claude/pdlc-statusline.json`
   - 项目级（覆盖全局）：`<当前项目>/docs/.pdlc-state/statusline.json`
3. 用 Write 写入选定 JSON（参考 `references/templates/pdlc-statusline.example.json` 的键）。这两个文件不受安全层 gate（非 settings.json）。
4. **当场预览**：同上用脚本渲染一行给用户确认效果。

## 动作四：状态栏 · 状态

只读、不改任何东西：

1. 是否已接线：读 `.statusLine.command`，报告是否含 `pdlc-statusline`。
2. 稳定链接：`~/.claude/pdlc-statusline` 是否存在、指向哪。
3. 生效配置：合并 `~/.claude/pdlc-statusline.json` 与项目级 `docs/.pdlc-state/statusline.json`（后者覆盖），列出各项当前值（缺省即默认）。
4. 预览：渲染当前项目一行。

## 动作五：护栏 · 开关

开关写在**当前项目**的 `docs/00_standards/pdlc-hooks.yml`（随仓库提交、团队共享），**不碰 `settings.json`**：
插件的 hooks 随插件启用就已注册，脚本 `bin/pdlc-guard.sh` 每次先读这个文件，没有它或对应项不是 `on` 就直接放行。

1. 确认当前目录是 PDLC 项目（有 `docs/`）；不是就说明并结束，不替用户建目录
2. **开启**：
   - 文件不存在 → 以 `assets/pdlc-hooks-template.yml` 为模板写入（两项默认都是 `on`）；用户只想开一项时把另一项改成 `off`
   - 文件已存在 → 只改用户要动的那一项，其余内容与注释原样保留
3. **关闭**：把两项改成 `off`（保留文件，方便以后再开）；用户明确要求时才删除文件
4. 写之前把将要变更的内容展示给用户，确认后再写；重复执行幂等
5. 告知两件事：
   - 只在 Claude Code 里生效；Codex 等工具没有这套 hooks，状态推进仍靠 skill 里的 `scripts/pdlc-advance.sh`
   - 这是护栏不是沙箱：在 Bash 里用重定向写状态文件拦不到，收尾体检会兜底

## 动作六：护栏 · 状态

只读：读 `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:

1. **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.**

2. **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.

3. **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.

4. **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