30 lines
2.1 KiB
Markdown
30 lines
2.1 KiB
Markdown
# 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` 是历史工具，不作为现行采集入口。
|
|
- REA 能力不足时记录具体未知项及所需证据；不得自行改用其他采集渠道。
|
|
- YCode 自身的源码编辑、构建、测试不受上述原版采集限制。
|
|
- 历史文档中的缩减范围、不实现、改用其他采集渠道等决定，若与上述目标冲突，以本约定为准。
|
|
|
|
## 验证与交接
|
|
|
|
- 原版结论记录版本、REA Evidence ID、观察范围和限制；历史 CDP 实测只作待复核参照。
|
|
- 区分已实现、mock/占位、已验证、未验证；禁止将 token 对齐、编译通过或 OMP 通路成功宣称为完整 1:1 验收。
|
|
- OMP 是当前已有的内核实现选择；是否与原版等价必须另行比较验证。
|
|
- 读取 `docs/接手状态-2026-10-15.md` 了解当前基线与下一步。
|
|
|
|
## 委派
|
|
|
|
- 主上下文负责架构、集成、最终审查和验证。仅委派边界明确且有验收标准的工作。
|
|
- 子任务报告修改文件、关键决定、验证命令与结果、遗留风险；不得扩大范围或覆盖无关修改。
|