团队协作完整指南，
入口、步骤和方法都在这里

新同事第一天怎么用

第一步，只读五个入口：

第二步，给 AI 发任务时按模板说清楚：

我要做的事：
背景：
相关资料或路径：
属于产品类还是项目类：
目标用户或阅读对象：
希望输出：
验收标准：
不要做什么：

第三步，不要直接让 AI “改一下”。先让 AI 归类：

先帮我判断这件事属于产品类、项目类、代码类、交付资产类还是知识库类；
再告诉我应该放到哪个目录、用哪个索引、输出什么证据。

总体结构：项目类 + 产品类

你可以先把 zhctprompt 理解成两大类入口：

再加三类支撑目录：

产品类目录怎么用

产品人优先从这里进入：

modules/product/

常用子入口：

产品人整理资料时遵守三条规则：

1. 产品需求、PRD、流程、验收标准放产品模块，不要散在聊天记录里。
2. 项目中沉淀出的通用产品能力，要从 work_<project>/ 回收到 modules/product/ 或 standards-stack/。
3. 客户案例、上线状态、收入、设备数量、验收结果必须有证据；没有证据只能写 待确认。

项目类目录怎么用

项目、客户、交付资料优先从这里进入：

modules/project/

常用入口：

项目资料进入执行前，先写清楚：

客户/项目：
当前阶段：
资料来源：
业务场景：
涉及角色：
软件入口：
硬件触点：
验收指标：
风险和缺口：

如果是某个项目的长期事实，不要只放在通用 work/，要进入对应 work_<project>/。如果还没有目录，先建立新的 work_<project>/。

各个顶层目录怎么用

work/ 一级目录较多，不在本团队说明里重复嵌入完整清单。协同者点击 work/work-directory-guide.html 后，可按月份或关键词检索每个文件夹；Agent 维护 work/WORK_DIRECTORY_GUIDE.md，两者由 control/scripts/generate_work_directory_guide.py 同源生成。

企业微信微盘怎么和本项目配合

企业微信微盘仍然是原始资料真源。本项目只保存派生索引和少量可读快照。

当前主要资料源：

使用原则：

1. 先用索引找，不要在微盘里盲翻。
2. 只打开当前任务需要的少量源文件。
3. 不批量复制微盘原始大文件、合同附件、证书、安装包、SQL dump 到 Git。
4. 需要正文级处理时，先登记来源，再转换成 Markdown/CSV 派生产物。
5. 在线表格是快照，不代表实时状态；要用最新数据时必须重新导出或走可用 API。

产品人使用微盘的推荐路径：

1. 先看 work_company_knowledge/knowledge-map.md 判断资料域
2. 再用 indexes/document-index.tsv 按 role_lane=product 或 presales 过滤
3. 找到 abs_path 后打开微盘原件
4. 把可复用结论沉淀到 modules/product/ 或 work_<project>/
5. 把仍缺的数据写成 evidence gap，不要补编

交付人使用微盘的推荐路径：

1. 先看 indexes/project-index.tsv 定位客户项目
2. 按 stage=delivery/training/acceptance/operations 找材料
3. 把现场反馈拆成 bug 或新需求
4. bug 直接进入云效；新需求先进在线表格并等产品评审
5. 验收截图、手册、培训材料回填到项目证据

开发人使用微盘的推荐路径：

1. 先看 indexes/document-index.tsv 按 role_lane=development 过滤
2. 找接口、部署、运维、安全、设备对接和测试资料
3. 代码仍在 zhctproject/<repo> 或 control/local-paths.md 登记的业务仓库
4. 修改前先读目标项目规则；业务仓库按其分支规则执行，控制项目按当前 master 同步规则执行
5. 测试和回滚说明写回 work_<project>/summary.md

AI 协作的标准流程

一次任务完整流程：

DEFINE -> PLAN -> BUILD -> VERIFY -> REVIEW -> SHIP

任务类型判断：

团队成员要会用的三类资产

截至 2026-08-17，standards-stack/agent-skills/skills/ 下实际共有 246 个 Git 跟踪的 SKILL.md。团队执行时以实际目录和路由规则为准。

最重要的分工：

Markdown 给 Agent 和后续维护人读。
HTML 给人 review、展示、培训和交接。
Skill / workflow 给下次同类任务复用。

知识库、项目库和团队入口总导航

这块把团队最常用的 HTML、Markdown 知识库、项目库、微盘派生索引和 skill 安装入口集中挂出来。原则是：能点到真实文件；原始大文件仍留在微盘或本机源目录，项目里只放索引和派生成果。

团队常用方法论工具箱

2026-06-09 从有道云《姜阳的聊天记录_202606081637_来源微信》目标聊天记录图片中恢复了一组产品经理方法论卡片。团队成员不用背所有模型，先按任务场景选工具。

2026-06-11 追加有道云《一套可复用的【需求四层】判断法，帮你在动手前先看清需求真伪》：判断需求不要只问“真不真”，先看当前证据停在陈述层、触发层、代价层还是结构层。团队可读入口：

• 需求四层判断法 HTML
• 需求四层知识 Markdown
• PRD 需求分析 skill
• 四层判断 skill 参考

2026-06-18 追加有道云《从 PRD 到可验证代码：AI 需求开发闭环实践》：从 PRD、接口、设计稿或截图进入代码前，先形成 RequirementSpec、ArchitectureDesign、证据清单和验证策略，再进入实现、架构对齐、编译验证、视觉审计和经验沉淀。团队可读入口：

• PRD 到可验证代码闭环 HTML
• PRD 到可验证代码知识 Markdown
• PRD 到可验证代码 skill 参考
• Skill + Workflow 成套沉淀规范 HTML

快捷跳转：

完整图片证据和方法说明见：

work/2026-06-09-youdao-chat-model-smart-canteen-report/target-chat-methodologies.html
work/2026-06-09-youdao-chat-model-smart-canteen-report/target-chat-methodologies.md
work/2026-06-09-youdao-chat-model-smart-canteen-report/target-chat-method-map.csv

方法论速查：

在智慧食堂相关任务里，优先这样说：

请先判断这个问题更适合用哪类方法论：
战略判断、产品验证、用户体验、需求排期、增长续费、汇报复盘。
然后选 1-3 个模型分析，不要把所有模型平均铺开。
真实业务结论必须标证据等级；没有数据时只写假设和待补证据。

产品类 skill 有哪几类，怎么使用

产品类任务不要只说“帮我做个方案”。先判断它属于战略、需求、竞品、方案、专项、接口验证还是视觉表达，再让 Agent 调用对应 skill 组。

高频项目核心 skill 速查与实例

下面这张表覆盖一批高频项目核心 skill；当前实际 246 个 skill 以目录为准，下一节保留 172 项历史说明快照供检索。新手不需要背名称，但要会用“场景 + 资料路径 + 输出 + 验收标准”的方式让 Agent 自动路由。

Skill 到底有几种用法

新手不要先背所有 skill 名称。先理解：skill 是让 Agent 不从零摸索的可复用工作方法。它既可以是项目规则，也可以是本机能力、任务路由、方法论、交付流程或团队治理规则。

最简单的判断：

只是一次性资料说明 -> 写 Markdown / HTML。
会重复发生、容易出错、需要 Agent 以后自动遵守 -> 才考虑做成 skill。
项目团队都要遵守 -> 放进 zhctprompt 项目 skill。
只有某个人本机常用 -> 放进本机 Codex skill。

所以新手不用问“我该调用哪个 skill”。更有效的说法是：把任务背景、资料路径、目标、验收标准说清楚，再补一句“如果有合适的项目 skill，优先按 skill 执行”。

五模块怎么和日常工作对应

推荐给新人直接复制的提问模板

我要加入这个项目协作，请先帮我判断我的任务归属。

我要做的事：
资料来源：
属于产品类还是项目类：
涉及客户/项目/产品：
目标用户：
期望输出：
验收标准：
不能做的事：

请你先告诉我：
1. 应该读哪些入口文件；
2. 应该放到哪个目录；
3. 应该使用哪个微盘索引或项目库；
4. 应该使用哪些项目 skill；
5. 最后需要留下哪些证据。

不能做什么

• 不把业务代码复制进 zhctprompt。
• 不把企业微信微盘大文件、合同、证书、生产 SQL、密钥、账号密码批量复制进 Git。
• 不把没有证据的客户验收、收入、毛利、设备数量、上线状态写成事实。
• 不绕过云效、Codeup、测试、自测、手册和视频证据。
• 不在同一个业务仓库里并行切多个任务分支；并行任务用独立 git worktree。
• 不把 AI 输出直接当最终结论；重要决策必须有人 review。

最终记忆点

新人只要先记住三句话：

第一，zhctprompt 是团队 AI 协作控制项目，不是业务代码仓库。
第二，资料先分产品类和项目类：产品进 modules/product，项目进 modules/project 和微盘索引。
第三，任何有价值的工作都要留下可恢复证据：Markdown 给 AI 继续，HTML 给人 review，索引给团队复用。