nonebot-dicepp

使用 DicePP Shell 工具进行交互式机器人指令验收。涉及用户可见指令、骰子结果、会话状态、多步骤流程、私聊/群聊差异或需要确认机器人实际回复时使用；开发验证时可由 auto-test-run 配合调用。

运行 DicePP Persona 真实 LLM 功能回归，客观验收生活模拟、主动消息、私聊多轮、群聊上下文、持久化和 trace。仅在用户显式调用本技能或明确要求 Persona 真实 LLM 回归时使用；不得自动触发，也不得由 subagent 自行调用。

代码审视清理——扫描变更中的遗留调试代码、废弃注释、无 backlog 引用的 TODO 等，一次确认后批量修改，跑通全量测试。

用当前 dev 源码在 5090 端口起一个 Dashboard 实例(默认仅本地 127.0.0.1,--expose 才绑 0.0.0.0),联动 dicepp-shell serve 常驻 Bot Runtime,做 Dashboard 开发联调验收。需要可视化 Dashboard 状态、调试控制通道、验证 Bot↔Dashboard 通信、测试 Dashboard 面板与真实 Bot 生命周期联动,或要在不碰生产 docker 栈的前提下用 --expose 临时把 Dashboard 暴露给外网查看时使用。

从 master 创建新的 feature 分支，基于 git worktree 实现环境隔离。

开发分支提交重组——分析、分组、walkthrough 确认、reset-soft 重提交、验证无内容丢失。不修改代码。

生成 DicePP 群分发整合离线包。Linux 整合包包含 NapCat (Docker 模板 + NapCat.Shell.zip)，Windows 整合包包含 LLOneBot 桌面包。当用户要求制作、更新或检查整合离线包，或提到 full offline bundle、群文件整合包时使用。

在 Linux 生产环境执行 DicePP 相关 Docker/Compose 运维动作。当用户要求查看服务状态、日志、pull/up/restart 容器、应用镜像或管理 DicePP/协议适配器（NapCat / LLOneBot）容器时使用。

在开发环境创建 DicePP 可部署版本。当用户要求发版、创建 release、上线前准备、递增版本、打 tag 或构建生产版本时使用；产出供生产 version-deploy 使用的 vX.Y.Z release。

在生产环境部署或回退 DicePP 已发布版本。当用户要求部署、上线、更新代码、切换版本、回退、rollback、pull 镜像或应用 release 时使用；消费开发环境 version-release 创建的 vX.Y.Z release。

使用 Persona 数据库 Inspection CLI 工具快速排查 persona 模块的 SQLite 数据问题。定位聚合画像查询，单表查询请直接用 sqlite3 CLI。

Read before every local git commit.

[Reviewer] Evaluate Defender's replies: reach consensus (已共识·实施 / 已共识·延后 / 已共识·否决), clarify 待澄清 items (需补充回复), or escalate to user arbitration. All Rn items must exit resolved — 待裁决 and bare 已共识 are forbidden outputs. Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R). Requires the user to explicitly provide the document path.

[Defender] Read a finalized review document, implement 已共识·实施 items after explicit user confirmation, and skip 已共识·存档 items. Refuse to proceed if any 需补充回复 or 待裁决 items exist. Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R). Requires the user to explicitly provide the document path.

[Reviewer] Analyze local git diff (with optional user-supplied extra scope) and produce a structured review document with numbered findings (R1, R2...). Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R).

[Reviewer] Re-examine actual code changes against the finalized review document and accept or return each 已共识·实施 item. On retry, carry forward 退回记录 history rather than overwriting. Returned items loop directly back to review4-execute. Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R). Requires the user to explicitly provide the document path.

根据汇报文件或用户给出的信息，新增 backlog 条目到 docs/dev/backlog.md。

核实和清理所有 backlog 条目，删除过时项，按时间重排序，并向用户汇报结果。

开始实现某一个 backlog 条目。独立诊断、重新思考方案、协助从 backlog 移除或重写条目。

当你需要了解 DicePP 项目结构、不清楚代码组织方式、或首次在此项目中工作时，调用此技能快速获取项目概览

复盘当前会话，识别项目工具链中的可改进点（脚本报错、环境不匹配、反复失败、绕弯路、技能指令不清等），默认在对话中汇报；仅在用户明确要求落盘时生成报告。

在准备新增、修改、重写测试，修复 bug 并添加回归测试，执行 TDD，补覆盖率，调整测试断言、fixture、mock、snapshot 或测试层级时主动使用。用于自动约束测试设计质量，避免弱断言、重复用例、过度 mock、实现细节测试、无价值覆盖率测试和维护成本过高的测试。通常不需要向用户报告，除非测试策略风险会影响实现选择。

完成代码、测试、配置、文档或 agent 改动后主动使用。根据 DicePP 改动风险选择最小可信验证范围，执行 pytest、dicepp-shell 或其他必要检查，并向用户汇报已运行、未运行和失败项；不得默认调用真实 LLM、外部 API、付费服务或高成本 e2e。

管理 DicePP agent 配置同步、环境识别、首次接管、后续同步、工作目录检查、rules/skills 投影与平台差异处理。需要调整或排查 .codex、.claude 中的 agent rules、skills、Claude Linux settings/hooks，新增、移动、重命名、删除 agent skill/rule，检查环境是否暴露了错误技能，或汇报当前 agent 配置状态时使用。

在开发环境中接收生产问题 handoff 时使用。用户提供 handoff 内容或路径后, 分析证据并决定直接诊断/修复、新增 backlog、要求补充生产信息或拆分任务；可在配置了 peer.prodRoot 时只读查看生产日志和证据, 但不得写入生产目录。

在生产环境中, 当用户已明确要求生成、创建、归档或交接生产问题 handoff, 且问题事实已和用户确认后使用。用于把生产问题整理为开发环境可接手的交接文档, 可在配置了 peer.devRoot 时写入开发环境 .temp/prod-handoff/, 但不得写入当前生产项目。

从当前 feature 分支创建 GitHub Pull Request，自动推送分支并填写标题/描述。

读取 GitHub Pull Request 的 diff，review 代码质量，执行 approve / request changes / merge 操作。

[User-guided] Walk through a diff or commit range one logical unit at a time, explaining what changed and why. Discuss concerns on the spot, record agreed decisions immediately with review_record.py. Produces a standard Rn document (with optional 用户明确 blocks) compatible with review2-reply through review5-accept. Can be used standalone or as an alternative to review1-raise.

[Defender] Read a review document and write/update the Reply section for each Rn in-place. Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R). Requires the user to explicitly provide the document path.

自动化治理项目测试质量。用于测试数量膨胀、低价值测试过多、断言薄弱、mock 过度、重复用例、测试层级混乱、flaky 测试、希望用 subagent 批量审计和自动改进测试资产的项目。触发后应自动发现测试框架、建立清单、增量审计、执行低风险改进、验证结果，并只在高风险操作时询问用户。