docs: add versioning and commit scope conventions to AGENTS.md

- All distribution targets share root package.json version (lock-step)
- Commit scope: free-form for shared changes, platform scope (electron/
  cli/web) only when the change is platform-specific
This commit is contained in:
digua committed 2026-05-18 22:58:00 +08:00
1 parent 620ae40d45
commit 1536e241fc
1 file changed
+2
+2
View File
@@ -1,5 +1,7 @@
- 文档:开始开发前,请先查看 `./.docs/README.md`,并阅读与当前需求相关的文档
- 目标:用最小改动快速交付正确、可维护、可回归的业务结果
- 边界:只解决当前需求,不做与需求无关的重构和"顺手优化"
- 每次完成任务后,对产生修改的文件进行类型检查、lint检查和format格式化,指定修改的文件路径去执行,确保代码质量
- 在执行检查时,如果有其他与本次修改无关的报错,也需要一并修复
- 多语言:代码中的日志、注释、AI 工具描述、错误消息等非 UI 文本默认使用英文。当有运行时 locale 可用时(如工具返回结果、AI 看到的文本),应通过 `isChineseLocale(locale)` 等机制支持中英双语。数据清洗中与聊天平台格式匹配的标签(如 `[分享]`、`[图片]`)保持原始语言不变。UI 文案的国际化遵循 `.docs/rules/i18n.md`
- Commit 规范:使用 Conventional Commits。scope 规则——通用改动 scope 随意(如 `ai`、`import`、`sidebar` 等模块名);仅当改动是**平台特有**时才使用平台 scope(`electron`、`cli`、`web`)。