规约编程

什么是规约编程

规约编程是一种强调在软件开发过程中使用精确、可验证的规格说明（Specifications）来指导设计与实现的编程范式。规约编程基于规约文档进行结构化编程，按任务列表逐项实现功能并跟踪执行状态，JoyCode 会创建详细的规约文档（design.md、ruquirements.md、tasks.md），对项目进行需求分析、技术设计和任务分解。

规约编程的触发方式

方法一：手动切换智能体模式

用户可在内置智能体中手动选择 规约编程 智能体，获得更专业的任务编排体验。

方法二：对话中强调使用规约编程

在对话内容中直接说明需使用规约编程，智能体会自动识别并调用规约编程工具。规约编程具备原子能力，能够根据用户意图灵活调用相关功能模块，实现高效任务处理。

规约编程的任务状态

• 规约编程的任务状态统一存储于.joycode/specs/results.json文件中，并依托于项目进行管理。若清空results.json，任务状态将自动初始化，方便项目重置或重新规划。

• JoyCode 在生成需求、设计、任务文档后，用户可依次点击任务文档中的 执行任务 按钮，智能体将开始执行对应任务，并将其排入任务队列进行持续跟踪。

• 用户可选择 全部执行 ，将所有待处理任务一次性加入任务队列，并由系统自动依次执行。

• 任务状态具有可追溯性。规约 tasks.md 文档中，对已完成任务点击 执行历史 按钮，可查看该任务完成详情，便于项目过程回溯与质量管理。