CyberGril/AGENTS.md

CyberGril 项目必读规则

白栖知已于主卡 HEL-697 评论 01a1635b-b47c-79ed-ac66-9408c7905af9 批准需求继承办法。

开始任何工作前

1. 读取 docs/requirements/README.md、current.md、coverage.md，以及本次相关的原始来源。完整需求不能被任务卡摘录替代。记录所用版本和读取时的仓库提交。
2. 项目现行需求入口优先于旧 docs/SPEC.md、历史设计稿、样机、代码现状与任务卡中的旧指令。明确的用户新决定才能覆盖旧决定，并须更新需求变更记录。遇到冲突先核对原话，无法解决才向总管报告具体问题，不擅自降低要求。
3. 所有 CyberGril 任务应归属 CyberGril 项目，并包含需求入口、版本、关联要求编号、交付与验收、未完成项及后续承接、需求变更来源。现有历史卡的迁移不授权重启已停止的试验或重新执行已交付工作。

施工和交接

• 白栖知于主卡评论 01a163a5-e2a7-7ac8-afdb-991868e721bc 明确：本项目整体视觉由视觉总监接手设计与实际落地，职责不止审核把关。施工员无法实现对应效果时，由视觉总监直接编写相关代码。本轮对话及沉浸界面交由视觉总监亲自负责；总管负责协调、核对需求和交付，不再以自己的视觉原型替代它接手。此项是CyberGril项目分工，不修改队员在其他项目的全局职责、模型或认证。

• 使用 docs/requirements/task-handoff-template.md，写出本次交付及完整需求的关联；完整当前需求始终有效。阶段不做的内容列明承接，不删除需求。

• 需求、技术方案、阶段范围、实现状态、用户验收分开记录。不得把智能体建议、技术困难、模型登录失败或某阶段通过当作修改需求的授权。

• 不用“当前一两句”以外的长消息滚动主界面替代已确认的交流体验。长回复需完整可读，具体分句等方案先通过动态小样验证。

• 不用固定模板长文冒充 CG-014 的模型诠释自由、CG-015 的自主初始习惯与成长。出生底色不变；后天成长另记，不得因 UI 修复重算已有伴侣。

• 演示数据与真实能力严格区分。未分享生活不得借列表、搜索、摘要或旧链接泄露；真实服务须在响应前裁剪，前端过滤不是权限控制。

• 保留已有伴侣、名字、生日、聊天与记忆；写入测试使用隔离数据。用户认可界面小样前不替换现有正式界面。当前产品 PR#4 未获合并授权。

修改需求和审核

修改 baseline.json 中的要求时，须在 changes.json 和 changes.md 中记录白栖知明确批准的原话来源、旧要求、新要求及影响；原始来源只增补，不篡改。先核实来源作者和语义，不能用智能体确认代替。

交付前执行：

python3 scripts/check_requirements.py --base-ref origin/main
python3 scripts/check_requirements.py --base-ref origin/main --handoff <本次交接JSON文件>

检查脚本只发现结构缺项、来源损坏和编号失配。审核人仍须逐项核对原意、实际画面及动态过程；未实际验证真机或 Safari 就明确注明。前端演示通过、工程测试通过、用户阶段验收和整项目完成是不同事实。

比较前先获取真实目标分支；若本卡目标不是 main，使用实际目标引用。初次引入基准时目标没有基准文件，由独立审核核对整包来源；以后需求有变必须升版、追加新的用户授权，历史来源和变更记录只增不改。项目尚未配置自动CI合并门禁，当前由交付与审核执行本检查，不能声称平台已经强制拦截合并。

主任务 HEL-697 持续追踪完整功能，不因局部通过而归档。平台交付路由遵守当次运行指令，总管负责向白栖知汇报。