pm-workflow-studio 0.1.0

package/.claude/skills/quality-review/templates/review-stage.md

@@ -0,0 +1,39 @@
+# 阶段 {{STAGE}} 审核报告
+
+> 本报告由质量审核官根据阶段产物生成。脚本可生成草稿，最终结论由审核角色确认。
+
+## 审核轮次
+
+- 当前轮次：{{ROUND}}
+- 最大轮次：3
+- 结论：{{RESULT}}
+
+## 评分
+
+| 维度 | 分数 | 说明 |
+|---|---:|---|
+| 完整性 | {{COMPLETENESS}}/10 | {{COMPLETENESS_NOTE}} |
+| 清晰度 | {{CLARITY}}/10 | {{CLARITY_NOTE}} |
+| 一致性 | {{CONSISTENCY}}/10 | {{CONSISTENCY_NOTE}} |
+| 可执行性 | {{EXECUTABILITY}}/10 | {{EXECUTABILITY_NOTE}} |
+| 平均 | {{AVERAGE}}/10 | {{AVERAGE_NOTE}} |
+
+## 仿真测试
+
+{{SIMULATION}}
+
+## 结构化对账
+
+{{RECONCILIATION}}
+
+## 问题清单
+
+{{ISSUES}}
+
+## 返工建议
+
+{{REWORK}}
+
+## 下一步建议
+
+{{NEXT_STEP}}

package/.claude/skills/tech-architecture/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: tech-architecture
+description: "技术架构师使用：产出技术选型、数据模型、接口清单、部署方案和需求到架构的映射。"
+---
+
+# 技术架构角色技能
+
+服务于本工作室的技术架构师角色。
+
+## 输入
+
+- `docs/prd.md`
+- `docs/handoff-prd.md`
+- 用户提供的技术约束
+
+如果架构设计改变需求、平台、范围、功能编号或技术约束，必须同步回写 `docs/prd.md` 和 `docs/handoff-prd.md`，并在 `docs/workflow-state.json` 的 `notes` 记录同步说明。
+
+## 输出
+
+- `docs/tech-architecture.md`
+- `docs/handoff-architecture.md`
+
+## 五维度决策
+
+- 开始前先输出阶段开场卡：当前用户情况、推荐方案、为什么这样选、接下来产出什么。
+- 平台类型
+- 复杂度
+- 数据规模
+- 第三方集成
+- 维护成本
+
+对小程序类产品，优先解释微信原生小程序 + 微信云开发是否足够；对网页、App、桌面软件，再比较技术栈。对不懂技术的用户，先讲目的、维护成本和未来迭代影响，再讲框架名。
+
+## 必须产出
+
+- 技术选型总览。
+- 数据库表、字段、类型、约束和来源功能编号。
+- 接口方法、路径、参数、返回值和权限。
+- 本地开发和部署方案。
+- 需求功能编号到数据、接口、部署影响的映射。
+- 上游同步记录：如因架构调整改变需求或约束，说明已回写的上游文档。
+
+## 检查表
+
+- P0 功能是否都有数据和接口支撑。
+- 是否存在过度架构。
+- 是否用用户能懂的话解释技术选型原因。
+- 是否清楚说明本地启动和部署。
+- 是否把未确认需求误放进架构范围。

package/.claude/skills/tech-architecture/templates/handoff-architecture.md

@@ -0,0 +1,28 @@
+# 技术架构交接摘要
+
+## 架构摘要
+
+- 前端：
+- 后端：
+- 数据库：
+- 部署：
+
+## 关键接口和页面影响
+
+| 功能编号 | 接口 | 影响页面/交互 | 备注 |
+|---|---|---|---|
+| M1-F1 | 待补充 | 待补充 | 待补充 |
+
+## 数据模型要点
+
+| 实体 | 关键字段 | 关联功能 |
+|---|---|---|
+| 待补充 | 待补充 | M1-F1 |
+
+## 界面设计需要注意
+
+- 待补充
+
+## 开发规划需要注意
+
+- 待补充

package/.claude/skills/tech-architecture/templates/tech-architecture.md

@@ -0,0 +1,54 @@
+# {{PRODUCT_NAME}} 技术架构方案
+
+## 技术选型总览
+
+| 层级 | 选型 | 版本/说明 | 选择理由 |
+|---|---|---|---|
+| 前端 | 待补充 | 待补充 | 待补充 |
+| 后端 | 待补充 | 待补充 | 待补充 |
+| 数据库 | 待补充 | 待补充 | 待补充 |
+| 部署 | 待补充 | 待补充 | 待补充 |
+
+## 五维度决策
+
+| 维度 | 判断 | 影响 |
+|---|---|---|
+| 平台类型 | 待补充 | 待补充 |
+| 复杂度 | 待补充 | 待补充 |
+| 数据规模 | 待补充 | 待补充 |
+| 三方集成 | 待补充 | 待补充 |
+| 维护成本 | 待补充 | 待补充 |
+
+## 数据库设计
+
+| 表 | 字段 | 类型 | 约束 | 来源功能编号 | 说明 |
+|---|---|---|---|---|---|
+| 待补充 | 待补充 | 待补充 | 待补充 | M1-F1 | 待补充 |
+
+## 接口清单
+
+| 功能编号 | 方法 | 路径 | 请求参数 | 返回值 | 权限 |
+|---|---|---|---|---|---|
+| M1-F1 | 待补充 | 待补充 | 待补充 | 待补充 | 待补充 |
+
+## 需求到架构映射
+
+| 功能编号 | 数据实体/表 | 字段 | 接口 | 部署/配置影响 | 技术风险 |
+|---|---|---|---|---|---|
+| M1-F1 | 待补充 | 待补充 | 待补充 | 待补充 | 待补充 |
+
+## 目录结构
+
+```text
+待补充
+```
+
+## 环境配置
+
+- 本地启动：
+- 环境变量：
+- 部署步骤：
+
+## 开放技术问题
+
+- 待补充

package/.claude/skills/ui-prototype-design/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: ui-prototype-design
+description: "界面设计师使用：选择设计方向、编写界面与体验文档，并构建高保真网页原型。"
+---
+
+# 界面原型设计角色技能
+
+服务于本工作室的界面设计师角色。
+
+## 输入
+
+- `docs/prd.md`
+- `docs/tech-architecture.md`
+- `assets/design-themes/`
+
+如果 UI 阶段新增或调整页面清单、交互路径、字段、状态、技术约束或验收标准，或发现页面/模块过多、流程不顺，必须同步回写 `docs/project-config.md`、`docs/prd.md`、`docs/handoff-prd.md` 或 `docs/tech-architecture.md`，并在 `docs/workflow-state.json` 的 `notes` 记录同步说明。
+
+## UI 硬规则
+
+- 页面可见文案、按钮、导航、空状态和提示语禁止使用 emoji。
+- 图标必须使用图标库、SVG 或图片资源，不用 emoji 代替。
+- 正文、表单、按钮、列表文本不小于 16px。
+- 辅助说明可小于 16px 但不得低于 14px；移动端优先保持 16px 起。
+
+## 输出
+
+- `docs/ui-design.md`
+- `docs/handoff-ui.md`
+- `docs/prototype-review.md`
+- `prototype/`
+
+## 设计流程
+
+1. 先做上游前置审查，确认高频真实需求、使用人群和真实使用流程清晰；发现歧义先报告。
+2. 推荐 2-3 个差异化设计方向。
+3. 为每个方向生成一个可打开的首页 demo，放在 `prototype/directions/`，并生成 `prototype/directions/index.html` 作为预览索引。
+4. 在 `docs/ui-design.md` 中写清每个方向的 demo 路径；没有 demo 的方向不得交给用户选择。
+5. 等用户选择，或在用户明确授权后使用第一推荐。
+6. 从真实使用流程推导页面访问逻辑，页面数量以完成高频路径为准。
+7. 设计页面清单、布局、组件、状态和流程；页面模块不能堆叠过多，能合并的入口、状态、表单、列表、详情必须合并。
+8. 基于选定方向构建完整高保真 HTML 原型。
+9. 在 `docs/ui-design.md` 记录页面访问逻辑和模块整合理由。
+10. 使用 Playwright 对候选 demo 和完整原型逐页截图，覆盖 desktop/tablet/mobile。
+11. 使用 Impeccable 做专项审查和修正，最多两轮。
+12. 写入 `docs/prototype-review.md`，记录截图证据、审查结论、修正项和遗留问题。
+13. 如 UI 决策改变上游事实，回写上游文档并记录同步说明。
+
+## Impeccable 使用清单
+
+开始自审前必须确认当前 CLI 结构下的 Impeccable skill 存在：Codex 检查 `.agents/skills/impeccable/SKILL.md`，Claude Code 检查 `.claude/skills/impeccable/SKILL.md`；不存在时停止，不做普通降级。
+
+1. 生成 Impeccable 上下文：Codex 写入 `.agents/context/PRODUCT.md` 和 `.agents/context/DESIGN.md`；Claude Code 可写入 `.claude/context/PRODUCT.md` 和 `.claude/context/DESIGN.md` 或沿用 `.agents/context/`。
+2. 运行当前 CLI 结构下的 `impeccable/scripts/load-context.mjs`，完整读取输出。
+3. 对候选方向 demo 使用 `critique` 和 `audit`，确认方向差异、视觉质量、AI 味和基础技术质量。
+4. 对完整原型使用 `critique`、`audit`、`adapt`。
+5. 根据问题选择 `layout`、`typeset`、`clarify`、`animate`、`harden` 修正。
+6. 功能路径、状态和响应式完成后，用 `polish` 做最终打磨。
+7. 在 `docs/prototype-review.md` 中逐项记录每个 Impeccable 功能的目标、发现和处理结果。
+
+功能用途：
+
+| 功能 | 用途 |
+|---|---|
+| `critique` | 审美、视觉层级、信息架构、AI 味、认知负荷、启发式审查 |
+| `audit` | 可访问性、性能、响应式、语义结构、反模式检测 |
+| `adapt` | 桌面、平板、移动适配 |
+| `layout` | 间距、对齐、节奏、布局稳定性 |
+| `typeset` | 字体层级、行高、可读性、文字拥挤 |
+| `clarify` | 按钮、空状态、错误提示、说明文字 |
+| `animate` | 动效、状态过渡、交互反馈 |
+| `harden` | 长文本、空数据、错误、加载、异常路径 |
+| `polish` | 最终综合打磨 |
+
+## 原型结构
+
+单页面产品：
+
+```text
+prototype/
+  directions/
+  index.html
+  layout/
+  assets/
+```
+
+多页面系统：
+
+```text
+prototype/
+  directions/
+  index.html
+  pages/
+  layout/
+  components/
+  assets/
+  review/
+    screenshots/
+```
+
+目录职责：
+
+| 路径 | 职责 | 产物要求 |
+|---|---|---|
+| `prototype/directions/` | 设计方向首页 demo | 每个候选方向必须有一个可打开的首页 demo；`index.html` 汇总 2-3 个预览入口，供用户选择方向。 |
+| `prototype/index.html` | 原型入口、全局导航、关键流程起点 | 必须能进入所有 P0 原型路径；多页面系统必须链接到 `pages/` 中的具体页面。 |
+| `prototype/pages/` | 独立业务页面 | 多页面系统的每个主要页面单独存放；页面结构必须引用或遵循 `layout/` 中的复用布局。 |
+| `prototype/layout/` | 可复用页面结构 | 沉淀应用外壳、导航、页头、侧栏、内容网格、表单页骨架、状态页骨架等结构，保证后续开发能稳定复现。 |
+| `prototype/components/` | 可复用界面组件和交互片段 | 存放按钮组、表单控件、卡片、列表、弹窗、状态块等组件示例，并标注使用场景和状态。 |
+| `prototype/assets/` | 公共资源 | 存放样式、脚本、图片、图标、示例数据等资源；页面不得依赖散落在目录外的资源。 |
+
+页面原型应优先复用布局结构，避免只在单个页面里临时拼装。
+
+## 检查表
+
+- P0 功能是否都有可点击路径。
+- 页面访问逻辑是否来自真实使用流程。
+- 页面数量和模块数量是否服务高频路径，而不是堆叠低频功能。
+- 能合并的入口、状态、表单、列表、详情是否已经合并并记录理由。
+- 设计方向是否都有可打开的首页 demo，而不是只有文字说明。
+- 是否有 Playwright 截图证据并覆盖 desktop/tablet/mobile。
+- 是否完成 Impeccable 审查、修正和复查记录。
+- 是否沉淀了可复用布局，并能支撑后续开发稳定复现。
+- 成功、失败、空、加载状态是否覆盖。
+- 页面是否符合真实工作流和高频使用习惯。
+- 原型路径是否能映射回需求功能编号。

package/.claude/skills/ui-prototype-design/templates/handoff-ui.md

@@ -0,0 +1,40 @@
+# 界面与体验交接摘要
+
+## 选定设计方向
+
+- 主题：
+- 视觉原则：
+- 交互原则：
+
+## 原型入口
+
+- 主入口：`prototype/index.html`
+- 多页面目录：`prototype/pages/`
+- 复用布局：`prototype/layout/`
+- 公共资源：`prototype/assets/`
+- 高频页面路径：
+- 页面/模块整合原则：
+- 原型自审：`docs/prototype-review.md`
+- 截图证据：`prototype/review/screenshots/`
+
+## 复用布局说明
+
+| 布局 | 路径 | 适用页面 | 开发复现要点 |
+|---|---|---|---|
+| 待补充 | prototype/layout/待补充.html | 待补充 | 待补充 |
+
+## 页面与功能覆盖
+
+| 功能编号 | 高频流程位置 | 原型页面 | 关键控件 | 需要开发实现的状态 |
+|---|---|---|---|---|
+| M1-F1 | 待补充 | prototype/index.html | 待补充 | 成功/失败/空/加载 |
+
+## 开发注意事项
+
+- 待补充
+
+## 自审遗留问题
+
+| 问题 | 影响 | 是否阻塞开发 |
+|---|---|---|
+| 待补充 | 待补充 | 待补充 |

package/.claude/skills/ui-prototype-design/templates/prototype-review.md

@@ -0,0 +1,57 @@
+# {{PRODUCT_NAME}} 高保真原型自审报告
+
+## 审查结论
+
+- 结论：待补充
+- 自审轮次：待补充
+- 是否允许进入开发规划：待补充
+- 主要风险：待补充
+
+## 审查范围
+
+| 类型 | 页面 | 路径 | 覆盖功能编号 | 状态 |
+|---|---|---|---|---|
+| 方向预览 | 方案 A | prototype/directions/option-a.html | 待补充 | 待补充 |
+| 方向预览 | 方案 B | prototype/directions/option-b.html | 待补充 | 待补充 |
+| 方向预览 | 方案 C | prototype/directions/option-c.html | 待补充 | 待补充 |
+| 完整原型 | 首页/入口 | prototype/index.html | 待补充 | 待补充 |
+
+## Playwright 截图证据
+
+| 页面 | 桌面 1440x900 | 平板 834x1112 | 移动 390x844 | 控制台错误 |
+|---|---|---|---|---|
+| prototype/directions/index.html | 待补充 | 待补充 | 待补充 | 待补充 |
+| prototype/index.html | 待补充 | 待补充 | 待补充 | 待补充 |
+
+截图目录：`prototype/review/screenshots/`
+
+## Impeccable 审查记录
+
+| 功能 | 使用目标 | 发现问题 | 处理结果 |
+|---|---|---|---|
+| critique | 审美、视觉层级、信息架构、AI 味、认知负荷 | 待补充 | 待补充 |
+| audit | 可访问性、性能、响应式、语义结构、反模式 | 待补充 | 待补充 |
+| adapt | 桌面、平板、移动适配 | 待补充 | 待补充 |
+| layout | 间距、对齐、节奏、布局稳定性 | 待补充 | 待补充 |
+| typeset | 字体层级、行高、可读性 | 待补充 | 待补充 |
+| clarify | 按钮、空状态、错误提示、说明文字 | 待补充 | 待补充 |
+| animate | 动效、状态过渡、交互反馈 | 待补充 | 待补充 |
+| harden | 长文本、空数据、错误、加载、异常路径 | 待补充 | 待补充 |
+| polish | 最终综合打磨 | 待补充 | 待补充 |
+
+## 已修正问题
+
+| 问题 | 来源 | 修正位置 | 复查结果 |
+|---|---|---|---|
+| 待补充 | 待补充 | 待补充 | 待补充 |
+
+## 遗留问题
+
+| 问题 | 影响 | 是否阻塞 | 建议 |
+|---|---|---|---|
+| 待补充 | 待补充 | 待补充 | 待补充 |
+
+## 复查记录
+
+- 第 1 轮：
+- 第 2 轮：

package/.claude/skills/ui-prototype-design/templates/ui-design.md

@@ -0,0 +1,142 @@
+# {{PRODUCT_NAME}} 界面与体验设计文档
+
+## 上游前置审查
+
+- 需求文档是否清晰：
+- 技术架构是否清晰：
+- 高频真实需求是否清晰：
+- 真实使用流程是否清晰：
+- 待确认问题：
+
+## 上游同步记录
+
+- 本阶段是否改变页面清单、交互路径、字段、状态、技术约束或验收标准：
+- 已同步回写的上游文档：
+- `workflow-state.json` notes 记录：
+
+## UI 硬规则
+
+- 页面可见文案、按钮、导航、空状态和提示语禁止使用 emoji。
+- 图标必须使用图标库、SVG 或图片资源，不用 emoji 代替。
+- 正文、表单、按钮、列表文本默认不小于 16px。
+- 辅助说明可小于 16px，但不得低于 14px；移动端优先保持 16px 起。
+
+## 设计方向候选
+
+| 方向 | 主题资产 | 视觉气质 | 适合理由 | 预览路径 |
+|---|---|---|---|---|
+| 方案 A | 待补充 | 待补充 | 待补充 | 待补充 |
+| 方案 B | 待补充 | 待补充 | 待补充 | 待补充 |
+| 方案 C | 待补充 | 待补充 | 待补充 | 待补充 |
+
+## 首页 Demo 预览
+
+| 方向 | Demo 路径 | 展示重点 | 是否可打开 |
+|---|---|---|---|
+| 方案 A | prototype/directions/option-a.html | 首屏、核心入口、关键状态、视觉气质 | 待确认 |
+| 方案 B | prototype/directions/option-b.html | 首屏、核心入口、关键状态、视觉气质 | 待确认 |
+| 方案 C | prototype/directions/option-c.html | 首屏、核心入口、关键状态、视觉气质 | 待确认 |
+
+预览索引：`prototype/directions/index.html`
+
+## 已选方向
+
+- 选择：
+- 选择原因：
+- 不采用方向：
+
+## 页面清单
+
+| 页面 | 原型路径 | 入口来源 | 覆盖功能编号 | 对应高频流程步骤 | 页面目标 |
+|---|---|---|---|---|---|
+| 首页/入口 | prototype/index.html | 直接打开 | M1-F1 | 待补充 | 待补充 |
+
+## 页面访问逻辑
+
+| 高频流程步骤 | 用户动作 | 页面/模块 | 入口 | 下一步 | 减少跳转/理解成本的设计 |
+|---|---|---|---|---|---|
+| 待补充 | 待补充 | 待补充 | 待补充 | 待补充 | 待补充 |
+
+## 核心页面布局
+
+### prototype/index.html
+
+- 页面目标：
+- 区块结构：
+- 复用布局：
+- 核心元素：
+- 交互逻辑：
+- 状态设计：
+
+## 复用布局清单
+
+| 布局 | 路径 | 适用页面 | 结构职责 | 可复用规则 |
+|---|---|---|---|---|
+| 待补充 | prototype/layout/待补充.html | 待补充 | 待补充 | 待补充 |
+
+## 模块整合与减负记录
+
+| 原候选页面/模块 | 整合后位置 | 整合原因 | 对用户成本的影响 |
+|---|---|---|---|
+| 待补充 | 待补充 | 避免页面堆叠、重复入口或低频能力前置 | 待补充 |
+
+## 需求到界面映射
+
+| 功能编号 | 页面/路径 | 控件/组件 | 用户动作 | 高频流程位置 | 状态覆盖 | 原型路径 |
+|---|---|---|---|---|---|---|
+| M1-F1 | 待补充 | 待补充 | 待补充 | 待补充 | 成功/失败/空/加载 | prototype/index.html |
+
+## 组件清单
+
+| 组件 | 使用位置 | 状态 | 行为 |
+|---|---|---|---|
+| 待补充 | 待补充 | 默认/悬停/禁用/加载/错误 | 待补充 |
+
+## 用户流程
+
+```mermaid
+flowchart TD
+  A[开始] --> B[待补充]
+```
+
+## 原型结构
+
+```text
+prototype/
+  directions/
+  index.html
+  pages/
+  layout/
+  components/
+  assets/
+```
+
+| 路径 | 职责 | 产物要求 |
+|---|---|---|
+| `prototype/directions/` | 设计方向首页 demo | 每个候选方向必须有一个可打开的首页 demo；`index.html` 汇总 2-3 个预览入口，供用户选择方向。 |
+| `prototype/index.html` | 原型入口、全局导航、关键流程起点 | 必须能进入所有 P0 原型路径；多页面系统必须链接到 `pages/` 中的具体页面。 |
+| `prototype/pages/` | 独立业务页面 | 多页面系统的每个主要页面单独存放；页面结构必须引用或遵循 `layout/` 中的复用布局。 |
+| `prototype/layout/` | 可复用页面结构 | 沉淀应用外壳、导航、页头、侧栏、内容网格、表单页骨架、状态页骨架等结构，保证后续开发能稳定复现。 |
+| `prototype/components/` | 可复用界面组件和交互片段 | 存放按钮组、表单控件、卡片、列表、弹窗、状态块等组件示例，并标注使用场景和状态。 |
+| `prototype/assets/` | 公共资源 | 存放样式、脚本、图片、图标、示例数据等资源；页面不得依赖散落在目录外的资源。 |
+
+页面原型必须优先复用 `prototype/layout/` 的结构，不要只在单个页面里临时拼装。
+
+## 质量检查记录
+
+- 已修正：
+- 未采纳：
+
+## 原型自审
+
+- 自审报告：`docs/prototype-review.md`
+- 截图目录：`prototype/review/screenshots/`
+- Impeccable 上下文：Codex 使用 `.agents/context/PRODUCT.md`, `.agents/context/DESIGN.md`；Claude Code 使用 `.claude/context/PRODUCT.md`, `.claude/context/DESIGN.md` 或沿用 `.agents/context/`
+
+| 审查项 | 要求 | 状态 |
+|---|---|---|
+| Playwright 截图 | 候选 demo 和完整原型页面覆盖 desktop/tablet/mobile | 待确认 |
+| Impeccable critique | 审美、视觉层级、信息架构、AI 味、认知负荷 | 待确认 |
+| Impeccable audit | 可访问性、性能、响应式、语义结构、反模式 | 待确认 |
+| Impeccable adapt | 桌面、平板、移动适配 | 待确认 |
+| Impeccable polish | 最终综合打磨 | 待确认 |