Skip to content

radium1234/Vibe-Coding-Navigator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vibe Coding Navigator ———— Rules is all you need

使用说明

这些文件需要在coding前复制粘贴到Cursor的Rules里面。

VIBE_RULES_LOCAL.md 是只专注于本地任务开发的版本,需要人工审批方案,当AI无法处理故障时会上报给人类。在设计时考虑的在各种任务(但是只限Python和Typescript语言)的通用性,可以直接上手使用(推荐)。

VIBE_RULES_LOCAL_AUTONOMOUS.md 也是只专注于本地任务开发的版本,但是是全自动化版本,当AI无处处理故障时会自主对方案进行重构。

LLM_RULES.md 是专为需要调用云端api的LLM应用专门增加的规则,只根据作者本人开发习惯写的,尚未完善,仅供阅读。

后续更新需要在云端上线的rules版本。

项目介绍

Vibe Coding Navigator 不是一个软件工具,而是一套为AI原生开发流程量身定制的System Prompt(在Cursor软件中可以作为Cursor Rules)。它旨在探索一种全新的软件开发范式:通过在System Prompt中设定清晰、严格的一系列规则,使得AI能够实现全程托管,从零开始构建完整项目,实现真正意义上的"无人类代码"开发,同时交付的代码是可控、可靠和高质量的。人类开发者可以从繁琐的编码工作中解放出来。

设计出发点:AI自主开发循环

本项目的核心假设是:一个足够先进的AI,在清晰、严格的规则引导下,通过自主的"开发-测试-调试-修复"闭环,在最少人类介入下可以完成整个软件项目。

用户的只需要完成以下内容:

  1. 初始输入:用户仅需提供最初的项目愿景或需求,当然也可以按照自己的意愿要求技术选型或者更详细的设计。
  2. 过程监督:我们希望用户在该环节只需要零介入。但是我们的项目保障用户可以以文档的形式审查AI的所有开发和测试计划,在不符合预期时提供必要的Prompt以修改AI的后续行为。
  3. 最终验证:在AI完成开发后,用户负责验证最终产出是否满足预期。

核心理念:规则驱动 (Rules-Driven)

Vibe Coding Navigator希望能通过规则驱动,来确保AI开发过程的可控性、可靠性和高质量

0. AI原生架构设计规则 (AI-Native Architecture)

我们要求AI在实现任何功能之前,自主完成架构设计,同时架构需要符合AI原生的理念。这意味着在技术选型、模块划分、接口设计上,会优先考虑那些便于AI理解、操作和扩展的模式。

这种架构的特点是:

  • 高度模块化:功能单元之间有清晰的边界和定义。
  • 自解释性:代码和结构本身就易于被AI分析和理解,减少模糊性。
  • 自动化亲和:架构本身支持自动化测试、部署和监控。
  • 合约驱动:模块间的交互由严格的、机器可读的合约(如OpenAPI、gRPC-proto)定义,降低集成复杂性。

1. 强验证规则 (Strong Validation)

项目严格遵循测试驱动开发(TDD)的原则。AI在实现任何功能之前,都必须先编写对应的单元测试。我们要求极高的测试覆盖率,并强制要求包含对边缘场景和错误情况的测试。强验证给AI提供了通过测试的明确实现目标—,同时确保了软件的健壮性和可靠性,避免AI在真实生产场景中出现缺陷。

2. 强约束规则 (Strong Constraints)

我们对AI生成的代码实施严格的规范和标准。这不仅包括统一的命名风格、代码格式,更涵盖了日志记录、错误处理、JSDoc注释、输入验证等开发实践,尤其是对于Python语言要进行强类型检查。强约束的目的是消除AI在代码生成过程中的不确定性,同时能够及时抛出错误使得AI可以自我修复。

3. 强目标规则 (Strong Target)

即使用户的初始需求是模糊或抽象的,AI也必须自己制定展现详细的规划和目标。AI在实现任何功能之前,需要主动将宏观目标分解为具体的、可执行的开发任务队列。AI需要持续自我对齐,确保每一个开发步骤都服务于最终的项目目标,而不是在没有明确指令时陷入停滞或偏离方向。

4. 强审计规则 (Strong Audit)

AI开发助手的每一个行为都必须是透明且可追溯的。通过强制AI维护详细的开发日志、规划文件、测试报告和bug修复记录,我们为整个开发过程建立了一套完整的审计追踪系统。这使得人类监督者可以随时审查AI的决策过程、评估其工作效率,并根据审计结果持续优化和迭代Vibe Coding Navigator规则本身。

项目愿景

Vibe Coding Navigator 的最终目标是验证并交付一套成熟且通用的System Prompt,使其能够真正赋能AI,实现Prompt in, Project out

About

一套为AI原生开发流程量身定制的System Prompt

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published