产品经理的 AI 协作驾驶舱 — One cockpit for the entire PM workflow, powered by AI.
把需求、规格、原型、评审与复盘中的工作规范，整理成 AI 可以遵循的规则、模板和技能。
在自己的工作区里建立项目，让 AI 按规范完成任务，并将确认后的背景、决策、业务规则和变更维护到对应文件。后续继续需求或修改原型时，AI 按任务读取相关依据，沿着项目已有的工作继续推进。
支持 ZCode、Claude Code、WorkBuddy 和 Codex。最新变化见更新日志。
- 同一个功能，换一天或换一个 AI 工具，需求和原型的格式、字段、详略就不一致。
- 项目推进一段时间后，背景、约束和决策散在不同会话里，继续工作需要反复交代。
- 原型已经修改，规格和需求还停留在旧版，后续交付依据对不上。
- 做完项目留下交付物，却没有把可复用的方法与经验整理出来。
PMCockpit 将工作规范、项目依据和执行流程放进同一个工作区：规则定义边界，模板固定产物结构，Skill 按任务组织执行，项目文件保存已确认的工作依据。
- 按规范完成产品工作：覆盖项目与版本管理、需求、页面规划、规格、原型、调研、材料入库和复盘；根据任务选择对应流程。
- 持续维护项目上下文：背景、业务规则、关键决策、需求、设计和变更分别维护在对应文件，通过索引按需读取，并区分已确认、待确认和历史内容。
- 页面规划、规格与原型衔接：统一使用
prototype-html-pin，可只规划、只出规格、生成原型或修改已有页面。新 PC 后台与门户采用 React 和 Ant Design，手机网页采用 Ant Design Mobile；原型保留 Pin 说明供评审。 - 按功能点回写变更：原型确认后，按授权同步对应规格和需求；局部功能点变化可输出变更单，基准 PRD 保留在来源版本。
- 按职责沉淀经验：项目案例留在项目中，经确认且可跨项目复用的方法进入通用规则，原始资料保留来源与日期。
- 多工具共用工作资产：支持的 AI 工具使用同一套核心 Skill；详细规则按任务加载。测试、文档站、画板和类型化判定按需启用。
已安装 ZCode、Claude Code、WorkBuddy 或 Codex 中的一种后，将公开模板复制到独立工作区再使用：
# 获取公开模板
git clone https://github.com/wsdlp46/PMCockpit.git
# 复制到新的独立工作区，保留模板中的隐藏文件
mkdir -p ../我的工作区
rsync -a --exclude='.git' --exclude='.DS_Store' PMCockpit/ ../我的工作区/
cd ../我的工作区
# 安装核心 Skill
bash .ai/install.sh打开 AI 工具，将工作目录指向“我的工作区”。首次使用建议先运行十分钟演练，再建立真实项目。
安装脚本会检测支持的工具，将核心 Skill 链接到对应工具目录；仅 ZCode 额外链接方案设计 Agent。各工具发现和调用 Skill 的方式见工具适配说明。未自动识别时，可以直接告诉 AI 所需的 Skill 名称。
首次生成 React 原型时，需要满足工程要求的 Node.js 运行时并安装项目依赖；AI 会按原型环境引导检查。仅阅读文档、规划页面或编写规格不触发原型依赖安装；交付 HTML 的接收者无需安装工程依赖。
真实项目保存在独立工作区中。已有业务内容的工作区，请按文末升级说明处理。
模拟项目：智慧园区巡检提供模拟背景、会议纪要与逐步提示词。产物在自己的 02当前项目/ 中生成，样例目录保留为演练输入。
日常使用可以这样开始：
| 当前任务 | 可以对 AI 说 |
|---|---|
| 建立项目 | 新建项目：{项目全称}。按项目模板建立骨架，只填写已确认事实，先不创建版本。 |
| 归档新输入 | 将这份会议纪要入库到 {项目全称} 的 {版本}，整理时间线、待确认决策和相关索引。 |
| 开启版本 | 开始新版本：{项目全称} V1.0.0。范围是……，来源版本为无，请先确认范围和目录。 |
| 编写需求 | 根据本版本范围和关键决策编写需求，先判断适合完整 PRD、轻量改动清单还是单功能点变更单。 |
| 设计页面 | 根据已确认需求规划页面，确认规划和规格后，再生成带 Pin 说明的交互原型。 |
| 修改与回写 | 修改这个页面的……。先交原型评审，确认后按授权同步对应规格和功能点需求。 |
| 版本收尾 | 检查本版本的完成情况和索引，复盘问题、推迟事项及可复用经验。 |
一般流程为：
建立项目 → 规划版本 → 编写需求 → 页面规划、规格与原型 → 评审与确认
→ 交付与验收 → 版本收尾与复盘
TAPD、测试、文档站和外部发布按项目需要进入。外部写入须明确目标与范围；未启用渠道时，继续完成本地需求、规格与原型交付。
项目上下文是理解和推进项目所需的背景、事实、规则、决策、设计与进展等信息，由实际形成的项目文件共同承载。项目总览、原始输入、业务规则、关键决策、设计基线、需求、规格、原型、测试与交付记录、变更、待办和案例等文件分别保存相关信息。项目总览和索引帮助人和 AI 找到当前任务所需的依据。
| 工作节点 | 维护内容 |
|---|---|
| 材料入库 | 保留原件与转换稿，整理时间线、待确认决策和必要索引 |
| 需求与设计 | 读取相关业务规则、关键决策和设计基线，在对应版本形成需求、规格和原型 |
| 原型确认与变更 | 按授权维护受影响的规格、功能点需求和变更记录 |
| 收尾与复盘 | 校正状态和待办，评估项目案例与通用方法的沉淀去向 |
更新遵循各环节原有的确认和回写要求。AI 按任务读取相关文件，不全量预载项目；日常沟通中发现决策、规则或待办变化时，按既有流程维护。
项目上下文包含进行中的工作依据，也保留状态明确的待确认事项和历史记录。它不承诺所有聊天自动保存、所有文件自动同步或项目资料始终最新。完整定义见项目结构与版本治理。
资料库保存原始材料、转换稿和参考代码；项目结论维护在对应权威文件。优先使用相关项目依据和已有资料；用户要求调研，或判断依赖尚未核实、冲突或可能过时的外部事实时，按需查证并记录来源。
我的工作区/
├── AGENTS.md 工作区规则与任务入口
├── .ai/
│ ├── install.sh 核心与可选能力安装
│ ├── TOOL-MAPPING.md 工具适配说明
│ ├── skills/ 核心 Skill
│ ├── optional-skills/ 可选 Skill
│ └── agents/ 方案设计 Agent
├── 00环境配置/ 外部能力登记与受控配置；凭证不入库
├── 01通用规则/ 工作流、方法论、模板、设计规范与检查清单
├── 02当前项目/ 项目总览、基线、迭代、案例与对外材料
├── 03知识库/ 原始资料、转换稿与参考资料的定位入口
├── 04历史项目/ 已结项项目
├── 05经验总结/ 复盘、项目总结与经验输出
├── 06治理文档/ 模板巡检清单与检查脚本
├── examples/ 模拟项目与演练输入
└── _附件/ 图片、PDF、Excel 等二进制文件
核心 Skill 内置于 .ai/skills/，以实际目录和各自 SKILL.md 为准：
| Skill | 用户任务 | 职责 |
|---|---|---|
project-iteration |
开启新版本、版本收尾、校正索引 | 管理既有项目的版本生命周期；首次建项目由主 Agent 按项目模板执行 |
prd-writer |
写需求、轻量改动清单、功能点回写 | 判断需求场景，按范围输出 PRD、清单或变更单 |
prototype-html-pin |
页面规划、页面规格、HTML 原型、原型修改与评审 | 统一页面设计流程，新页面确认规划与规格后实现，存量页面沿用既有源码路线 |
research-pm |
市场、客户、行业、政策与竞品调研 | 确认主题、场景和用途，采集证据并形成决策依据 |
tapd-requirement-upload |
规划或上传 TAPD 需求 | 仅在项目启用且本轮需要，或用户明确要求时，按已确认文档规划并上传 |
project-intake-pm |
材料、会议纪要、网页链接入库 | 确认归属后归档材料，整理时间线、待确认决策、项目影响与索引 |
project-retrospective-pm |
项目或版本复盘、改进工作流 | 归因问题，评估事实、规则、技能、案例与方法的维护去向 |
另有方案设计 Agent solution-designer，仅向 ZCode 链接。它按相关项目依据、使用者案例和通用方法设计方案；没有可复用案例时须说明，不能虚构先例。
| 能力 | 适用条件 | 启用方式 |
|---|---|---|
| 测试闭环 | 版本已提测，或明确需要测试规划、用例、执行、报告或回归 | bash .ai/install.sh --with-test |
| VitePress 文档站维护 | 已有独立站点，需要同步、构建、部署或排障 | bash .ai/install.sh --with-vitepress |
| ardot 画板原型 | 本机已安装 ardot，并能运行其 MCP 服务 | bash .ai/install.sh --with-ardot |
| TypeSafe 类型化判定 | 需要可复核的语义分类或判断，并已有 API Key | bash .ai/install.sh --with-typesafe |
TypeSafe 安装时提示输入 API Key，写入工作区受控凭证文件，目录已忽略且文件权限为 600。未启用或未配置时跳过相关判定，不自动安装或直接调用 API。
框架不提供文档站、ardot 应用、服务器、账号或 API Key。实际连接以使用者环境为准；渠道操作遵守目标、范围和权限约束。
建议先备份已有工作区，再按差异合并通用规则、技能与模板。保留已有项目、资料、个人配置和凭证，不直接覆盖整个业务工作区。
- 页面规格入口合并：
proto-spec-generator已退役，职能并入prototype-html-pin。更新调用说明和安装链接，核对旧技能链接后清理；安装脚本不会自动移除所有旧链接。 - 原型路线兼容：新页面使用真实 Ant Design 组件；已有 HTML 源码和本地 scaffold 继续使用，既有目录和工程不自动迁移。
- 资料与经验落点调整：旧
03知识库/知识大脑/、03知识库/工作案例库/不再由新版规则维护。已有内容请保留并核对：已确认的项目事实维护到项目权威文件，案例归入项目案例沉淀/，可复用方法经确认后进入通用规则，原始证据继续归档。 - 项目上下文沿用既有结构：项目总览、基线和迭代索引继续承担导航，按需补充加载入口、设计基线和待办，不另建全量汇总文档。
- 可选能力保持显式启用：更新核心技能不会自动启用可选能力，外部平台不作为本地交付的必经环节。
逐项变化见更新日志。安装或路由遇到问题时，先检查工具适配说明与对应 SKILL.md；反馈时附工具版本、提示词、错误和复现步骤。
V2.2 及之前拆分的独立 Skill 仓库已停止维护，V2.3 起统一在本仓库维护。旧用户请以本仓库为准核对迁移。
Apache License 2.0。原型生成方案基于 vagerent/prototype-html（Apache 2.0）改造，在此致谢。
可选能力 .ai/optional-skills/typesafe-ai/ 为第三方 Skill，遵循其 SKILL.md 声明的 MIT License，版权归原作者所有。
作者：青燃AI说（GitHub @wsdlp46）。欢迎反馈使用问题与改进建议。