diodeme

Gold-Band

diodeme/Gold-Band/AGENTS.md

当前项目的全量设计方案位于： docs\gold-band\产品设计文档 当前项目的MVP版本开发计划位于： docs\gold-band\开发计划 每次代码修改，必须同步维护以上两类文档 每次实现需求时，都应该先思考，当前的需求，是否已经有现有的开源组件可以满足需求，是否已经有行业内最佳实践，都没有的话，才考虑自己实现。 每次出方案时，必须先告诉用户当前的方案才开始实现，方案设计时对问题的解决思路是：1.这个问题是否来源于根本性的设计缺陷？如果是则需要把设计缺陷一起修复掉，宁愿多付出一些成本 2.这个问题是否是来源于好的设计但是实现不够完善？如果是则基于好设计，继续完善实现。必须杜绝针对特定问题的补丁式修复。 修复 Bug 前必须回溯原始设计意图和缺陷形成路径，判断根因属于原有设计缺陷、正确设计但实现不完整，还是业务或实现逻辑错误，并向用户说明判断依据及对应修复方向。 修复 Bug 时，完成根因分析后应优先编写最小失败测试稳定复现问题，确认测试失败原因与分析一致后再修改实现；无法可靠自动复现时，必须说明原因并记录可审计的替代证据。 每次实现功能后并验证无误后，必须进行单元测试，从接口层面把正确验收固化下来，这样方便后续改动时进行回归。 优秀的设计思路： 1.分析哪些数据结构 2.不同数据结构分属于哪些不同领域 3.生命周期相关联的数据结构，状态应该统一管理 4.先定数据、再定接口、再补实现 5.杜绝硬编码，应该统一设置成变量，设计时要考虑到变量的应用范围，可复用的应该有单独的类管理，类中单独的变量则可以放在类中 6.错误码等不要使用简单的string，而是用结构体管理，至少包含code、msg等字段，后端只返回错误码，前端根据错误码进行处理，后端不应该包含任何对客文案的处理 7.使用现代开发的最佳实践，积极使用现成的库、框架、工具、组件等，严禁无效地重复造轮子 当前项目前端使用tailwindcss+shadcn-ui, chat ui界面使用prompt-kit。必须优先根据页面需要使用组件库生成copy-in代码，不能自己手写代码，可以在生成的copy-in代码中，根据需要进行修改 当前项目所有内置提示词（profile、runtime、repair、AI-DYNAMIC 等）必须统一放在 src/prompts/ 下管理，不允许把长…