Imported from zzzai/hxydiy (
AGENTS.md). Install upstream withnpx skills add zzzai/hxydiy. Copyright stays with the author.
项目协作说明
- 所有回复使用简体中文。
- 生产级业务修正、价格逻辑和用户体验改动,必须先完成本地与服务器验证,再按风险边界发布。
三窗口共享记忆
- 每个任务从最新
origin/main创建或同步独立 worktree;未提交文件和聊天内容不算共享事实。 - 开始任务默认读取
docs/CONTEXT-MANIFEST.md、docs/CURRENT-STATE.md和本端docs/workstreams/<端>.md,其他资料按需检索。 - API、价格、状态机、权限、服务位或画像字段等跨端契约发生变化时,业务实现、合同测试、
docs/TEAM-MEMORY.md和相关docs/contracts/必须在同一个 PR 更新。 - 实际执行生产发布的窗口负责更新
docs/CURRENT-STATE.md,并在docs/WORK-STATUS.md顶部追加已核验事实。 - Obsidian 只作为本仓库 Markdown 的阅读和编辑工具;共享记忆以合并后的 Git 主干为准。
三端统一脚本优先交付
- 统一执行
docs/script-first-delivery.md:脚本等待、只读最终报告、失败才介入。 - 本地验证仍执行本端测试命令;PR 检查等待、已授权合并后的发布等待使用
tools/release/。禁止模型循环查询 CI、重复读取无变化日志或重复部署。 - 后台启动后交代报告路径并结束本轮;下次只读该任务
report.json。terminal=false是进行中,不是成功;超时、冲突、权限拒绝和失败才定向调查。 -Merge是单独的写操作开关,仅在用户已授权提交/合并本次变更时使用;脚本只合并指定 PR 的完整 SHA,不绕过检查,不强推、不自动重跑/回滚/修改业务。- 云端 AI 审查默认关闭,只有维护者明确启用才调用;脚本及 CI 等待本身不消耗模型 token,编写代码、人工请求 AI 审查和失败分析仍消耗。
_build_plan/
_build_plan/ 文件夹包含初始 PRD 和各里程碑提示,用于本项目初始建设阶段。它们仅用于文档和执行指引,不是功能代码;项目中的代码、配置、运行时逻辑和测试不得导入、读取或依赖其中内容。
不要把 _build_plan/ 视为长期产品文档。随着产品演进,其中的假设可能过时;初始里程碑完成并交付后,应删除整个目录。
