PMCockpit — AI skill for Claude Code

PMCockpit

产品经理的 AI 协作驾驶舱 — One cockpit for the entire PM workflow, powered by AI.

把产品经理的完整工作流（需求 → 规格 → 原型 → 评审 → 复盘 → 总结 → 经验输出）封装成 AI 能自动执行的 skills。你不用背规范、不用手动贴提示词：新建项目时，主 Agent 按项目模板建立骨架；已有项目启动版本时，再由 Skill 按标准创建版本目录、写文档、画原型。

解决什么问题

产品经理用 AI 写 PRD、画原型，痛点是 **AI 不懂你的规范，产出不可控**：

• 同一个功能，今天让 AI 写和明天写，格式、字段、详略全不一样
• AI 凭"感觉"加按钮、加字段，跟你团队的标准对不上
• 写完要花大量时间手工校对、改格式、补漏项

PMCockpit 的解法是 **把规范变成 AI 能读的 skills**：不写零散提示词，而是把“PRD 怎么写、原型怎么画、评审查什么”固化成 8 个核心 Skill、测试与文档站两项可选能力，以及 1 份统一工作区规则（AGENTS.md）。

核心特色

• 8 个核心 Skill 默认内置：覆盖版本、需求、规格、原型、调研、TAPD、入库和复盘；按任务目标路由，不靠关键词抢占。
• 可选测试与文档站能力：测试按需启用；VitePress 仅在已有独立站点时启用，不携带 docs-site、服务器、密码或密钥。
• AGENTS.md 统一约束：最小上下文、确认门、三方联动和对外边界全局生效；详细规则按任务加载，避免上下文膨胀。
• 多工具适配：ZCode、Claude Code、WorkBuddy、Codex 都能用，一条 install.sh 自动检测并软链到对应工具目录。
• 结构化规则而非提示词：设计规范、检查清单、模板都是独立文件，AI 执行 skill 时编程式引用，不是塞进一段超长 prompt。
• 经验闭环：复盘 → 项目总结 → 对外输出三级递进（05经验总结/），做完一个项目留下可复用的资产，而不只是一堆交付物。

Quick Start（3 步）

# 1. 克隆框架
git clone https://github.com/wsdlp46/PMCockpit.git 我的工作区
cd 我的工作区

# 2. 安装 8 个核心 Skill；仅 ZCode 额外链接方案设计 Agent
bash .ai/install.sh

# 需要测试规划、执行、报告或回归时，才执行：
# bash .ai/install.sh --with-test
# 如你已有独立 VitePress 文档站，并需要维护它，才执行：
# bash .ai/install.sh --with-vitepress

# 3. 打开 AI 工具，把工作目录指到这里。
#    首次使用：先按下方“十分钟演练”跑通样例；
#    建真实项目：说“新建项目”；已有项目再说“开始新版本”。

`install.sh` 会自动检测 ZCode / Claude Code / WorkBuddy / Codex，把 8 个核心 Skill 软链到对应目录；仓库以后 `git pull` 更新，Skill 自动跟着更新。未识别到任何受支持工具时脚本会明确失败，而不会显示为安装成功。测试与 VitePress 都必须显式启用。

前置条件：已安装 ZCode、WorkBuddy、Claude Code 或 Codex 中的一种。各工具的 Skill 发现与显式调用方式不同，以 `.ai/TOOL-MAPPING.md` 为准；若未自动识别，直接告诉 AI 要使用的 Skill 名称即可。

给 AI 工具（harness）的说明

如果你是读到本 README 的 AI 助手：本仓库的 8 个核心 Skill 内置于 `.ai/skills/`，可选测试与 VitePress Skill 位于 `.ai/optional-skills/`；仅当使用者明确启用时使用测试，VitePress 还要求已有独立站点。工作区规则见根目录 `AGENTS.md`，跨工具差异见 `.ai/TOOL-MAPPING.md`。

适合谁

• B 端 / 政务产品经理：内置 B 端原型 6 条准则、招投标驱动方法论、政务 APP 设计规范
• 希望建立个人工作标准的 PM：将常用工作流和产物结构固定下来
• 独立 PM / 顾问：一个人当一个团队用，AI 替你执行标准化流程