@pzy560117/codex-harness 0.1.0 → 0.1.1

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/references/feature-list-template.md

@@ -0,0 +1,67 @@
+# Feature List 模板
+
+## 模块1：[模块名称]
+
+| 功能编号 | 功能名称 | 功能描述 | 优先级 | 备注 |
+|---------|---------|---------|--------|------|
+| [M1-01] | [功能名] | [WHO + DO WHAT + FOR WHAT] | P0/P1/P2 | [备注] |
+
+---
+
+## 优先级定义
+
+| 优先级 | 含义 | 标识 |
+|-------|------|------|
+| P0 | MVP必须，核心功能 | 🔴 |
+| P1 | 重要增强，首版应有 | 🟡 |
+| P2 | 体验优化，可延后 | 🟢 |
+
+## 常见模块分类
+
+### 用户端模块
+- 账号体系（注册、登录、找回密码）
+- 首页/发现
+- 搜索
+- 详情页
+- 购物车/收藏
+- 订单流程
+- 支付结算
+- 个人中心
+- 消息通知
+
+### 管理端模块
+- 用户管理
+- 内容管理
+- 订单管理
+- 数据统计
+- 系统设置
+- 权限管理
+
+## 完整性检查清单
+
+检查是否遗漏以下常见功能：
+
+### 账号相关
+- [ ] 注册 → 是否有注册协议确认？
+- [ ] 登录 → 是否有找回密码？
+- [ ] 第三方登录 → 是否有账号绑定/解绑？
+
+### 列表相关
+- [ ] 列表展示 → 是否有筛选/排序？
+- [ ] 列表展示 → 是否有分页/加载更多？
+- [ ] 列表展示 → 是否有空状态？
+
+### 操作相关
+- [ ] 新增 → 是否有编辑/删除？
+- [ ] 提交 → 是否有取消/撤销？
+- [ ] 删除 → 是否有软删除/恢复？
+
+### 流程相关
+- [ ] 下单 → 是否有取消订单？
+- [ ] 支付 → 是否有退款？
+- [ ] 发货 → 是否有退货？
+
+### 数据相关
+- [ ] 是否有数据导出？
+- [ ] 是否有操作日志？
+- [ ] 是否有数据备份？

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/references/prd-template.md

@@ -0,0 +1,150 @@
+# [项目名称] 产品需求文档 (PRD)
+
+## 1. 文档信息
+
+| 字段 | 内容 |
+|-----|------|
+| 产品名称 | [产品名称] |
+| 文档版本 | V1.0 |
+| 编写日期 | [YYYY-MM-DD] |
+| 编写人 | [编写人] |
+| 最后更新 | [YYYY-MM-DD] |
+
+## 2. 项目背景
+
+### 2.1 业务目标
+
+[描述产品要解决的业务问题和预期目标]
+
+### 2.2 目标用户
+
+| 用户类型 | 用户画像 | 核心诉求 |
+|---------|---------|---------|
+| [用户类型1] | [年龄/职业/特征] | [核心需求] |
+| [用户类型2] | [年龄/职业/特征] | [核心需求] |
+
+### 2.3 核心价值主张
+
+[总结该产品解决的核心问题，用一句话概括产品价值]
+
+## 3. 产品架构
+
+### 3.1 功能架构图
+
+```mermaid
+mindmap
+  root((产品名称))
+    用户端
+      模块1
+        功能1.1
+        功能1.2
+      模块2
+        功能2.1
+    管理端
+      模块A
+        功能A.1
+      模块B
+        功能B.1
+```
+
+### 3.2 用户角色定义
+
+| 角色名称 | 角色描述 | 主要权限 |
+|---------|---------|---------|
+| 普通用户 | [描述] | [权限列表] |
+| 管理员 | [描述] | [权限列表] |
+
+## 4. 核心业务流程
+
+```mermaid
+flowchart TD
+    A[开始] --> B{条件判断}
+    B -->|是| C[执行步骤1]
+    B -->|否| D[执行步骤2]
+    C --> E[结束]
+    D --> E
+```
+
+## 5. 详细功能说明
+
+### 5.1 模块名称
+
+#### 5.1.1 功能名称
+
+| 字段 | 说明 |
+|-----|------|
+| **功能编号** | [F-01] |
+| **功能描述** | [用户可以做什么，达成什么目的] |
+| **前置条件** | [使用该功能前需满足的条件] |
+| **优先级** | P0/P1/P2 |
+
+**页面元素**：
+
+| 元素 | 类型 | 说明 | 校验规则 |
+|-----|------|-----|---------|
+| [元素名] | 输入框/按钮/下拉 | [说明] | [校验规则] |
+
+**交互逻辑**：
+
+1. 用户点击[xxx]
+2. 系统显示[xxx]
+3. 用户输入[xxx]
+4. 系统执行[xxx]
+
+**异常处理**：
+
+| 异常场景 | 处理方式 |
+|---------|---------|
+| [场景1] | [提示/跳转/重试] |
+| [场景2] | [提示/跳转/重试] |
+
+---
+
+## 6. 非功能需求
+
+### 6.1 性能要求
+
+| 指标 | 要求 |
+|-----|------|
+| 接口响应时间 | ≤ 200ms |
+| 页面加载时间 | ≤ 3s |
+| 并发用户数 | ≥ 1000 |
+
+### 6.2 安全要求
+
+- [ ] 敏感数据加密存储
+- [ ] 接口权限校验
+- [ ] 防SQL注入/XSS攻击
+- [ ] 操作日志记录
+
+### 6.3 兼容性要求
+
+| 维度 | 支持范围 |
+|-----|---------|
+| 浏览器 | Chrome 80+, Safari 13+, Edge 80+ |
+| 设备 | PC, Tablet, Mobile |
+| 分辨率 | 1920×1080, 1366×768, 375×667 |
+
+## 7. 迭代规划
+
+| 版本 | 包含功能 | 预计上线时间 |
+|-----|---------|-------------|
+| MVP | [核心功能列表] | [YYYY-MM-DD] |
+| V1.1 | [增强功能列表] | [YYYY-MM-DD] |
+| V2.0 | [完整功能列表] | [YYYY-MM-DD] |
+
+## 8. 附录
+
+### 8.1 术语表
+
+| 术语 | 解释 |
+|-----|------|
+| [术语1] | [解释] |
+
+### 8.2 参考文档
+
+- [相关文档链接]
+
+---
+
+*文档结束*

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/references/prompts.md

@@ -0,0 +1,88 @@
+# 需求采集 Prompt 模板
+
+## Prompt 1：从会议记录提取需求
+
+```
+角色设定：
+你是一位拥有 10 年经验的资深产品经理，擅长从混乱的会议讨论中提炼出清晰的业务需求。
+
+任务背景：
+我刚刚参加了一场产品需求讨论会议，会议录音已转为文字。现在需要你帮我从中提取出可落地的功能需求清单。
+
+输入材料：
+- 会议转写文稿（见上文）
+- 项目背景补充：[在此粘贴：目标用户、业务场景、技术栈限制等]
+
+输出要求：
+1. **内容清洗**：去除所有寒暄、跑题、重复内容，只保留与产品功能相关的需求描述
+2. **结构分类**：按以下维度组织需求
+   - 【核心业务流程】：端到端的主流程（如：用户注册→登录→下单→支付）
+   - 【用户端功能】：C端用户可见的功能模块
+   - 【管理端功能】：B端/运营后台功能
+   - 【技术需求】：性能、安全、兼容性等非功能性需求
+3. **优先级标注**：用 🔴 P0（必须有）/ 🟡 P1（重要）/ 🟢 P2（优化项）标记
+4. **痛点标记**：用 ⚠️ 标注客户反复强调或情绪激动时提到的需求
+5. **格式规范**：使用 Markdown 无序列表，每个功能一行
+
+示例输出格式：
+## 核心业务流程
+- 🔴 P0 用户注册流程：支持手机号+验证码注册，需校验手机号真实性
+- 🔴 P0 ⚠️ 快速下单：客户强调必须 3 步内完成下单，不能有繁琐表单
+```
+
+---
+
+## Prompt 2：结构化梳理 Feature List
+
+```
+角色设定：
+你是一位拥有 B端/C端双重经验的产品架构师，擅长将零散需求整理为完整的功能地图。
+
+任务：
+我正在规划一个 [项目类型：如 SaaS CRM 系统 / 电商小程序 / 在线教育平台]，以下是初步需求清单：
+[粘贴需求清单]
+
+输出要求：
+1. **模块化划分**：按业务模块组织（示例：账号体系、首页、商品管理、订单流程、支付结算、个人中心、运营后台）
+2. **功能三要素**：每个功能点必须包含
+   - 功能名称：简洁明确，动宾结构（如：创建订单、导出报表）
+   - 功能描述：用一句话说清楚"用户可以做什么"（WHO + DO WHAT + FOR WHAT）
+   - 优先级：P0（MVP 必须）/ P1（重要增强）/ P2（体验优化）
+3. **逻辑完整性检查**：主动指出需求中可能缺失的环节，例如：
+   - 有"加入购物车"但没提"购物车编辑/删除"
+   - 有"用户注册"但没提"找回密码"
+   - 有"生成订单"但没提"订单取消/退款"流程
+4. **表格化输出**：使用 Markdown 表格格式
+
+输出格式示例：
+## 模块 1：用户账号体系
+| 功能编号 | 功能名称 | 功能描述 | 优先级 | 备注 |
+|---------|---------|---------|--------|------|
+| U-01 | 手机号注册 | 用户通过手机号+验证码完成账号注册 | P0 | 需防刷机制 |
+```
+
+---
+
+## Prompt 3：反向推演（四角色审查）
+
+```
+角色切换指令：
+现在请切换为以下四个角色，分别对上述 Feature List 进行"挑刺"：
+
+1. **技术负责人**：从技术实现难度、系统性能、安全风险角度提出 3 个尖锐问题
+   示例："如果用户在支付过程中网络断开，订单状态如何处理？是否有幂等性设计？"
+
+2. **挑剔的用户**：从操作便捷性、流程合理性角度提出 3 个质疑
+   示例："为什么修改收货地址要跳转三个页面？能不能在订单确认页直接编辑？"
+
+3. **运营负责人**：从数据分析、营销推广角度提出 2 个需求补充
+   示例："是否有用户行为埋点？如何追踪营销活动的转化效果？"
+
+4. **测试工程师**：从异常场景覆盖角度提出 2 个边界问题
+   示例："如果用户重复点击提交按钮会怎样？是否有防重复提交机制？"
+
+输出格式：
+- 每个角色的问题单独列出
+- 每个问题后面给出建议解决方案
+- 标注哪些问题需要补充到 Feature List 中
+```

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/references/prototype-guide.md

@@ -0,0 +1,156 @@
+# 原型生成指南
+
+## 技术规格
+
+生成单文件 HTML 原型，可直接在浏览器打开：
+
+```html
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>[产品名称] - 原型</title>
+    <!-- Tailwind CSS -->
+    <script src="https://cdn.tailwindcss.com"></script>
+    <style>
+        /* 自定义样式 */
+    </style>
+</head>
+<body>
+    <!-- 页面内容 -->
+    <script>
+        // 交互逻辑
+    </script>
+</body>
+</html>
+```
+
+## 设计风格选项
+
+### 1. Glassmorphism（毛玻璃）
+- 半透明背景 + 模糊效果
+- `backdrop-blur-lg bg-white/30`
+
+### 2. Minimalism（极简）
+- 大量留白 + 清晰层次
+- 黑白灰为主 + 单色点缀
+
+### 3. Material Design
+- 卡片阴影 + 圆角
+- `shadow-md rounded-lg`
+
+### 4. Dark Mode（深色模式）
+- 深色背景 + 亮色文字
+- `bg-gray-900 text-white`
+
+## 必备交互组件
+
+### 1. 导航栏
+```html
+<nav class="fixed top-0 w-full bg-white shadow-sm z-50">
+    <div class="max-w-7xl mx-auto px-4 h-16 flex items-center justify-between">
+        <div class="font-bold text-xl">Logo</div>
+        <div class="flex gap-4">
+            <a href="#" class="hover:text-blue-600">首页</a>
+            <a href="#" class="hover:text-blue-600">功能</a>
+        </div>
+    </div>
+</nav>
+```
+
+### 2. 表单校验
+```javascript
+function validateForm() {
+    const input = document.getElementById('phone');
+    const error = document.getElementById('error');
+    if (!/^1[3-9]\d{9}$/.test(input.value)) {
+        error.textContent = '请输入正确的手机号';
+        error.classList.remove('hidden');
+        return false;
+    }
+    error.classList.add('hidden');
+    return true;
+}
+```
+
+### 3. Loading 状态
+```javascript
+function submitWithLoading(btn) {
+    const originalText = btn.textContent;
+    btn.disabled = true;
+    btn.innerHTML = '<svg class="animate-spin h-5 w-5 mr-2 inline" viewBox="0 0 24 24"><circle cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" fill="none" opacity="0.25"></circle><path fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"></path></svg>提交中...';
+    
+    setTimeout(() => {
+        btn.disabled = false;
+        btn.textContent = originalText;
+    }, 2000);
+}
+```
+
+### 4. Toast 提示
+```javascript
+function showToast(message, type = 'success') {
+    const toast = document.createElement('div');
+    toast.className = `fixed top-4 right-4 px-6 py-3 rounded-lg text-white ${type === 'success' ? 'bg-green-500' : 'bg-red-500'} transition-opacity duration-300`;
+    toast.textContent = message;
+    document.body.appendChild(toast);
+    setTimeout(() => {
+        toast.style.opacity = '0';
+        setTimeout(() => toast.remove(), 300);
+    }, 3000);
+}
+```
+
+### 5. 模态框/抽屉
+```html
+<!-- 模态框 -->
+<div id="modal" class="fixed inset-0 bg-black/50 hidden items-center justify-center z-50">
+    <div class="bg-white rounded-lg p-6 w-96">
+        <h3 class="text-lg font-bold mb-4">标题</h3>
+        <p>内容</p>
+        <button onclick="closeModal()" class="mt-4 px-4 py-2 bg-blue-600 text-white rounded">关闭</button>
+    </div>
+</div>
+```
+
+### 6. Tab 页面切换
+```javascript
+function switchTab(tabId) {
+    document.querySelectorAll('.tab-content').forEach(el => el.classList.add('hidden'));
+    document.querySelectorAll('.tab-btn').forEach(el => el.classList.remove('border-blue-600', 'text-blue-600'));
+    document.getElementById(tabId).classList.remove('hidden');
+    event.target.classList.add('border-blue-600', 'text-blue-600');
+}
+```
+
+## 响应式适配
+
+```html
+<!-- 移动端汉堡菜单 -->
+<button class="md:hidden" onclick="toggleMenu()">
+    <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"/>
+    </svg>
+</button>
+
+<!-- 响应式网格 -->
+<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+    <!-- 卡片 -->
+</div>
+```
+
+## 模拟数据
+
+```javascript
+const mockData = {
+    users: [
+        { id: 1, name: '张三', phone: '13800138001', status: '正常' },
+        { id: 2, name: '李四', phone: '13800138002', status: '禁用' },
+    ],
+    orders: [
+        { id: 'ORD001', amount: 299, status: '待支付', time: '2024-01-15 10:30' },
+        { id: 'ORD002', amount: 599, status: '已完成', time: '2024-01-14 15:20' },
+    ]
+};
+```

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/references/quality-checklist.md

@@ -0,0 +1,120 @@
+# PRD 质量检查清单
+
+完成PRD后，以四个角色视角进行检查：
+
+## 1. 技术负责人视角 🔧
+
+从技术实现难度、系统性能、安全风险角度审视：
+
+### 检查问题
+- [ ] 并发处理：高峰期如何保证系统稳定？
+- [ ] 幂等性：重复提交如何处理？
+- [ ] 异常恢复：网络断开、支付中断如何处理？
+- [ ] 数据一致性：分布式场景下如何保证？
+- [ ] 安全防护：SQL注入、XSS、CSRF如何防范？
+- [ ] 性能瓶颈：大数据量查询如何优化？
+
+### 示例问题
+> "如果用户在支付过程中网络断开，订单状态如何处理？是否有幂等性设计？"
+
+---
+
+## 2. 挑剔用户视角 👤
+
+从操作便捷性、流程合理性角度审视：
+
+### 检查问题
+- [ ] 操作步骤是否过多？能否减少点击次数？
+- [ ] 表单字段是否过多？能否智能填充？
+- [ ] 错误提示是否友好？用户能否理解？
+- [ ] 加载状态是否清晰？用户是否知道在等待？
+- [ ] 撤销/回退是否方便？
+
+### 示例问题
+> "为什么修改收货地址要跳转三个页面？能不能在订单确认页直接编辑？"
+
+---
+
+## 3. 运营负责人视角 📊
+
+从数据分析、营销推广角度审视：
+
+### 检查问题
+- [ ] 埋点设计：关键行为是否有埋点？
+- [ ] 转化追踪：营销活动效果如何评估？
+- [ ] 用户分层：如何区分不同价值用户？
+- [ ] 运营工具：是否有足够的后台配置能力？
+- [ ] 数据导出：运营报表如何生成？
+
+### 示例问题
+> "是否有用户行为埋点？如何追踪营销活动的转化效果？"
+
+---
+
+## 4. 测试工程师视角 🧪
+
+从异常场景覆盖角度审视：
+
+### 检查问题
+- [ ] 边界值：最大/最小/空值如何处理？
+- [ ] 并发操作：多人同时操作同一数据？
+- [ ] 网络异常：弱网、断网、超时？
+- [ ] 设备兼容：不同屏幕、浏览器、系统？
+- [ ] 权限边界：越权操作是否被拦截？
+
+### 示例问题
+> "如果用户重复点击提交按钮会怎样？是否有防重复提交机制？"
+
+---
+
+---
+
+## 5. 原型 UI 质量检查 🎨
+
+交付原型前验证：
+
+### 视觉质量
+- [ ] 不使用 emoji 作为图标（使用 SVG）
+- [ ] 所有图标来自统一图标库（Heroicons/Lucide）
+- [ ] Hover 状态不会导致布局偏移
+- [ ] 使用语义化主题色（`bg-primary`）
+
+### 交互
+- [ ] 所有可点击元素有 `cursor-pointer`
+- [ ] Hover 状态提供清晰视觉反馈
+- [ ] 过渡动画平滑（150-300ms）
+- [ ] 键盘导航时焦点状态可见
+
+### 亮/暗模式
+- [ ] 亮色模式文字有足够对比度（4.5:1 最低）
+- [ ] 玻璃/透明元素在亮色模式下可见
+- [ ] 边框在两种模式下都可见
+
+### 无障碍
+- [ ] 所有图片有 alt 文本
+- [ ] 表单输入有 label
+- [ ] 颜色不是唯一的指示器
+- [ ] 尊重 `prefers-reduced-motion`
+
+---
+
+## 检查输出格式
+
+```markdown
+## 质量检查报告
+
+### 技术风险
+1. [问题描述] → 建议：[解决方案]
+
+### 用户体验
+1. [问题描述] → 建议：[解决方案]
+
+### 运营需求
+1. [补充需求] → 建议：[实现方案]
+
+### 测试要点
+1. [测试场景] → 预期：[预期结果]
+
+### UI 问题
+1. [问题描述] → 修复：[修复方案]
+```