目录结构确定后,项目还不能直接进入大规模编码。因为文件放在哪里只是第一步,代码怎么写、变量怎么命名、组件如何组织、Git 如何提交,同样需要提前统一。

如果没有开发规范,AI 生成代码时很容易出现风格不一致的问题。比如同一个项目里,有的文件使用驼峰命名,有的使用下划线;有的组件用箭头函数,有的组件用 function 声明;有的地方严格定义类型,有的地方直接使用 any。短期看代码能跑,长期看维护成本会越来越高。

project-dev-standards 这个 Skill 的作用,就是在编码前制定一份完整的开发规范。它会以技术委员会的角色,基于已经确定的技术栈和项目结构,生成适合当前项目的规则文档,覆盖代码风格、命名约定、TypeScript 使用规则、Git 提交规范、错误处理方式,以及 AI 协作时必须遵守的约束。

这个 Skill 的重点不是写一些笼统的原则,而是把规则具体到可以执行。例如,组件文件统一使用 PascalCase,如 PostCard.tsx;工具函数文件使用 camelCase,如 formatDate.ts;目录名使用 kebab-case,如 user-profile/;TypeScript 中禁止随意使用 any,应尽量定义明确类型。

最终,这个 Skill 会输出 specs/开发规范.md。它相当于项目的编码准则,也是 AI 后续生成代码时必须遵守的规则边界。规范越清楚,代码风格越稳定,后期维护和多人协作也会更顺畅。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐