doc77 CLAUDE.md

CLAUDE.md

Skill 选择策略

• 简单任务 — 如单行修复、小改动、纯问答、明确单一操作等，直接执行，无需调用 skill
• 复杂任务 — 如新功能开发、重构、bug 诊断、多文件改动、需要设计评审等，自动选择合适的 skill 来处理（如 brainstorming → writing-plans → test-driven-development 等），即使用户没有明确指定 skill

文档语言规范

本项目所有文档遵循以下语言规范：

• 专业名词 / 技术术语：使用 英文 原文（如 Node.js, Express, SQLite, MCP, SDK, API, CLI, SSE, JSON-RPC, TypeScript 等）
• 其余说明文字：使用 中文

术语对照示例

英文术语	说明
Node.js	运行时，不翻译
Express	Web 框架，不翻译
SQLite	数据库，不翻译
MCP (Model Context Protocol)	协议名称，保留英文
SDK	软件开发工具包，保留英文缩写
CLI	命令行接口，保留英文缩写
API	应用程序接口，保留英文缩写
SSE (Server-Sent Events)	服务端推送事件，保留英文缩写
JSON-RPC	协议，保留英文
TypeScript	编程语言，不翻译
Shadow / Shadow Copy	影子备份，可保留英文并附中文说明
Pre-flight Check	飞行前检查
Rollback	回滚
GC (Garbage Collection)	垃圾回收
safeMove	安全移动（函数名保留英文）
batch_operations	批量操作（函数名保留英文）
session_id	会话标识符（字段名保留英文）

编写原则

1. 技术名词首次出现时，可附中文注释说明，后续统一使用英文术语
2. 代码、命令、配置项、字段名、表名保持英文原文
3. 结构化内容（表格、列表）中的术语使用英文，描述性文字使用中文
4. 标题可根据内容性质使用中英混合

公开文档语言规范

项目支持多语言推广。公开文档的语言遵循以下规则：

• 英文（默认/权威版本）：README.md、CHANGELOG.md、package.json#description
• 中文翻译：README.zh-CN.md，通过顶部语言切换 badge 关联
• 内部设计文档（docs/design/、docs/planning/）：保持中文（面向中文开发团队）

隐私与安全规范

严禁将包含隐私数据的文件提交到 Git 仓库。 以下文件一律默认保留在本地，不得 git add、git commit 或 git push：

• 包含 token、API key、secret、password、access_key、private key 等认证凭据的任何文件
• 环境变量文件：.env、.env.local、.env.development、.env.production 等（.env.example 模板文件除外）
• 证书与密钥：*.pem、*.key、*.pfx、*.p12、*.cert、*.crt
• 任何 OAuth、AWS、GitHub token 等第三方服务凭据

原则

1. 默认本地 — 不确定是否包含敏感数据时，默认不提交

2. 模板替代 — 如需共享配置结构，提供 .example 模板文件（值用占位符）

3. 提交前隐私检查（强制） — 每次 git commit 前，必须对 git diff --cached 的内容执行隐私泄露扫描，检查是否包含以下敏感信息：

   类型	检测模式
   Token / API Key	sk-、ghp_、gho_、xox[bprs]-、AKIA、eyJ（JWT） 等前缀
   Password / Secret	password\s*[:=]、secret\s*[:=]、passwd
   手机号	1[3-9]\d{9}（中国手机号）
   邮箱	\S+@\S+\.\S+（非示例/占位邮箱，如 [email protected] 除外）
   私钥	-----BEGIN.*PRIVATE KEY-----、-----BEGIN RSA PRIVATE KEY-----
   内网地址	192\.168\.、10\.\d{1,3}\.\d{1,3}\.\d{1,3}、172\.(1[6-9]|2\d|3[01])\.