| name | dev-skills |
| description | 用户专属开发技能，包含中文沟通规范、代码提交流程及自动化构建部署指令。 |
Dev Skills
此技能定义了用户偏好的开发流程和规范。请在所有任务中严格遵守以下规则。
1. 沟通与文档 (Communication & Documentation)
- 核心原则：始终使用 中文 (Chinese) 与用户交流，无论是在对话中还是在生成的文档中。
- OpenSpec 与需求文档：
- 创建或更新 OpenSpec 需求文件（如
proposal.md, design.md 等）时，必须使用 中文。
task.md 和 implementation_plan.md 等工件也必须使用中文编写。
2. 计划与原理解释 (Planning & Rationale)
在进行任何功能开发或 Bug 修复 之前，必须先确定计划。
- 分级计划机制 (Tiered Planning)：
- 微小改动 (Trivial)：如拼写修复、样式微调。可以在对话中直接解释 Why/How，获得确认后执行。
- 常规任务 (Normal/Feature)：涉及逻辑变动。必须创建
implementation_plan.md。
- 主动询问原则：在开始执行前，Agent 必须询问用户：“此任务是否需要创建正式的实现计划文件？”。
- 创建/更新 Implementation Plan (若确定需要)：
- 使用
implementation_plan.md 详细列出修改计划。
- 核心内容必须包含：
- 为什么这么做 (Why)：解释修改的动机、根本原因 (Root Cause) 或设计思路。
- 准备怎么搞 (How)：详细的修改步骤、涉及的文件以及预期的效果。
- 为什么这么修改 (Rationale)：针对具体的代码变动，解释选择此实现方式的原因。
- 确认先行：在开始写代码之前，必须先让用户阅读并确认计划。
3. 代码提交规范 (Git Workflow)
- 语言要求：Git Commit Message 必须使用 中文。
- 格式规范：遵守 Conventional Commits 规范。
- 确认机制：
- 严禁自动提交：在执行
git commit 前，必须先询问用户。
- 流程：
git add <files>- 告知用户准备提交的文件，并提供拟定的 Commit Message。
- 获取用户明确确认后方可执行提交。
4. 自动化构建与重启流程 (Build & Restart Workflow)
当用户要求“编译”、“重启”、“运行”或“查看效果”时，请自动执行以下 连贯 流程。
推荐操作方式 (首选)：
- 优先使用重部署脚本：
- 直接执行项目根目录下的脚本：
bash scripts/redeploy.sh (或 redeploy-fast.sh)。
- 操作提示：在执行前告知用户正在执行的步骤。
5. 代码推送与 PR 流程 (Push & PR Workflow)
当用户要求“提交代码并发布”、“Push”或“创建 PR”时，遵循以下流程：
- 检查与切换分支 (Branching)：
- 根据任务内容（Feature/Fix）生成新分支名（例如
feat/xxx），并使用 git checkout -b <new_branch> 切换。
- 推送到远程 (Pushing)：
- 执行
git push -u origin <branch_name>。
- 创建 Pull Request (Automated PR)：
- 自动生成符合规范的 PR 标题和详细描述，并尝试使用
gh pr create 创建。
- 分支清理 (Cleanup)：
- 在 PR 合并或发布流程结束后，Agent 必须主动询问或提醒用户清理已完成的功能分支。
6. 数据库与提示词变更规范 (Database & Prompt Changes)
- 数据库变更 (Database Changes)：
- 执行边界 (Strict Boundary)：凡涉及数据库 Schema 或数据变更，Agent 仅负责在
db-prod/ 目录下创建 SQL 脚本。严禁自动执行 SQL 语句或通过 Python 脚本直接修改数据库。
- 命名规范：使用
V 开头 + 自增序号 + 描述（例如 V37-xxxx.sql）。
- 提示词变更 (Prompt Changes)：
- 凡涉及系统提示词 (Prompts) 的新增或更新，必须在
architech/prompts/ 下操作并进行版本控制。
- Agent 仅负责创建/更新文件，不负责自动同步到系统内部。
