# zhctprompt Agent Rules `zhctprompt` 是 010-cpt / 008-zhct 的控制项目。默认职责不是直接承载业务代码，而是统一编排： - 多项目代码编写与重构 - 产品设计、方案输出、UI 原型和架构图资料管理 - 企业微信微盘资料索引与公司知识库入口 - 用户手册生成与维护 - 截图、视频、UI 证据采集 - 售前项目、招投标标书和控标参数资料管理 - 测试、发布、回滚、复盘证据 ## 启动顺序 每次进入本项目、从 `zhct` 工作区开始实质问答，或新线程恢复任务时，先使用 `standards-stack/agent-skills/skills/zhctprompt-self-update-on-qa/SKILL.md` 更新控制项目本身： 干净工作树执行 `git pull --ff-only`；本地脏改动、非 Git 目录、认证失败、网络失败或无法快进时停止并报告。 该规则只更新 `zhctprompt`；同步 `zhctproject/` 业务仓库仍使用 `zhctproject-repo-sync`。 Jack 已给 `zhctprompt` 问答授予站内固定授权：回答前按上条规则拉取最新代码；如果本次回答产生了仓库文件变更，完成匹配验证、`git diff --check`、任务索引校验和提交前检查后，自动提交当前任务文件。该授权只覆盖本地 commit，不覆盖 push、MR/PR、强推或改写已推送历史；遇到冲突时，能基于当前任务文件和验证明确解决的由 Agent 处理，否则输出人工审核材料。 如果这是同事本地 Mac 新拉取或新打开的 `zhctprompt`，或检测到 `$HOME/.codex/skills/codex-team-skill-handoff/SKILL.md`、 `$HOME/.codex/skills/codex-project-skill-auto-install/SKILL.md` 缺失，必须使用 `standards-stack/agent-skills/skills/codex-project-skill-auto-install/SKILL.md`： 优先在 Codex 后台子线程安装项目 skills；如果当前工具不支持子线程，则在当前线程运行 `bash standards-stack/agent-skills/scripts/install_project_skills_to_codex.sh` 降级安装。只复制 `standards-stack/agent-skills/skills/` 到 `$HOME/.codex/skills/`，不得复制个人 `~/.codex` 整包、 记忆、连接器、token、cookie、浏览器 profile 或密钥。 每次在本项目内工作，先按顺序读取： 1. `README.md` 2. `HEARTBEAT.md` 3. `tasks/QUEUE.md` 4. `control/README.md` 5. `control/local-paths.md` 6. `standards-stack/README.md` 7. `standards-stack/prompt/governance/ZHCT_CONTROL_PROJECT_OPERATING_MODEL.md` 8. `modules/README.md` 如果任务涉及手册或视频，再读取： - `standards-stack/prompt/manual/USER_MANUAL_AND_VIDEO_PIPELINE.md` - `standards-stack/prompt/recording/VIDEO_RECORDING_STANDARD.md` - 若目标是生成正式中文用户操作手册视频，再读取 `standards-stack/agent-skills/skills/operation-manual-video/SKILL.md` ## 路径边界 控制项目： - `zhctprompt/` 默认代码目标： - `../zhctproject/store` - `../zhctproject/ai_api` - `../zhctproject/ai_store` - `../zhctproject/ai_web` - `../zhctproject/ai_app` - `../zhctproject/qc` - `../zhctproject/sxtyj` - `../zhctproject/ydysskz` - `../zhctproject/food_safety` - `../zhctproject/win_deploy_guoxin` `zhctproject/` 下登记的业务仓库清单以 `control/zhctproject-repositories.csv` 为准；新增、迁移或发现一级业务仓库时，必须同步更新该清单。 姜阳本机业务代码路径以 `control/local-paths.md` 为准；当前 `store` 统一使用 `/Users/jack/code/010-cpt/008-zhct/zhct/zhctproject/store`，不要再默认使用旧路径 `/Users/jack/code/010-cpt/008-zhct/store`。 外部受控项目： - `sch1.0new`：项目专属控制资料在 `work_sch1.0new/`，代码仓库为 `https://codeup.aliyun.com/60069db88deaa14d9e02b875/kx/sch1.0new.git`，当前姜阳本地业务仓库路径为 `/Users/jack/code/010-cpt/002-kxxk/sch1.0new` - `food_safety`：项目专属控制资料在 `work_food_safety/`，代码仓库为 `https://codeup.aliyun.com/60069db88deaa14d9e02b875/food_safety`，当前 sunqianqian 本地业务仓库路径为 `/Users/sunqianqian/Desktop/work/food_safety` - `win_deploy_guoxin`：项目专属控制资料在 `work_win_deploy_guoxin/`，代码仓库为 `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/environment_deployment/win_deploy_guoxin.git`，当前 wiscourper 本地业务仓库路径为 `/Users/wiscourper/Documents/workspace/zhct/zhctproject/win_deploy_guoxin` - `pingan-yunchu`：项目专属产品设计与方案资料在 `product_pingan_yunchu/`，当前姜阳本地资料源为 `/Users/jack/同步空间/cpt/002-产品/001 智慧营养健康餐厅/【004】项目/2026年项目/【2026】平安云厨/交付物-第一版` - `laidisen`：项目专属控制资料在 `work_laidisen/`，用于莱迪森（南京建宁中学）智慧食堂客户本地部署；当前无单独代码仓库登记，客户服务器凭据和手机号不得写入仓库。 公司级知识库： - `company-wedrive`：企业微信微盘派生索引在 `work_company_knowledge/`；原始资料源为姜阳本机企业微信微盘 `项目交付管理共享空间` 和 `数字技术中心知识库`，不批量复制原始大文件进 `zhctprompt`。 模块化入口： - `modules/product/`：产品模块；UI 模块、蓝湖抽样源材料、产品方案、架构图、原型和开发项目资料入口统一放这里。 - `modules/product/ui/`：UI 模块；蓝湖/MCP/Stitch/GemDesign、当前设计规范和蓝湖抽样源材料的入口。 - `modules/product/development/`：开发模块；`store`、`ai_api`、`ai_store`、`ai_app`、`sch1.0new` 等开发项目隶属于产品模块，但业务代码仍在各自仓库。 - `modules/project/`：项目模块；企业微盘内所有项目/主题的索引入口，当前通过 `modules/project/wedrive-projects/project-index.tsv` 指向微盘项目索引。 - `modules/presales-bidding/`：售前招投标模块；采购文件、客户需求、控标参数、要求响应矩阵、证据门禁、技术标章节和人审 HTML 的统一入口。新招投标测试项目默认放 `modules/presales-bidding/customer-projects//`，历史投标材料不搬家，只通过索引挂入。 新增受控项目： - `qc`：项目专属控制资料在 `work_qc/`，代码仓库为 `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/qingcai/qc.git`，当前 wiscourper 本地业务仓库路径为 `/Users/wiscourper/Documents/workspace/zhct/zhctproject/qc` - `ydysskz`：项目专属控制资料在 `work_ydysskz/`，代码仓库为 `g***@codeup.aliyun.com:60069db88deaa14d9e02b875/hlss/ydysskz.git`，当前赖清涛本地业务仓库路径为 `/Users/lqt/work/zhct/zhctproject/ydysskz`；当前智慧餐厅运动员版本开发分支为 `develop_sxtksydyss_20260615` 同事本地路径统一记录： - `control/local-paths.md` 全 010-cpt 盘点入口： - `control/010-cpt-project-inventory.tsv` - `control/current-status.tsv` ## 执行原则 - 不要把跨项目任务塞进单个聊天上下文硬扛。 - 当任务涉及代码编写、代码审查、重构、测试修复或把自然语言需求落地成实现时，必须使用 `standards-stack/agent-skills/skills/karpathy-guidelines/SKILL.md`：先澄清、简洁优先、精准改动、目标驱动；不确定就问，不做未要求的抽象、扩展或顺手重构。 - 当用户在 `zhct` 工作区说“拉取最新代码”“更新代码”“同步代码”，或要求在别的电脑补齐工作区仓库时，必须使用 `standards-stack/agent-skills/skills/zhctproject-repo-sync/SKILL.md`：以 `control/zhctproject-repositories.csv` 为真源，所有已登记 `zhctproject` 仓库都要同步；本地存在则 `git pull --ff-only`，缺失则 `git clone`，有本地改动、非 Git 目录、认证失败或无法快进时停止并报告。 - 当任务涉及国信 H5、国信小程序进入 H5、`/web/#/home`、`http://127.0.0.1:8083/web/#/home`、`ai_web` 或订餐 H5 原型时，必须使用 `standards-stack/agent-skills/skills/guoxin-h5-ai-web-routing/SKILL.md`：H5 前端目标仓库是 `zhctproject/ai_web`，H5 调用接口目标仓库是 `zhctproject/ai_api`，管理后台/PC 端目标仓库是 `zhctproject/store`；不得默认把国信 H5 前端落到 `zhctproject/store/public/mobile`，也不得默认把 H5-facing API 落到 `store`。 - 当任务涉及国信消费策略、`consume_scene_type`、`application_scene` 替换、H5 本人/亲友/招待餐策略、H5 外卖点餐策略、或 `/api/consume/bookingVerify` 未订餐现场消费策略时，必须使用 `standards-stack/agent-skills/skills/guoxin-marketing-strategy-consume-scene/SKILL.md`：策略匹配只使用 `consume_scene_type`，不再使用 `application_scene`；映射为 H5 本人餐和未订餐现场消费 `1`、H5 亲友餐 `2`、H5 招待餐 `3`、H5 外卖点餐/ordering `4`、普通消费机刷卡/扫码 `5`。 - 当当前线程上下文接近撑满、已经发生压缩、或长时任务继续在单线程里推进会降低可恢复性时，必须使用 `standards-stack/agent-skills/skills/context-handoff-subagent-continuation/SKILL.md`：先把 `tasks/QUEUE.md`、`HEARTBEAT.md`、`control/task-index/items/.tsv`、生成后的 `control/task-index/tasks.tsv` 和证据目录写回，再按任务边界新开线程或开启 subagent；subagent 只能接收边界清晰、可独立验证的切片，禁止把未锁定的共享 API/DB/权限/菜单契约并行拆散。 - 先把自然语言需求归一成任务契约，再进入代码、手册或视频执行。 - 当用户主动教了某件事以后怎么做、指定应使用的 skill/工具，或说“以后不需要我再提醒”“沉淀成 skill”“装进本项目”“复制给其他 agent 线程”时，任务完成后必须使用 `standards-stack/agent-skills/skills/user-taught-skill-capture/SKILL.md`：把可复用流程沉淀为项目内 skill 或更新已有 skill，并同步到后续线程会读取的入口文件。 - 当任务涉及新增、更新、评审、精简或维护 Codex/Claude/Agent skill 时，必须使用 `standards-stack/agent-skills/skills/agent-skill-design-quality/SKILL.md`：先判断是否真的需要 skill，再写正负 eval 和路由 description；正文只保留高信号判断、gotcha、停止规则和渐进加载入口，避免把普通 README 或命令清单伪装成 skill。 - 当用户要求“形成 skill 和 workflow”“沉淀成 skill 和 workflow”“把文章/方法加到本项目内形成 skill 和 workflow”时，必须使用 `standards-stack/agent-skills/skills/skill-workflow-capture-standard/SKILL.md` 并读取 `standards-stack/prompt/governance/SKILL_AND_WORKFLOW_CAPTURE_STANDARD.md`：先真实获取来源并回读验证，再形成来源索引、summary、稳定知识页、workflow、skill+eval、两个 HTML、入口更新、任务索引和验证；外部文章默认 C 级方法证据，不复制第三方全文，不把未经验证的方法写成公司制度。 - 当 `zhctprompt` 内的问答或任务产生仓库文件变更时，必须使用 `standards-stack/agent-skills/skills/zhctprompt-qa-auto-pull-commit/SKILL.md`：回答前干净工作树先 `git pull --ff-only`；回答后按改动范围验证并自动本地提交当前任务文件；不创建空提交，不自动 push/MR/PR；冲突只能在当前任务文件且可验证时自行解决，否则提供人工审核材料。 - 当团队成员要求快速出 PRD、产品战略跨步、用户研究、竞品/市场研究、增长/GTM、产品数据分析、技术分析或 AI 应用上线检查，或明确说要用 PM Skills / 产品经理工作流时，必须使用 `standards-stack/agent-skills/skills/pm-skills-team-workflow-router/SKILL.md`：先遵守本项目证据等级、目录落位、真实系统核验、人工 review 和交付门禁，再调用导入的 `pm-*` 产品经理方法 skill；PM Skills 只能补结构化流程，不得把框架输出写成已验证客户事实、收入数据、安全结论或上线承诺。 - 当用户查询 `zhctprompt` 文件连接、文件链接、线上地址、MD/HTML 查看地址时，必须使用 `standards-stack/agent-skills/skills/zhctprompt-online-file-link/SKILL.md`：域名站点根目录已指向 `zhctprompt` 仓库，默认把仓库内相对路径拼到 `https://zhctpmt.yyangpt.cn/`；用户要求 IP 时再补 `http://101.200.165.56/zhctprompt/`。返回带图片、CSS、JS 等资源的 HTML 外链前，必须在线验证 HTML 200 且所有图片资源 200，不能只验证本地文件存在。 - 默认输出格式遵守 `standards-stack/agent-skills/skills/output-format-preferences/SKILL.md`：给 Agent 自己复用的持久化资料优先 Markdown；新建结构化表格优先 CSV，不再默认 TSV；给用户查看的正式成果优先生成美观 HTML，但团队/事业部周报固定优先按周报模板输出 Excel，不套用 HTML 默认项；新建人审 HTML 文件必须使用具体内容简称的 ASCII kebab-case 文件名，例如 `enterprise-standard-package-delivery-gate.html`，不要把主入口命名为 `review.html`。写到 `~/Desktop` 的用户可见交付物必须先建一个任务命名总文件夹，最终件、ZIP、预览页、运行输出和过程版本都放入该文件夹，不直接散落在桌面根目录。项目脚本强依赖 TSV 的既有机器索引例外，例如 `control/task-index/items/*.tsv` 和 `control/task-index/tasks.tsv`。 - 当任务涉及售前项目、招投标、标书、控标参数、采购文件响应、技术标章节、投标证据包或要求响应矩阵时，必须先使用 `modules/presales-bidding/README.md`：新项目放入 `modules/presales-bidding/customer-projects//`；先登记来源和要求响应矩阵，再写章节；A/B 级证据可支撑硬性响应，C/D 级只能作方案建议或待确认项；商务报价、合同、盖章、证书有效期、厂家授权、硬件参数、客户案例外发、AI/营养健康/等保/国产化承诺必须人工确认。 - 当用户要求提升 HTML、Word、PPT、产品简介、手册预览页或方案材料的“品味 / taste / test 品味 / 高级感 / 整体风格”，要求 Codex 默认替他挑一个视觉风格，或要求“生图 / 生成类似这样的图片 / 视觉参考图 / 页面效果图”时，必须使用 `standards-stack/agent-skills/skills/taste-skill-visual-direction/SKILL.md`：正式 HTML/Word/PPT/报告默认选择 `Kangbite Digital Executive Soft-Minimal`；本项目生图默认使用 `gpt-taste / redesign-skill`，并在产出前主动说明本次 `Taste routing`。如果有人问还有哪些选项，告知 `imagegen-frontend-web`、`imagegen-frontend-mobile`、`brandkit`、`image-to-code-skill`、`soft-skill`、`minimalist-skill`、`brutalist-skill`、`stitch-skill`、`taste-skill` 等可选分支。运营后台和管理工具不得默认套用营销页或 Awwwards 风格。 - 所有有意义的代码修改或文档修改必须遵守 `standards-stack/prompt/governance/DOCUMENT_REVIEW_LEARNING_LOOP.md` 和 `standards-stack/agent-skills/skills/team-document-review-learning-loop/SKILL.md`：先在本控制项目留下 Markdown 记录供 AI 理解；需要人审时生成 HTML review 页面；人的 review 要区分“认可经验”和“否定反模式”；认可经验沉淀为 wiki、治理规则或 skill，否定做法只沉淀为 anti-pattern、stop rule 或质量门槛，不得吸收成正向经验。 - 当团队问答、文档讨论、Codex 线程或同事反馈产生可复用知识，或用户要求“按照线程形成 markdown 文档”“整个团队都要记录”“未来训练这些问答”时，必须使用 `standards-stack/agent-skills/skills/team-thread-markdown-record/SKILL.md`：在 `work/team-learning/thread-records/YYYY-MM-DD/.md` 形成一线程一 Markdown 的项目内训练记录，链接产物、证据、验证、认可经验、否定反模式和后续 owner；不得保存密钥、原始生产 payload、未脱敏个人信息或把被否定内容当正向经验。 - 当用户或同事要求写周报、整理周报、统一周报、本周工作总结、下周计划，或提供零散工作记录需要形成统一汇报时，必须使用 `standards-stack/agent-skills/skills/team-weekly-report-generation/SKILL.md`：先读通用 `weekly-report` skill，再读 `standards-stack/weekly-report/` 知识库，按数字技术中心 / 数科业务口径生成事业部周报 Excel；默认模板为 `/Users/jack/同步空间/cpt/05_经营管理与会议/005_日常管理/周例会（事业部层面）/2026年/周报模板.xlsx`，保留 `项目` 和 `产品` 两个主 Sheet，并在需要图文并茂时增加 `图文看板` Sheet；用户可见周报 Excel 统一使用 `微软雅黑` `12` 号字体；不再默认把用户交付物输出为 HTML 或 Markdown，Markdown 只作为内部证据/记忆。默认应用金字塔原理，先写结论、再写分论点、最后给证据和下一步；底层逻辑固定为从“做了很多事”升级为“按五层分解、SOP 阶段、产品规划表、AI 资产沉淀和 Before / After 讲价值”；不得编造未提供的数据、成果、客户反馈或完成状态。面向领导、战略复盘、跨团队协同，或用户要求“不要流水账”“提高战略透明度”时，还必须使用 `standards-stack/agent-skills/skills/weekly-report-strategic-transparency/SKILL.md`，按“主线任务 + 决策思路 + 情报视野”组织周报。 - 当用户或同事要求写周总结、月度总结、阶段总结、项目总结、策略复盘或各类总结，尤其提到“按 2 月月报那个思路”“写清晰一点”“不要流水账”“结合思维模型形成清晰报告”时，必须使用 `standards-stack/agent-skills/skills/summary-report-clarity-pattern/SKILL.md`：默认按“项目事实 -> 业务价值 -> 产品策略 -> 问题复盘 -> 下期里程碑 -> 组织能力升级 -> 一句话战略总结”组织；非平凡总结再叠加 `thinking-model-answering` 选择 1-3 个思维模型辅助推导，但不得用模型替代真实项目证据。 - 当任务涉及数科业务、数字化体育科技、智慧营养健康餐厅、AI 智慧营养健康餐厅，或用户要求从投资人视角、经营逻辑、第二增长曲线、高毛利、可复制、持续收入、估值、主业协同来分析时，必须使用 `standards-stack/agent-skills/skills/digital-business-investor-strategy-lens/SKILL.md`：后续周报、产品规划、项目复盘和工作说明都不能只讲做了多少项目、做了哪些功能或客户提了什么需求，必须回答为什么值得做、怎么做大、怎么赚钱、怎么证明可复制、怎么反哺康比特主业，并区分 A/B/C/D 证据等级；“第二增长曲线”只能作为待证明命题，不得写成已实现事实。 - 当用户要求调研方法、文章、仓库、会议材料或项目资料，并“更新经验/知识/技能到本项目”“构建个人 wiki/Obsidian 知识库”“自动整理知识库”“复杂问答持续更新”时，必须使用 `standards-stack/agent-skills/skills/llm-wiki-knowledge-base/SKILL.md`：先保留 raw 来源索引，再把可复用内容编译成 Markdown wiki、更新项目 skill 和恢复入口；不得只给一次性摘要。 - 当用户要求 AI 原生组织、AI 交付组织、AI 平台部、Agent 原生研发、产品/研发/测试/交付如何协作、项目经营中台、Codex/Hermes/OpenClaw/云效/微盘/Codeup 协同，或把个人/团队执行系统复制给组织时，必须使用 `standards-stack/agent-skills/skills/ai-organization-operating-model/SKILL.md`：先读 `standards-stack/llm-wiki/ai-organization-methodology/README.md`，按 operating model、角色/RACI、对象模型、端到端交付闭环、人工门禁和试点切片输出；不得把 AI 组织改造写成工具清单、口号或无人审核自动化。 - 当会议或项目推进涉及 AI Native 项目交付、量化验收、防退货、优卡特一体机/称重台硬件适配、会议录音/评审纪要入库、上线问题复盘、软著/CNAS/CB/专利资料包时，先读 `standards-stack/llm-wiki/ai-native-project-delivery-collaboration/README.md`，再按场景分别加载 `standards-stack/agent-skills/skills/project-delivery-quantified-acceptance/SKILL.md`、`standards-stack/agent-skills/skills/hardware-adaptation-delivery-gate/SKILL.md`、`standards-stack/agent-skills/skills/ai-native-knowledge-loop/SKILL.md` 或 `standards-stack/agent-skills/skills/software-ip-certification-package/SKILL.md`；所有客户承诺、研发排期、硬件兼容、认证/法务结论和上线合并必须保留人工门禁。 - 当用户要求把智慧食堂、AI 智慧营养健康餐厅、团队工作流、SaaS 页面、PM/设计/交付流程或公司级 Agent 做成“AI Agent 必备能力”“Agent 原生”“人和 Agent 一起工作”“让 Codex/Claude 操作业务系统”时，必须使用 `standards-stack/agent-skills/skills/smart-canteen-agent-native-work-system/SKILL.md`：先定义人类用户、Agent 用户、读写动作、禁区、人工监护点、证据路径和恢复方式，再路由到产品战略、云效、微盘、Apifox、SLS、手册视频或业务代码 specialist；不得把 Agent 自动化写成无人审核、无人上线或无人负责。 - 团队共享问答默认遵守 `standards-stack/prompt/governance/TEAM_SHARED_QA_BASELINE.md`，并把 `standards-stack/agent-skills/skills/ai-prompting-quality-guardrails/SKILL.md` 作为底层能力：任何非平凡同事问答、资料检索、需求澄清、方案/手册/周报/复盘、代码建议和管理决策，都先补上下文包、证据等级、信源/深度策略和验证方式；遇到观点、评审或推荐时必须降低讨好、列出反方和缺口，评分先分项再汇总。 - 非平凡问答、分析、建议、评审、规划、复盘、战略、产品、管理、沟通和决策问题，默认再叠加 `standards-stack/agent-skills/skills/thinking-model-answering/SKILL.md`：先从 `standards-stack/llm-wiki/thinking-models/thinking-model-question-routes.md` 或 `thinking-model-keyword-routes.csv` 选择合适思维模型，再读取对应 `models/*.md` 或 `full-content.md` 的 PPT 原文抽取后按模型推导答案；普通问题选 1-3 个模型，复杂问题最多 3-5 个；不得把模型当事实来源，真实业务证据、代码、日志、合同、客户材料和微盘索引优先。 - 当用户要求借鉴 AI 多智能体开发协作系统、代码审查智能体、项目管理智能体、任务调度智能体、云效看板自动推进，或要求基于云效和企业微信微盘实现 AI 协作时，必须使用 `standards-stack/agent-skills/skills/yunxiao-wedrive-agentic-collaboration/SKILL.md`：用户不需要按“模式 / 输入 / 目标”模板表达；先把自然语言、截图文字、云效链接、Codeup MR、微盘路径或聊天记录自动归一成内部 `ROUTING_NOTE`，再选择代码审查、任务调度、云效 CLI、微盘检索、需求生命周期等 workflow；代码审查先走 `review_guardian` 和标准化报告；项目调度映射到云效、本地队列、任务索引和微盘来源索引；不得把自动审查当作自动合并或绕过人工高风险审批。 - 当用户要求完善会议流程、AI 协作流程、Codex 留痕、自测、用户手册、操作视频，或提供会议纪要要求沉淀为流程时，必须读取 `standards-stack/prompt/governance/MEETING_AND_AI_COLLABORATION_WORKFLOW.md`；会议流程必须包含会前目标、会中录音与主题宣讲、过程讨论、主持人总结和会后沉淀，AI 协作必须从云效任务进入并把方案、自测、手册、视频和复盘写回项目文件。 - 当用户要求把产品开发部规划蓝图、软件硬件 AI 工程化蓝图、整个项目蓝图放进项目，或说“这个作为总的 agent”“把工作填进蓝图”“按 IPO 使用项目”时，必须使用 `standards-stack/agent-skills/skills/product-development-master-agent/SKILL.md`：先读 `PROJECT_IPO_USAGE_GUIDE.md`、`standards-stack/prompt/governance/ZHCTPROMPT_PRODUCT_SYSTEM_OPERATING_STANDARD.md`、`standards-stack/management/product-development-department/PRODUCT_DEVELOPMENT_DEPARTMENT_BLUEPRINT.md` 和 `standards-stack/prompt/governance/ZHCT_PRODUCT_DEVELOPMENT_MASTER_AGENT.md`，先分到产品开发部总控体系、智慧食堂产品战略体系、康比特食安方案资产体系之一，再映射到五模块 IPO 并路由到对应 specialist skill；不得把宣讲愿景、设备数量或项目状态直接写成已确认事实。 - 当用户要求把 `zhctprompt` 做成产品开发部 Prompt OS、产品资产操作系统、三条主线、智慧食堂产品战略体系、康比特食安方案资产体系，或要求把多个 SMART 目标合并到同一个 prompt 控制项目时，必须先读 `standards-stack/prompt/governance/ZHCTPROMPT_PRODUCT_SYSTEM_OPERATING_STANDARD.md`：战略和方案输出必须标注 A/B/C/D 证据等级，并区分确认事实、证据推导、战略假设和待补数据。 - 当用户要求产品战略规划、产品规划、公司级产品战略、产品线战略规划、主要产品发展规划、区域产品规划、渠道规划、产品地图、产品组合、产品路标、战略绩效看板，或提到 SPAN、APPEALS、PDC、7-2-1 时，必须使用 `standards-stack/agent-skills/skills/product-strategy-planning/SKILL.md`：先读 `modules/product/strategy/product-strategy-planning/` 的方法论和模板，先锁规划层级、规划周期、产品地图和证据等级，再进入市场细分、SPAN、APPEALS、PDC、7-2-1、路标和绩效；智慧食堂产品战略规划先调用该 skill，再调用 `smart-canteen-strategy-agent`。 - 当用户要求智慧食堂销售预测、销售漏斗概率化、商机评分、线索评分、赢单概率、月度签约预测，或提到 B2B 销售预测 AI 化时，必须使用 `standards-stack/agent-skills/skills/smart-canteen-sales-forecasting/SKILL.md`：先读 `standards-stack/llm-wiki/sales/b2b-sales-forecast-ai.md` 和 `standards-stack/product-strategy/smart-canteen/SALES_FORECASTING_AI_PLAYBOOK.md`，把文章作为 C 级方法证据，再按智慧食堂售前字段、产品包、阶段概率、签约月、回款节点和证据等级输出预测；没有真实商机台账时只输出数据模板和字段门禁，不得编造预测金额或准确率。 - 当用户要求把产品卖点、功能清单、设备参数、产品包或方案话术翻译成客户买点，或提到“卖点”“买点”“产品卖不动”“客户为什么买”“为什么选我们”“销售话术”时，必须使用 `standards-stack/agent-skills/skills/product-buying-points-translation/SKILL.md`：先读 `standards-stack/llm-wiki/product-methods/selling-points-to-buying-points.md`，按客户角色、为什么现在买、为什么选我们、可转述一句话、证据等级和补证缺口输出；不得把功能堆砌当成买点。 - 当用户要求挖掘、验证、评分或汇报消费者/客户痛点，或提到“消费者痛点”“痛点挖掘”“客户痛点”“用户痛点”“目标用户”“期望分析”“消费场景”时，必须使用 `standards-stack/agent-skills/skills/consumer-pain-point-discovery/SKILL.md`：先读 `standards-stack/llm-wiki/product-methods/consumer-pain-point-discovery.md`，用痛点雷达拆角色、期望落差、行为摩擦、场景情绪、责任预算和可解证据；C/D 级假设只能作为访谈问题、补证清单或产品假设，不得写成已验证客户事实。 - 当用户要求需求分析、PRD、完善需求、需求评审、需求池筛选、真需求/伪需求判断、评审会前找问题或“15 个问题”时，必须使用 `standards-stack/agent-skills/skills/prd-requirements-analysis/SKILL.md`：以《详细 PRD 文档要素清单》为基准，先判断需求类型和复杂度；涉及立项、付费、SKU、市场结构或客户承诺时，叠加“需求四层”判断当前证据停在陈述层、触发层、代价层还是结构层；从 PRD、接口、设计稿、截图或原型进入代码前，叠加 `references/prd-to-verifiable-code-loop.md`，先形成 RequirementSpec、ArchitectureDesign、证据清单和验证策略，再进入实现；不得机械堆满完整清单。 - 当用户要求把产品开发部工作管理规范、产品开发部管理规范、云效 project 项目管理、项目经理检查清单沉淀到项目内或复制给其他同事时，必须使用 `standards-stack/agent-skills/skills/product-development-management-standard/SKILL.md`：先读 `standards-stack/management/product-development-department/`，复制时同时提供 3 份原始 Word、落地版管理规范、Excel/CSV 检查清单和复制说明；不得只转发原始 Word。 - 当用户要求把本地或项目内 Codex skills 整理、安装、复制给其他同事使用 Codex 时，必须使用 `standards-stack/agent-skills/skills/codex-team-skill-handoff/SKILL.md`：项目 skills 真源放 `standards-stack/agent-skills/skills/`，团队复制说明放 `standards-stack/agent-skills/CODEX_TEAM_SKILL_HANDOFF.md`，清单优先放 `standards-stack/agent-skills/CODEX_TEAM_SKILL_MANIFEST.xlsx` 或 `standards-stack/agent-skills/CODEX_TEAM_SKILL_MANIFEST.csv`，不得整包复制个人 `~/.codex` 状态或密钥。 - 当任务涉及任何云效读取、创建、更新、评论、状态流转、工时、TestHub、里程碑或版本操作时，必须使用 `standards-stack/agent-skills/skills/yunxiao-cli-interaction/SKILL.md`：默认走 `aliyun devops` CLI 或 OpenAPI-backed CLI 脚本，命令和脱敏回读进入证据；首次启动或本地配置为空时，必须询问当前同事的个人云效令牌和个人名称；不得默认用浏览器 UI 创建或修改云效工作项。 - 当用户要把截图、聊天记录或简短中文需求整理/创建到云效项目 `【自研】智慧营养健康餐厅` 时，必须使用 `standards-stack/agent-skills/skills/yunxiao-smart-canteen-requirements/SKILL.md`：默认创建 `产品类需求`、状态 `待处理`；负责人未明确时，当前用户偏好默认指派给赖清涛，若其他用户或上下文不明则先确认；云效令牌和个人名称只从 `config/local/yunxiao.env` 读取，不写入仓库。 - 当用户让 Codex 拉取、实现、提交或完成云效需求时，必须使用 `standards-stack/agent-skills/skills/yunxiao-requirement-task-lifecycle/SKILL.md`：先把父需求拆成关联开发任务并填写任务计划开始时间、计划完成时间和按“未使用 AI”估算的预计工时；代码提交和 MR 用子任务号关联；开发完成后按真实 AI 辅助投入填写实际工时，并修改子任务和父需求状态。 - 当用户要求“提交云效”“提交 Codeup”“提 MR/PR”“完成云效关联”或把代码、验证、MR 和云效回写串起来时，必须读取 `standards-stack/prompt/governance/YUNXIAO_CODEUP_SUBMISSION_PROCESS.md`，按“CLI 回读云效 -> 分支实现 -> 验证 -> `# ` 提交 -> 推送 -> Codeup MR 回读 -> 云效 CLI 回写 -> 本地证据和任务索引”闭环执行。 - 业务 SQL 全局硬约束：禁止使用 `EXISTS` / `NOT EXISTS` 做业务存在性判断，确有必要时放到代码逻辑里判断；禁止用 SQL 判断表是否存在或字段是否存在，默认上线 SQL 会同步，缺表缺字段应暴露为上线问题；禁止业务 SQL 或 raw SQL 使用 `?`、`:name` 等 SQL 占位符拼接动态条件，动态条件必须先在代码里算清楚再交给框架结构化查询 API。详细规则见 `standards-stack/prompt/governance/STORE_REPORT_AND_COMMON_METHOD_GUARDRAILS.md`。 - 代码类任务完成开发后，不得在未验证时直接 `git commit`、推送或创建 MR；必须先运行与改动范围匹配的测试/验证并记录结果。验证通过后才允许提交；验证不可运行时必须先记录 blocker、替代证据和继续提交依据。`zhctprompt` 本控制项目已有验证后自动本地提交授权；其他仓库仍需按任务/用户授权执行。提交前必须再次确认 `git diff --check`、目标测试结果和 staged 文件范围。 - 当任务涉及产业园展厅、智慧餐厅接访、展厅开机、默认餐台菜品、模型摆放、布菲炉复位或客户参观演示准备时，必须使用 `standards-stack/agent-skills/skills/smart-canteen-showroom-reception/SKILL.md`：默认用规则表、开机检查、餐台/布菲炉编号、系统菜品、实物模型和标准摆放照片来复位现场，减少对具体人员的临时依赖；没有真实菜品和模型来源时不得凭空编造，先标 `待现场确认`。 - 当云效请求一次包含多个任务，或需要按负责人/状态/视图筛选出多个工作项时，必须使用 `standards-stack/agent-skills/skills/yunxiao-batch-subagent-execution/SKILL.md`：先完整读取和归档任务清单；按负责人筛选时默认只处理该负责人名下未完成、待开发/开发中的可执行任务，已完成/关闭/取消任务只记录排除，除非用户明确要求返工或重开；再按每个任务或独立切片开启 subagent；需要改同一子项目时仍必须一任务一分支一 `git worktree`。 - 当新起任务线程、子线程或 subagent 时，如果任务已有云效/Codeup/VWCG 等任务号，必须使用 `standards-stack/agent-skills/skills/task-thread-title-ticket-prefix/SKILL.md`：线程名称或首行任务标题以 ` ` 开头，方便在线程列表中检索。 - 当云效/Codeup 任务涉及 PR/MR、代码关联、提交标题、`没有提交的 PR`、`MR 提到 release`、`预上线分支` 等反馈时，必须使用 `standards-stack/agent-skills/skills/yunxiao-codeup-pr-association/SKILL.md`：提交信息和 Codeup MR/Code Review 标题必须以 `# ` 开头；本地上线代码第一阶段 MR 目标分支必须是 `release`，预上线验证通过后再进入 `master` 合并流程；只有任务证据或用户明确说明使用 `test` 时才走 `test`；禁止用空提交作为唯一代码关联，必须回读 commits/patchset 非空。 - 当用户提供阿里云 SLS 控制台链接或要求用 SDK/CLI 查线上日志时，必须使用 `standards-stack/agent-skills/skills/aliyun-sls-log-triage/SKILL.md`：解析 project、logstore、region，优先使用 skill 自带 SLS SDK 查询脚本只读查询，并在汇报中脱敏手机号、签名、密钥和完整原始请求体。 - 当用户问金斯瑞数据库、`zhct_jsr`、`ydy_user`、admin 账号或 `pwd_update_time` 密码更新时间维护 SQL 时，必须使用 `standards-stack/agent-skills/skills/jsr-db-admin-maintenance/SKILL.md`：先读 `work_store/db/jsr-admin-password-maintenance.md`，默认只给最小 SQL，由用户自行登录执行；不得主动连接或修改生产数据库，不得把数据库账号密码写入 skill、任务索引或可公开证据。 - 当用户要求金斯瑞 / 金思瑞生产数据只读查询、`zhct_jsr` 数据导出、取餐柜订单数量、南京 / 镇江拆分或客户汇报 Excel/CSV 报表时，必须使用 `standards-stack/agent-skills/skills/jsr-readonly-data-reporting/SKILL.md`：只允许读取本机忽略文件 `config/local/jsr-db.env` 中的只读数据库配置；不得回退使用生产应用/root 配置，不得把数据库账号密码写入 skill、任务索引或可公开证据。 - 当任务涉及 `store` 异步导出提速、大数据导出、`ExportMealOrder.php`、`ydy_export_log`、用户明确要求保持 Excel 下载习惯，或修改消费订单、人员消费明细、部门消费明细、设备消费明细、充值统计、补贴统计、菜品销量统计、餐厅经营汇总表、档口营收结算表这 9 类异步导出关联列表页时，必须使用 `standards-stack/agent-skills/skills/async-export-streaming-xlsx/SKILL.md`：异步导出应保持 `.xlsx`，用流式 XLSX writer 分批逐行写入；列表页改动必须检查是否需要同步修改异步导出；不得默认改成 CSV。 - 当任务涉及新增、更新、导入、归档或评审任何接口/API 契约时，必须使用 `standards-stack/agent-skills/skills/api-contract-test-coverage/SKILL.md`：同步更新 Apifox/OpenAPI、接口端口与模块归档、成功/异常/边界测试、自动化场景和测试套件；未来开发新接口时必须优先更新现有测试，无法复用时新增测试。 - 当用户要求把接口自动写入、更新、同步或导入 Apifox，尤其是 `AI运动营养师` 项目接口时，必须使用 `standards-stack/agent-skills/skills/apifox-api-sync/SKILL.md`：默认走 Apifox OpenAPI 备份、增量导入和导出核验；写入前必须输出项目下可选一级目录并让用户二次确认目标目录；令牌只从 `APIFOX_ACCESS_TOKEN`、本机私有 `.local.env` 或一次性 shell 变量读取，不写入仓库或证据；同事首次使用时提示补充自己的个人 Apifox 令牌。 - 当用户可见功能或修复已经完成并通过功能测试后，必须使用 `standards-stack/agent-skills/skills/post-test-manual-video-delivery/SKILL.md`：自动生成或更新 Markdown 用户手册、Word `.docx` 手册、截图证据和操作指引小视频材料；无法安全录制或生成 Word 时，必须写明 blocker，不得把手册/视频当成可选项。 - 当用户要求修改演示环境或生产近似环境数据，并要求修改前后截图、备份、回滚机制或图文并茂对比清单时，必须使用 `standards-stack/agent-skills/skills/demo-system-data-screenshot-acceptance/SKILL.md`：先确认真实运行环境和 UI 可见性，先截真实 Before，再备份、写入、验证和截图 After；不得用数据库/API 生成图冒充系统截图。 - 当用户要求从 Excel、截图、聊天记录或客户短文本做需求分析，并要求结合本地系统真实页面、Before/After 原型、快速上线或判断“开发不用改”时，必须使用 `standards-stack/agent-skills/skills/system-grounded-requirement-analysis/SKILL.md`：先锁定需求真源和原文，再核验真实 UI、前后端代码、接口、数据模型和配置能力；每条需求必须输出业务问题、系统证据、正确方案、上线方式、开发改动判断、风险和待确认项，不得把短需求直接翻译成按钮或页面文案。 - 当用户要求“录屏”“屏幕录制”“录制一下 ToDesk/桌面 App 操作界面”或“停止录屏”时，必须使用 `standards-stack/agent-skills/skills/macos-screen-recording/SKILL.md`：默认用 macOS `screencapture -v` 录主屏，保存到 `~/Desktop/CodexRecordings/`，启动时保留 TTY session，停止时优先向该 session 发送 Ctrl-C 以正常收尾。 - 当用户或同事要求根据源文档、截图、产品素材或功能流程生成正式中文用户操作手册视频、预览页、配音和 MP4 时，必须使用 `standards-stack/agent-skills/skills/operation-manual-video/SKILL.md`：通过 `codex-video-harness` 创建隔离 run，先生成 `module.json`，再完成手册 QA、Volcengine TTS、真实截图、鼠标点击提示和最终视频验收；不得把 harness 大目录、帧序列、音频和历史 MP4 整包复制进 `zhctprompt`。 - 当用户在本项目要求“沉淀”“记录”“整理成文档”“放到项目里”“后续都按这个要求”，且内容与 Android 终端、设备操作、流程图、操作视频、SOP 或其他未归属专项有关，并且没有指定具体 Android 项目目录时，必须使用 `standards-stack/agent-skills/skills/android-other-knowledge-placement/SKILL.md`：默认沉淀到 `zhctprompt/work_android/other/`；不得新建根目录级 `work_yxl`、`work_misc` 等一次性目录；如果误建，必须迁移到 `work_android/other/` 并删除错误空目录。 - 当任务、云效工作项、Codeup MR、生产日志排查、证据包或用户教学沉淀完成后，必须使用 `standards-stack/agent-skills/skills/task-index-library-maintenance/SKILL.md` 更新 `control/task-index/items/.tsv`，再生成 `control/task-index/tasks.tsv`，把任务号、分支、提交、MR、状态、证据和复用 skills 归入统一索引库。 - 当任务涉及 `store`、`ai_api` 或其他 ZHCT PHP 项目的 `php -l`、`php think`、本地后端验证时，必须使用 `standards-stack/agent-skills/skills/zhct-docker-php-verification/SKILL.md`：赖清涛本机 shell 可能没有 `php` 命令，默认直接用 Docker 容器 `zhctapp_v2_0`，`store` 用 `/usr/local/php7.3/bin/php`，`ai_api` 用 `/usr/local/php7.4/bin/php`；不要先尝试安装或依赖宿主机 PHP。 - 当用户要求运行本地 Docker 项目、明确说按 `zhctprompt/README.md` 启动、追问 `8088` 是什么，或说明 `zhctproject/store/docker-compose.yml` 不该使用时，必须使用 `standards-stack/agent-skills/skills/zhct-readme-docker-start/SKILL.md`：默认只走 `zhctprompt/docker/start_zhct.sh`，只保留 `zhctapp_v2_0` 这一个项目运行容器，不再使用 `store` 仓库里的 compose/Nginx `8088` 环境。 - 当用户或同事询问 AiMaMi 安装、AiMaMi DMG 安装、macOS 提示无法验证开发者、AiMaMi 打不开、帮同事装 AiMaMi 时，必须使用 `standards-stack/agent-skills/skills/aimami-install/SKILL.md`：覆盖 DMG 安装、Gatekeeper 安全绕过、SHA256 校验、终端安装、首次配置建议和同事推荐话术；不要在 SHA256 不匹配或 macOS 低于 12.0 时继续安装。 - 当新增受控项目，或用户纠正项目专属资料与通用资料落位时，必须使用 `standards-stack/agent-skills/skills/controlled-project-workspace-placement/SKILL.md`：代码、交付、客户部署、接口、排障和运维类项目专属资料进入 `work_/`；产品方案、UI/设计、原型和架构图等产品设计专项进入 `product_/`；跨项目方法进入 `work/`，未来 agent 必须遵守的规则进入 `standards-stack/`，不得复制业务代码；不要在 `store`、`ai_api` 等目标代码仓库更新与代码运行、发布、迁移、测试无关的说明类文档，接口说明、上下文、日报、证据和需求总结默认沉淀到 `zhctprompt/work_/`。 - 当用户提示“目录建错了”“产品资料归档错了”“按 PRODUCT_DIRECTORY_RULE.md 来”或给出 `/Users/wiscourper/Documents/workspace/zhct/zhctprompt/PRODUCT_DIRECTORY_RULE.md` 时，必须先读取该文件，再按其中规则纠偏：代码/交付/客户部署进入 `work_/`，产品/设计/PRD/UI/原型/架构图进入 `product_/`，产品线通用资料进入 `modules/product/products//`。如果产品及项目资料没有自动规范归档，固定提示：`请按zhct/zhctprompt/PRODUCT_DIRECTORY_RULE.md要求来存放产品资料`。 - `store` 项目的 prompt、需求原文、排查日志、MR/云效证据和复盘记录默认全部放在 `zhctprompt/work_store/`；除非用户明确要求维护 `store/prompt/**` 本身，业务修复 MR 不得新增或更新 `store/prompt/**`、`store/docs/**` 等说明类资产。若误改，提交前必须迁移到 `zhctprompt/work_store//` 并从 `store` 提交中移除。 - `store` 代码 MR 提交前必须检查 `git diff --name-only`：不得包含 `prompt/**`、`docs/**`、需求原文、任务契约、实施方案、开发摘要、云效/Codeup 证据、复盘记录等说明类文档。此类材料统一进入 `zhctprompt/work_store//`，再在控制项目单独提交。 - `store` 业务仓库只提交代码、测试和运行必要文件；AI 协作规则、公共方案约束、Review 经验、QA 复盘和长期方法论统一沉淀到 `zhctprompt`。涉及 store 报表聚合、金额口径、同步/异步导出、SQL helper、公共方案或公共方法变更时，必须先读取 `standards-stack/prompt/governance/STORE_REPORT_AND_COMMON_METHOD_GUARDRAILS.md`，并按其中“是否有必要公共化、调用点是否覆盖全、测试是否覆盖多场景”的要求执行。 - 处理 store 近两周已暴露的高频缺陷场景时，必须先读取 `work_store/qa/store-recent-bug-learning-guardrails-20260611.md`：报表/导出/聚合、订单快照、消费策略时间口径、取消退款状态机、人员/部门/设备权限、上传 500、GD/JPEG、cron 备份、Excel 导入、UTF-8 脏数据等问题，先按 QA 规则输出已知问题类别、优先证据、误判风险和最小验证矩阵。 - `ai_api` 项目的 prompt、需求原文、技术分析、排查日志、MR/云效证据和复盘记录默认全部放在 `zhctprompt/work_ai_api/`；业务修复 MR 不得新增或更新 `ai_api/prompt/**`、`ai_api/docs/technical/**` 等说明类资产。若误改，提交前必须迁移到 `zhctprompt/work_ai_api//` 并从 `ai_api` 提交中移除。 - 当产品人生成、上传、交接、归档或要求整理产品资料、产品材料、PRD、产品方案、售前方案、产品简介、UI、原型、设计规范、架构图、产品评审、竞品或调研资料时，必须使用 `standards-stack/agent-skills/skills/product-material-placement/SKILL.md`：先读 `PRODUCT_DIRECTORY_RULE.md`、`modules/product/README.md` 和 `standards-stack/prompt/governance/PRODUCT_MATERIAL_PLACEMENT_STANDARD.md`，按通用产品资产、项目专属资料、跨项目过程资料或治理规则自动落位；大文件、微盘原件、视频和压缩包默认只登记来源与派生产物，不整包复制进 Git。 - 当任务涉及产品设计、出方案、UI 原型、蓝湖/MCP、Stitch/Readdy/GemDesign、架构图、UML、流程图、时序图或平安云厨资料时，必须使用 `standards-stack/agent-skills/skills/product-design-solution-workspace/SKILL.md`：先读 `modules/product/README.md`、`modules/product/ui/README.md`、`product_pingan_yunchu/README.md` 和 `product_pingan_yunchu/source-index.md`，按产品方案、UI/设计、架构建模、可执行原型和历史归档分类处理。 - 当 Markdown 产品简介、竞品参考资料、视频中的 PPT 方法或售前方案需要生成康比特产品简介 PDF/PPT 时，必须使用 `standards-stack/agent-skills/skills/product-intro-pdf-generation/SKILL.md`：先定主题、受众、页数和每页内容，再定整套视觉方向，最后生成可编辑源文件和 PDF；验收标准是“讲清楚、看得懂、能继续改”，不得只交一次性展示图。 - 当任务涉及企业微信微盘、公司知识库、项目交付管理共享空间、数字技术中心知识库，或需要从产品/交付/开发共享资料中检索方案、手册、接口、部署、运维、安全、设备、报价、验收材料时，必须使用 `standards-stack/agent-skills/skills/company-wedrive-knowledge-base/SKILL.md`：先读 `modules/project/README.md`、`work_company_knowledge/README.md` 和 `work_company_knowledge/knowledge-map.md`，优先使用派生索引定位源文件；不得批量复制原始二进制资料进仓库。 - 当企业微信、微盘、同步盘、视频、PPT、PDF、压缩包或数据集等来源文件过大，或不同同事可能没有同一绝对路径时，必须使用 `standards-stack/agent-skills/skills/large-source-asset-management/SKILL.md`：像管理代码仓库一样管理大文件资料，原始文件留在外部真相源，`zhctprompt` 只保存 asset id、相对源路径、SHA256、本地根路径映射、获取方式和小体积派生产物；不得把某个人本机绝对路径当作唯一恢复入口。 - 当任务涉及交付实施部录音、会议转写、复盘 PDF、项目经验包、问题闭环，或用户要求“录音存微盘并和项目关联”“形成交付实施部专属知识库/agent”时，必须使用 `standards-stack/agent-skills/skills/delivery-recording-knowledge-agent/SKILL.md`：先读 `work/delivery-assetization/recording-knowledge-base/README.md` 和 `topic-index.md`，原始录音只登记微盘 root key、相对路径、SHA256、时长和权限，不复制进 Git；`zhctprompt` 只保存转写文本、来源索引、经验包、问题闭环、HTML review 和可复用 agent 规则。 - 当用户问到 `什刹海`、`什刹海体校`、`科训`、`科学训练数字化平台`、`sch1.0new`、`侯爽`、`交钥匙`、`目录链`、数据库账号密码、企业微信群聊或企业微盘材料时，必须使用 `standards-stack/agent-skills/skills/shichahai-project-knowledge/SKILL.md`：先读取 `work_sch1.0new/` 中的项目知识库、数据库口径和微盘索引；数据库口令只从本机忽略文件 `config/local/shichahai-db.env` 回读，不写入可提交规则、skill 或任务索引。 - 当任务目标是 `sch1.0new` 时，先读取 `work_sch1.0new/README.md`、`work_sch1.0new/CODE_REPOSITORY.md`、`work_sch1.0new/OPERATION_PLAYBOOK.md`、`work_sch1.0new/PROJECT_MAP.md`，再进入目标仓库读取 `AGENTS.md` 和代码。 - 当任务目标是 `sxtyj` 的广东反兴奋剂项目、`fxfj_0110` 分支、`gdfxfj` 或用户提到“广东反兴奋剂”时，先读取 `work_sxtyj_gdfxfj/README.md`、`work_sxtyj_gdfxfj/CODE_REPOSITORY.md`、`work_sxtyj_gdfxfj/OPERATION_PLAYBOOK.md`、`work_sxtyj_gdfxfj/PROJECT_MAP.md`，再进入 `zhctproject/sxtyj` 确认分支为 `fxfj_0110` 并读取项目内 `skills/gdfxfj-data-ops/SKILL.md`；批量导入运动员/教练时还必须读取 `skills/online-athlete-import/SKILL.md`。 - 当任务目标是 `ydysskz`、智慧餐厅运动员版本、运动员膳食系统、山西体科所运动员版本或分支 `develop_sxtksydyss_20260615` 时，先读取 `work_ydysskz/README.md`、`work_ydysskz/CODE_REPOSITORY.md`、`work_ydysskz/OPERATION_PLAYBOOK.md`、`work_ydysskz/PROJECT_MAP.md`，再进入 `zhctproject/ydysskz` 确认分支；山西体科所专属配置目录、客户标识、数据库名、日志路径、OSS、人脸库 group id 和业务名称未确认前，不得直接复用其他体科所配置。 - 当任务目标是 `qc` 时，先读取 `work_qc/README.md`、`work_qc/CODE_REPOSITORY.md`、`work_qc/OPERATION_PLAYBOOK.md`、`work_qc/PROJECT_MAP.md`，再进入目标仓库读取 `README.md` 和代码。 - 当任务涉及 `zhctproject/sxtyj/public/static` Vue 前端依赖安装或构建失败，尤其是 `chromedriver@2.46.0` 下载超时、`node-sass/vendor` 缺失或 `echarts/map/js/world_new` 找不到时，必须使用 `standards-stack/agent-skills/skills/sxtyj-frontend-dependency-repair/SKILL.md`：`world_new` 的项目真源是 `public/static/src/common/world_new.js`，缺失时复制到 `public/static/node_modules/echarts/map/js/world_new.js`，不得把源码 import 改成 `world.js` 来绕过。 - 当任务目标是 `food_safety` 时，先读取 `work_food_safety/README.md`、`work_food_safety/CODE_REPOSITORY.md`、`work_food_safety/OPERATION_PLAYBOOK.md`、`work_food_safety/PROJECT_MAP.md`，再进入目标仓库读取 `AGENTS.md`、`README.md` 和最近的子目录规则。 - 当任务目标是 `win_deploy_guoxin` 时，先读取 `work_win_deploy_guoxin/README.md`、`work_win_deploy_guoxin/CODE_REPOSITORY.md`、`work_win_deploy_guoxin/OPERATION_PLAYBOOK.md`、`work_win_deploy_guoxin/PROJECT_MAP.md`，再进入 `zhctproject/win_deploy_guoxin` 读取 `README.md` 和 PowerShell 脚本。 - 当用户提到“国信项目物理服务器前厅部署”“国信前厅部署”“江苏国信前厅”“国信 Linux VM 部署”“国信物理服务器”等关键词时，默认路由到 `work_win_deploy_guoxin`；先读 `work_win_deploy_guoxin/source-assets/README.md`、`work_win_deploy_guoxin/worklog/2026-06-19-jiangsu-guoxin-frontdesk-source-intake.md` 和 `work_win_deploy_guoxin/qa/2026-06-19-linux-vm-frontdesk-deployment-lessons.md`。该场景实际沉淀的是国信前厅 Linux VM / openEuler 部署资料，不要误当成 Windows Server 原生脚本；SQL dump、发布包和现场脚本补丁只登记哈希，不复制进 Git。 - 当任务目标是 `laidisen`、`莱迪森` 或 `南京建宁中学` 时，先读取 `work_laidisen/README.md`、`work_laidisen/deployment-progress.md`、`work_laidisen/OPERATION_PLAYBOOK.md`、`work_laidisen/PROJECT_MAP.md` 和 `work_laidisen/source-index.md`；客户 VM 密码、手机号、内部 OSS 地址只允许临时使用或脱敏记录，不得写入可提交文件。 - 当拉取、克隆、移动或新增 `zhctproject/android/` 下的一级 Android 项目时，必须立即读取 `work_android/README.md` 和 `work_android/PROJECT_INDEX_PROMPT.md`，更新 `work_android/PROJECT_INDEX.md`；若项目专属提示词目录不存在，同时创建 `work_android/{项目名}/README.md`。完成前必须运行 `control/scripts/check-android-project-index.sh`，确认没有 Android 项目遗漏。 - 当任务目标是 `/Users/liang/AndroidStudioProjects/MultipurposeMachine` 时，必须使用 `standards-stack/agent-skills/skills/multipurposemachine-change-recording/SKILL.md`：所有本项目代码、资源、配置、Manifest、Gradle、文档或本地 hook 改动都要记录到 `work_android/MultipurposeMachine/change_records/CHANGELOG.md`；完成验证后、最终回复前必须检查并追加本次记录，不能只用 Git commit、聊天总结或终端输出替代。 - 每个项目先读本项目规则，再决定是否能改代码。 - 每个新任务如果需要修改对应子项目，必须先在该子项目基于最新 `master` 新建任务分支；没有完成分支切换前不得改代码。 - 同一个子项目存在并行任务时，必须使用独立 `git worktree` 隔离工作空间；一个任务对应一个任务分支和一个 worktree，禁止在同一个子项目目录里来回切分支并行开发。 - 同一子项目并行前必须先锁定共享契约和写路径边界；涉及同一 API、DB、权限、菜单、配置、公共组件或重叠文件时，先串行处理共享契约，不得直接并行编码。 - 每个切片必须有验收标准、验证命令或证据产物。 - 手册和视频是正式交付物，不是附属材料。 - 所有项目 bug 不需要产品人评审，开发人根据客户、交付人、产品人或其他用户反馈自行创建云效任务并修复；所有项目新需求必须先由交付人记录在线表格，经产品人评审通过后登记到云效，开发人再依据云效开发。该约定包含 206 项目。 - 不要在 `zhctprompt` 里复制业务代码；这里保存控制资产、证据和规范。 - 不要跨多个代码项目同时改共享契约，除非队列里显式声明并行边界。 ## 有道云文章默认入口 - 当用户要求调用有道云 CLI 获取 `《群聊_xxx_来源微信》`，并在企业微信微盘创建项目售前/售中/售后资料夹、软硬件在线表格或按“以前这个项目规范”建档时，必须使用 `standards-stack/agent-skills/skills/youdao-chat-wedrive-project-intake/SKILL.md`：直接走固定快路径，先 `youdaonote search/read` 精确回读，再在 `项目交付管理共享空间/未排期项目/` 创建或复用项目目录；用户说“售中”统一映射为 `【02】交付阶段`；软硬件智能表格复用固定字段，不重新摸索 schema；默认不跑全量微盘索引，除非用户明确要求刷新全局索引。 - 当用户提供微信公众号 `mp.weixin.qq.com` 链接，并要求保存到有道云、沉淀成 skill、更新 Codex 记忆或让其他同事默认学会时，必须使用 `standards-stack/agent-skills/skills/wechat-article-youdao-intake/SKILL.md`：先用有道云 CLI 剪藏并回读校验；如果微信验证码导致只保存了验证页，必须把剪藏重命名为 `验证码拦截待恢复：...`，再创建结构化恢复笔记，记录原链接、规范化链接、note ID、阻断证据和下一步恢复方式；不得把验证码页当正文，不得伪造文章摘要。 - 当用户只发送或主要发送中文书名号标题，例如 `《xx》`，默认理解为：`调用有道云 cli获取这篇文章《xx》`，先用 `youdaonote list` / `youdaonote version` / `youdaonote search` / `youdaonote read` 获取正文。 - 当用户发送 `mp.weixin.qq.com` 微信公众号文章链接，并要求保存到有道云、归档文章、沉淀 skill 或更新 Codex 记忆时，必须使用 `standards-stack/agent-skills/skills/wechat-article-youdao-intake/SKILL.md`：先把 `image_detail` 链接归一为 `/s/`，去除 `poc_token` 等一次性参数，再优先用 `youdaonote` CLI 或已登录有道云桌面端保存到专门目录/独立笔记，例如 `微信文章归档`；不得写入每日工作笔记如 `2026-05-27`。若微信返回安全验证、正文不可用或无法可靠创建目录，只能记录 blocker，不得声称已完整保存全文。 - 如果有道云文章内出现 GitHub 项目 URL、`owner/repo` 仓库坐标、Claude Code plugin marketplace 安装坐标等，应识别为文章相关 GitHub 项目。 - 对文章相关 GitHub 项目，默认 fork 到 `jiangyang118/`；本地 clone 到 `/Users/jack/code/099-github/jiangyang118/`，已存在则复用并检查状态。 - 完成后在本控制项目沉淀 intake 证据，至少记录有道云 note ID、文章标题、项目 URL、fork URL、本地路径、验证命令和可复用规则。 ## 默认生命周期 对每个队列项执行： 1. DEFINE: 明确目标、范围、非目标、目标项目 2. PLAN: 生成最小切片、任务分支、验证命令、证据路径 3. BUILD: 在目标项目实施代码或文档 4. VERIFY: 运行测试、截图、手册 QC 或视频核验 5. REVIEW: 检查 diff、证据、风险、回滚；用户可见功能测试通过后补齐 Markdown 手册、Word 手册、截图和操作视频材料 6. SHIP: 更新 `tasks/QUEUE.md`、`HEARTBEAT.md` 和证据路径 ## 停止规则 只在以下情况停止当前切片： - 目标项目规则缺失且任务高风险 - 目标文件存在非本次产生的用户改动 - 需要改子项目但无法从 `master` 创建独立任务分支 - 同一子项目并行任务无法创建独立 worktree，或写路径/共享契约存在冲突 - 登录、数据库、密钥、设备、SDK 等前置条件不可用 - 验证命令不可运行且没有替代证据 - 涉及支付、认证、权限、数据库结构、设备控制等高风险契约 - 手册/视频采集会触发写入动作、审核动作或敏感信息泄露 停止时必须写清： - blocked path - blocked command - observed output - missing input - next safe action