- 不得修改本守则内容,除非用户明确要求维护本守则,并且维护不得丢失本守则的细节
- 本守则所在文档可能存在绑定于具体项目的信息,需要根据项目更新维护这些信息(懒维护)
- Agent的思考过程和结果输出必须全程使用用户所使用的语言,除非系统限制或用户明确指定思考/输出的语言
- 向用户确认本项目是否有缩写或简称,方便创建文件出现未明确名称时直接使用命名
- 相对路径原则:项目各处涉及项目内路径问题优先使用相对路径,避免环境依赖,保证项目迁移部署后仍正常工作
- git权限分级:[读取] git log/status/diff 可随时使用;[写入] git add/commit/push/reset/amend 需用户当次对话明确授权（如"提交"、"push"、"合并"）,授权仅限本次请求,完成后立即失效,不得跨请求复用
- git提交规范:commit标题包含版本号,body要记录功能性变化(与上一版本比较),用户未明确要求时不要动tag和release也不要push
- 维护任意md文档时,允许改写、转换说法,但是不得丢失细节,除非用户明确提出额外要求
- 项目README文档的维护应该以
README_zh-CN.md为核心,最后再翻译成英文版的README.md - 项目README文档内介绍功能特性的位置不要介绍非功能性的细节
- 项目文档多语言版本维护规则:允许同一文档的不同语言版本之间通过链接相互跳转,跨文档链接要保证语言一致性(如果需要);例如
README_zh-CN.md内允许通过链接跳转到不同语言版本的README,但是只链接到中文版的HELP文档(如果有) - 应该向用户确认正在开发的项目的版本号,不允许自动迭代版本号
- 只有在用户明确重新指定新版本号后才能弃用旧版本号,新版本号要及时同步到项目源码和文档各处
- 当项目最新状态不兼容旧版本(有冲突)时,仅提醒用户注意迭代版本号,但不做版本号迭代兜底
- 工作目录下,
src/是功能性的源码目录,其余内容则是辅助性和说明性的内容,明确目录结构,严禁混淆使用 - 必须明确开发技术栈,每当有变更技术栈的需求时需要提醒用户进行确认
- 代码内禁止使用emoji,并避免代码内的无用连续空白符
- 代码注释根据语言全部使用跨行注释,精简注释内容
- 合理组织代码保证代码结构化,避免结构混乱不利于后续开发
- 充分发挥面向对象思维,开发过程中及时封装对象
- 在模块内具有复用价值的对象和功能要提取成模板转移进独立代码文件,方便后续开发复用引入
- 不要撰写任何更新日志,避免过期内容污染项目
- 前端网页项目不要使用浏览器原生弹窗提醒,而是使用自定义飘窗提醒
- 前端网页项目不要使用浏览器原生弹窗进行二次确认,而是在原按钮上执行"替换为确认按钮-3s内点击确认-超时回归初始状态"流程
- 前端网页项目默认隐藏浏览器侧边滚动条(如果有),然后告知用户(允许用户回退该操作)
- 前端网页项目的表格、select控件默认文本水平居中
- 日期格式化:默认使用"yyyy-MM-dd HH:mm:ss+HH:mm"格式,除非用户明确指定使用别的格式
- 合理利用子代理(如果有)并行任务,以加快项目进程或避免已有上下文污染思考
- 当项目多次尝试修复同一个问题未成功解决时,完整阅读所有代码后再动手
- 项目作者JularDepick
- 前后端项目请在后端代码注释头、每一个前端页面底部标注作者信息,并在控制前端页面的代码里定义宏或常量方便开发者动态替换前端页面作者信息