---
description: 用户个人开发习惯（user-dev-style）- 本仓库内始终应用
alwaysApply: true
---

# 用户开发习惯（基线 · 始终应用）

在本仓库内，助手应**默认**按以下习惯工作，**无需**用户每轮都说「按我习惯」。**完整条目**见个人 Cursor 技能 **`user-dev-style`**（`~/.cursor/skills/user-dev-style/SKILL.md`）。冲突时：**用户当条消息 > 本文件与 SKILL > 其他一般建议**。

## Git 与 PR

- 提交说明与 PR 描述以**中文为主**；`type(scope): 中文描述`；正文用完整中文句（可与 `git-commit-zh` 并存，不冲突）。
- 不整段英文、不中英碎片硬拼。

## 代码与架构

- **分层分模块**、**最小必要改动**；不顺手大重构、不格式化无关文件。
- 与周边代码风格一致；优先复用现有抽象。
- Python：**`.venv`**；不提交 `.venv/`；`.env` 真密钥不入库，维护 `.env.example`。

## SeleniumBase / 爬虫

- 遵循专用技能 **`seleniumbase-cdp-scraping`**（若任务相关）；UC + `activate_cdp_mode`、步骤间 sleep、产出落盘 CSV/JSON 等。

## 流程

- **先对齐再改代码**（仓库另有「先对齐」规则时一并遵守）；用户写明跳过则可跳过。
- **验证后再声称完成**（测试/命令/日志等依据）；不假装已跑过。

## 工具、安全、任务

- **MCP**：先读 schema 再调用。
- **密钥与隐私**不入库、不当聊天示例。
- **Todo**：完成即标完成，不长期 `in_progress`。

## 书面与文档（总结 / 规划 / 日报）

- 默认**不主动新建** md；用户要总结/规划时：**短而全**；单日「一天一句」，跨日「日期区间 + `-` 分点」；**不把本周规划写进上周已完成**；默认**不用表格**（除非用户要）。
- 日报：非技术可读；若存在 **`日报/model/daily-report.md`** 则**以该团队模板为准**；**完成/产出各通常一句**、无考勤须**约 X h** 与**文首合计**（详见 **`daily-report`** 技能）。无模板时可用 **今日进展 / 今日收获 / 明日计划** 简版。
- 周报 / 上周总结：若存在 **`日报/model/weekly-report.md`** 则**以该团队模板为准**；轻量总结仍「一日一句」、跨日区间下分点；**按日期/时间顺序**、表格格内也宜短句，详见 **`weekly-summary`**。

## 需求与表述

- 范围不清时用**选择题**收口径；回复完整句、少套路收尾；代码引用与链接格式按 Cursor 规范。