ycode/AGENTS.md

YCode 项目约定

启动 dev

• 用户要求启动、重启、启动当前／最新代码或用子代理启动 dev 时，先读并执行 docs/协作/Dev启动SOP.md。
• 首个执行动作是检查目标目录、Git 版本和已有 dev；不要先做业务调研、REA、全量测试或依赖升级。
• 当前代码保留本地状态；最新代码显式同步 gitea/master。不猜目录、不覆盖脏工作区、不复用固定版本验收目录。
• 设置 YCODE_SKIP_KERNEL_DATA_RESET=1 后在同一进程运行 dev，保留 exec session；以实际端口、对应 renderer 与可响应窗口作为成功依据。

当前目标（2026-10-15 用户确认）

• 借助 REA，按 WorkBuddy 的视觉、交互和功能进行 1:1 复刻。
• 所有查看 WorkBuddy 实现的工作必须通过 REA：安装包、脚本、样式、资源、运行时页面和行为采集均包含在内。
• 禁止用直接 CDP / WebSocket、手写提取器、浏览器 evaluate、computer-use 或其他渠道绕过 REA 查看原版实现。旧 scripts/wb-*、scripts/enable-wb-cdp.ps1 直接采集工具已清理，仅可在 Git 历史中查看，不作为现行采集入口。
• REA 能力不足时记录具体未知项及所需证据；不得自行改用其他采集渠道。
• YCode 自身的源码编辑、构建、测试不受上述原版采集限制。
• 历史文档中的缩减范围、不实现、改用其他采集渠道等决定，若与上述目标冲突，以本约定为准。

验证与交接

• 原版结论记录版本、REA Evidence ID、观察范围和限制；历史 CDP 实测只作待复核参照。
• 区分已实现、mock/占位、已验证、未验证；禁止将 token 对齐、编译通过或 OMP 通路成功宣称为完整 1:1 验收。
• OMP 是当前已有的内核实现选择；是否与原版等价必须另行比较验证。
• 读取 docs/接手状态-2026-10-15.md 了解当前基线与下一步。

委派

• 主上下文负责架构、集成、最终审查和验证。仅委派边界明确且有验收标准的工作。
• 子任务报告修改文件、关键决定、验证命令与结果、遗留风险；不得扩大范围或覆盖无关修改。