القائمة
Read before every local git commit.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
使用 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 重提交、验证无内容丢失。不修改代码。
| name | git-commit-brief |
| description | Read before every local git commit. |
统一遵循 Conventional Commits: <type>(<scope>): <一句话主题>
git log 读者一眼看出本次代码改动本身的内容| Type | 含义 |
|---|---|
feat | 新功能 |
fix | Bug 修复 |
refactor | 重构（不改变外部行为） |
docs | 纯文档变更 |
chore | 杂项维护（不改变功能逻辑的琐事：配置清理、依赖更新、backlog 整理、CI 调整等） |
| Scope | 适用范围 |
|---|---|
persona | persona 模块（角色卡、AI、对话、评分、prompt 等） |
core | 核心框架（bot/command/data/db/adapter） |
module | 其他功能模块（roll/deck/character/initiative/query/common） |
test | 测试基础设施（框架、fixture、配置、用例拆分等） |
dev | 开发环境/工具链（worktree/venv/Docker/shell/CI/配置） |
agent | Agent 配置与技能文件（docs/agent/rules/、docs/agent/skills-*/、docs/agent/sync.py） |
docs | 文档（架构、开发指南等） |
不确定 scope 时，选影响最大的模块作为 scope。
docs/agent/sync.py 生成；提交前避免把同步产生的本地工作目录状态重复计入，按真实源目录 docs/agent/* 核对后再暂存.review 闭环、review 反馈修复、R1/R2/R4、处理 review 反馈 N 项(B-260507-d3cc8b)xxx v4 + review 反馈修复, 把"主修改 + 流程修复"塞一起处理 review 反馈、完成 review、闭环 这类只描述"流程节点"而非代码本身(#NN) 是 GitHub squash merge 自动追加的 PR 号, 不在禁止之列; 但人手写 commit 时不要主动加.feat: persona 好感度阶段-想念-衰减联动重构 (review 闭环) (#19) → 正例 feat(persona): persona 好感度阶段-想念-衰减联动重构 (#19)feat: 事件生成 LLM 超时策略与 fallback delta 兜底 (B-260507-d3cc8b) → 正例 feat(persona): 事件生成 LLM 超时策略与 fallback delta 兜底feat: persona 分段回复 v4 + review 反馈修复 → 正例 合并写为对修改本身的描述, 如 feat(persona): persona 分段回复支持 XXX 与 YYY 修正fix: 处理 review 反馈四项 → 正例 描述具体修了什么, 如 fix(persona): 修正 share_desire 阈值边界fix: worktree 环境隔离修复 → 正例 fix(dev): worktree 环境隔离修复test: unittest.TestCase 迁移为 pytest 风格 → 正例 refactor(test): unittest.TestCase 迁移为 pytest 风格反例 / 正例、错 / 对.