31 lines
2.9 KiB
Markdown
31 lines
2.9 KiB
Markdown
# YCode 项目约定
|
|
|
|
## 日常操作：固定入口优先
|
|
|
|
- 用户说“拉取代码／运行 dev／启动当前代码／启动最新代码／重启 dev／停止 dev／构建／打包／查看状态”时，执行 [日常操作 SOP](docs/协作/日常操作SOP.md)，唯一入口为 `node scripts/ops.mjs <动作> --json`；重启动作名为 `restart-dev`，停止为 `stop-dev`。模型只映射意图、启动操作一次、续读同一执行会话至结构化终态，不自由拼接 Git/npm/进程命令。
|
|
- 首先确认本次已打开的项目根目录；未知时只询问路径。新会话须已打开本仓库或由用户提供一次路径，不假定跨会话全局规则、旧电脑路径或历史验收目录仍适用。
|
|
- 不先做业务调研、REA、全量测试、方案设计或依赖升级。当前代码保留本地状态；只有 `pull`、`dev-latest` 同步 `gitea/master`。
|
|
- 自动恢复只限入口脚本内已定义、有边界的处理。非成功结果直接报告 `code`、摘要、日志与所需下一步；不循环重试、不擅自改源码、stash/reset、强推、换检出、修改凭据或杀未知进程。审批与安全限制照常生效。
|
|
- dev 的日志、端口、PID 不等于真实窗口验证；仅按结果中的证据报告。详细窗口验收及历史人工操作说明见 [Dev 启动 SOP](docs/协作/Dev启动SOP.md)，不作为失败后绕过固定入口的捷径。
|
|
|
|
## 当前目标（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` 了解当前基线与下一步。
|
|
|
|
## 委派
|
|
|
|
- 主上下文负责架构、集成、最终审查和验证。仅委派边界明确且有验收标准的工作。
|
|
- 子任务报告修改文件、关键决定、验证命令与结果、遗留风险；不得扩大范围或覆盖无关修改。
|