llm-to-agent/AGENTS.md

从点子到产品工作流

唯一事实来源

• docs/REQUIREMENTS.md 是当前版本产品范围的唯一来源。
• docs/IMPLEMENTATION.md 保存已经确认的技术实施方案。
• .ai-project/state.yaml 记录当前阶段和人工确认结果。
• docs/FEATURES.md 记录纵向功能切片进度。
• docs/ACCEPTANCE.md 记录验收证据。

人工确认门

• 完成需求草案后停止，等待明确人工确认。
• 完成实施方案后停止，等待明确人工确认。
• 生成并验证项目骨架后停止，等待明确人工确认。
• 三个阶段门全部通过前，不得开始纵向功能开发。
• 完成功能验收后停止，等待明确人工确认。

开发规则

• 默认项目已经立项，不进行市场、竞品、需求价值或商业价值分析。
• 不得扩大已经冻结的当前版本范围。
• 新想法记录到后续版本。
• 每次只开发一个完整的纵向功能切片。
• 用户于 2026-08-14 明确授权：F-004 及后续纵向功能切片由 Agent 自行验证通过后直接标记完成并提交代码，不再逐切片暂停；最后统一交由用户逐项审核。遇到阻塞或需要扩大冻结范围时仍须暂停。
• 每个切片覆盖所有适用的界面、接口或服务、数据持久化、权限、校验、异常状态、日志和测试。
• 修改前先检查现有代码。
• 实际运行项目规定的格式或静态检查、类型检查、测试和生产构建。
• 不得通过删除或跳过测试获得通过结果。
• 绝不提交真实密钥。
• 保留与当前任务无关的用户修改。

项目专项规则

• 保持 local file -> agent core -> web serve -> web 的依赖方向。
• Agent Core 不得依赖 Web 层，为后续 local file -> agent core -> cli 保留扩展边界。
• 避免大文件；模块按单一职责拆分。出现同时承担协议、业务和存储职责的文件时必须拆分。
• Web 组件私有样式与对应组件文件放在同一目录，例如 sidebar.ts 对应 sidebar.css；styles/ 只保存设计令牌、全局 reset 和确实跨组件的基础样式，不创建与功能目录重复的样式镜像树。
• 当前版本为单人使用，不引入多租户、多用户或分布式并发设计。
• 访问保护由部署环境中的外部反向代理承担；应用内不得实现登录页面、身份校验中间件、用户会话或访问凭据配置。