AI 协作

从仓库已有规则开始

Flare 自带 AGENTS.md 与 .agents/skills。先让协作工具阅读当前提交中的实际文件，不要凭记忆为项目添加不存在的 .cursor、.claude 或别的工具目录。

其中 flare-public-surface 约束公开页、登录和内容修改；flare-build-behavior 说明构建与行为验证。技能的具体边界以仓库中的 SKILL.md 为准，不能把官网使用的 Next.js 规则套到 TanStack Worker 应用。

给 AI 一个可执行任务

建议同时给出：用户触发条件、对应页面 URL、预期结果、服务端约束、允许修改范围和验收方式。例如：

在 /app/files 增加按文件名过滤。
只过滤当前已加载的用户文件，不宣称全库搜索。
保留上传、下载、删除、API Key 和服务端归属检查。
中英文都有空结果提示，移动端不溢出。
执行相关类型检查和浏览器验证，报告未验证项。

任务越具体，越容易判断是否真的完成。仅要求“把页面做漂亮”不足以约束角色权限、请求状态与真实数据。

先定位再修改

让 AI 从 routes、modules、server API 和 packages 追踪完整调用链。涉及字段时同时核对 UI、输入 schema、查询、持久化和返回；不要自行发明 payload 映射。涉及 billing、credits、tasks 时先读现有状态机和数据库约束。

保持 URL、API 契约、服务端鉴权、查询失效、账本和幂等。UI 重构不能把真实数据替换成示例卡片，也不能为了让按钮成功而移除服务端保护。

不把密钥当上下文

可以提供 .env.example 的变量名、脱敏错误和目标类型，不能提供真实 .env、.dev.vars、用户会话、Webhook secret 或部署 Token。公开的源码片段和截图也要检查验证码、个人信息及配置值。

生产部署是明确的运维动作；先生成可审查 plan，再按授权执行。普通 UI 或文档任务不应顺手发布、注册生产用户或触发真实支付。

审查交付

检查差异是否超出任务，尤其是 package 版本、锁文件、schema、鉴权、资源名与测试期望。要求 AI 区分源码已实现、检查已执行、真实服务待验收，不接受一段“全部正常”替代证据。

运行 测试指南 中相关层级，并用浏览器检查语言、主题、键盘和移动端。将行为变化同步到公开文档及更新日志，避免下一位开发者照旧说明操作失败。