@openprd/cli 0.1.0

package/docs/assets/openprd-scenario-overview.svg

@@ -0,0 +1,114 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="920" viewBox="0 0 1600 920" role="img" aria-labelledby="title desc">
+  <title id="title">OpenPrd scenario overview</title>
+  <desc id="desc">A visual map of OpenPrd usage scenarios from unclear ideas to verified handoff.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#f8fafc"/>
+      <stop offset="0.45" stop-color="#eef6ff"/>
+      <stop offset="1" stop-color="#f7f0ff"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#0f172a" flood-opacity="0.12"/>
+    </filter>
+    <marker id="arrow" viewBox="0 0 12 12" refX="11" refY="6" markerWidth="10" markerHeight="10" orient="auto">
+      <path d="M2 2 L10 6 L2 10 Z" fill="#475569"/>
+    </marker>
+    <style>
+      .small { font: 500 22px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #475569; }
+      .eyebrow { font: 700 20px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; letter-spacing: 2px; fill: #2563eb; }
+      .title { font: 800 58px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #0f172a; }
+      .subtitle { font: 500 26px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #334155; }
+      .card-title { font: 800 28px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
+      .card-body { font: 500 21px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #475569; }
+      .dark-title { font: 800 28px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #ffffff; }
+      .dark-body { font: 500 21px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #cbd5e1; }
+      .pill { font: 700 18px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #ffffff; }
+      .mono { font: 700 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; fill: #334155; }
+      .line { fill: none; stroke: #64748b; stroke-width: 4; marker-end: url(#arrow); }
+      .dash { fill: none; stroke: #94a3b8; stroke-width: 3; stroke-dasharray: 10 10; }
+    </style>
+  </defs>
+
+  <rect width="1600" height="920" rx="0" fill="url(#bg)"/>
+  <path d="M0 118 H1600 M0 274 H1600 M0 430 H1600 M0 586 H1600 M0 742 H1600 M190 0 V920 M390 0 V920 M590 0 V920 M790 0 V920 M990 0 V920 M1190 0 V920 M1390 0 V920" stroke="#dbeafe" stroke-width="1" opacity="0.7"/>
+
+  <g transform="translate(92 72)">
+    <text class="eyebrow" x="0" y="0">OPENPRD WORKSPACE</text>
+    <text class="title" x="0" y="78">From fuzzy intent to verified handoff</text>
+    <text class="subtitle" x="2" y="125">Use one local PRD workspace to clarify, review, execute, compare visuals, and keep quality evidence visible.</text>
+  </g>
+
+  <g transform="translate(96 210)" filter="url(#shadow)">
+    <rect width="392" height="220" rx="18" fill="#ffffff" stroke="#bfdbfe" stroke-width="2"/>
+    <rect x="28" y="28" width="84" height="34" rx="17" fill="#2563eb"/>
+    <text class="pill" x="49" y="51">01</text>
+    <text class="card-title" x="28" y="104">Clarify new ideas</text>
+    <text class="card-body" x="28" y="145">Turn rough product prompts</text>
+    <text class="card-body" x="28" y="177">into captured facts, open</text>
+    <text class="card-body" x="28" y="209">questions, and review scope.</text>
+  </g>
+
+  <g transform="translate(604 210)" filter="url(#shadow)">
+    <rect width="392" height="220" rx="18" fill="#ffffff" stroke="#bbf7d0" stroke-width="2"/>
+    <rect x="28" y="28" width="84" height="34" rx="17" fill="#16a34a"/>
+    <text class="pill" x="49" y="51">02</text>
+    <text class="card-title" x="28" y="104">Mine existing projects</text>
+    <text class="card-body" x="28" y="145">Use discovery to track</text>
+    <text class="card-body" x="28" y="177">coverage, evidence, tasks,</text>
+    <text class="card-body" x="28" y="209">and standards drift.</text>
+  </g>
+
+  <g transform="translate(1112 210)" filter="url(#shadow)">
+    <rect width="392" height="220" rx="18" fill="#ffffff" stroke="#fed7aa" stroke-width="2"/>
+    <rect x="28" y="28" width="84" height="34" rx="17" fill="#f97316"/>
+    <text class="pill" x="49" y="51">03</text>
+    <text class="card-title" x="28" y="104">Confirm with visuals</text>
+    <text class="card-body" x="28" y="145">Generate architecture and</text>
+    <text class="card-body" x="28" y="177">product-flow reviews before</text>
+    <text class="card-body" x="28" y="209">teams commit to execution.</text>
+  </g>
+
+  <path class="line" d="M488 320 H592"/>
+  <path class="line" d="M996 320 H1100"/>
+
+  <g transform="translate(180 542)" filter="url(#shadow)">
+    <rect width="520" height="230" rx="18" fill="#0f172a" stroke="#334155" stroke-width="2"/>
+    <rect x="30" y="30" width="128" height="36" rx="18" fill="#a855f7"/>
+    <text class="pill" x="54" y="54">Agent Loop</text>
+    <text class="dark-title" x="30" y="113">Execute one task per session</text>
+    <text class="dark-body" x="30" y="154">Convert confirmed changes into</text>
+    <text class="dark-body" x="30" y="186">dependency-ready prompts, logs,</text>
+    <text class="dark-body" x="30" y="218">verification, and optional commits.</text>
+  </g>
+
+  <g transform="translate(900 542)" filter="url(#shadow)">
+    <rect width="520" height="230" rx="18" fill="#ffffff" stroke="#fecdd3" stroke-width="2"/>
+    <rect x="30" y="30" width="150" height="36" rx="18" fill="#e11d48"/>
+    <text class="pill" x="54" y="54">Quality + UI</text>
+    <text class="card-title" x="30" y="113">Verify before handoff</text>
+    <text class="card-body" x="30" y="154">Keep regression reports, cost</text>
+    <text class="card-body" x="30" y="186">guardrails, smoke evidence, and</text>
+    <text class="card-body" x="30" y="218">visual compare artifacts together.</text>
+  </g>
+
+  <path class="line" d="M800 430 V500 C800 530 760 558 712 630"/>
+  <path class="line" d="M1008 430 V500 C1008 530 942 558 900 630"/>
+  <path class="dash" d="M700 660 H900"/>
+
+  <g transform="translate(96 822)">
+    <rect width="1408" height="54" rx="27" fill="#ffffff" stroke="#dbeafe" stroke-width="2"/>
+    <text class="mono" x="40" y="35">openprd clarify</text>
+    <text class="small" x="225" y="35">-></text>
+    <text class="mono" x="266" y="35">capture</text>
+    <text class="small" x="372" y="35">-></text>
+    <text class="mono" x="414" y="35">synthesize</text>
+    <text class="small" x="566" y="35">-></text>
+    <text class="mono" x="608" y="35">diagram</text>
+    <text class="small" x="724" y="35">-></text>
+    <text class="mono" x="766" y="35">change/tasks</text>
+    <text class="small" x="942" y="35">-></text>
+    <text class="mono" x="984" y="35">loop</text>
+    <text class="small" x="1052" y="35">-></text>
+    <text class="mono" x="1094" y="35">quality + handoff</text>
+  </g>
+</svg>

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@openprd/cli",
+  "version": "0.1.0",
+  "description": "AI-native PRD workspace and lifecycle CLI",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "openprd": "bin/openprd.js"
+  },
+  "files": [
+    "AGENTS.md",
+    "CONTRIBUTING.md",
+    "README_CN.md",
+    "SECURITY.md",
+    "bin",
+    "docs/assets",
+    "scripts",
+    "src",
+    ".openprd",
+    "!.openprd/artifacts",
+    "!.openprd/artifacts/**",
+    "!.openprd/harness",
+    "!.openprd/harness/**",
+    "!.openprd/learning",
+    "!.openprd/learning/**",
+    "!.openprd/quality/evidence",
+    "!.openprd/quality/evidence/**",
+    "!.openprd/quality/reports",
+    "!.openprd/quality/reports/**",
+    "!.openprd/growth",
+    "!.openprd/growth/**",
+    "!.openprd/growth/preferences.local.json",
+    "!.openprd/knowledge/incidents",
+    "!.openprd/knowledge/incidents/**",
+    "!.openprd/knowledge/patterns",
+    "!.openprd/knowledge/patterns/**",
+    "!.openprd/knowledge/skills",
+    "!.openprd/knowledge/skills/**",
+    "!.openprd/state/events.jsonl",
+    "!.openprd/state/task-graph.json",
+    "!.openprd/engagements/active/decision-log.md",
+    "!.openprd/engagements/active/open-questions.md",
+    "!.openprd/engagements/active/progress.md",
+    "!.openprd/engagements/active/verification.md",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "start": "node ./bin/openprd.js",
+    "test": "node --test",
+    "test:smoke": "node --test --test-name-pattern \"quality requires current smoke evidence|run exposes hook-stable\""
+  },
+  "dependencies": {
+    "sharp": "^0.34.5",
+    "yaml": "^2.8.2"
+  }
+}

package/scripts/openprd-dev-check.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../src/openprd.js';
+
+const exitCode = await main(['dev-check', ...process.argv.slice(2)]);
+process.exitCode = exitCode;

package/scripts/openprd-review-presentation.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { buildReviewPresentationTemplatePayload, reviewPresentationWorkspace } from '../src/review-presentation.js';
+
+function parseArgs(argv) {
+  const flags = {
+    project: '.',
+    version: null,
+    presentation: null,
+    template: false,
+    write: false,
+    failOnViolation: false,
+    help: false,
+  };
+  const positionals = [];
+  const args = [...argv];
+  while (args.length > 0) {
+    const arg = args.shift();
+    if (arg === '--version') {
+      flags.version = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--presentation') {
+      flags.presentation = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--template') {
+      flags.template = true;
+      continue;
+    }
+    if (arg === '--write') {
+      flags.write = true;
+      continue;
+    }
+    if (arg === '--fail-on-violation') {
+      flags.failOnViolation = true;
+      continue;
+    }
+    if (arg === '--help' || arg === '-h') {
+      flags.help = true;
+      continue;
+    }
+    positionals.push(arg);
+  }
+  flags.project = positionals[0] ?? flags.project;
+  return flags;
+}
+
+function printUsage() {
+  console.log([
+    'Usage:',
+    '  node scripts/openprd-review-presentation.mjs [path] [--version v0001] [--presentation review-presentation.json] [--write] [--fail-on-violation]',
+    '  node scripts/openprd-review-presentation.mjs [path] --template',
+  ].join('\n'));
+}
+
+async function main(argv = process.argv.slice(2)) {
+  const flags = parseArgs(argv);
+  if (flags.help) {
+    printUsage();
+    return 0;
+  }
+
+  if (flags.template) {
+    console.log(JSON.stringify(buildReviewPresentationTemplatePayload(), null, 2));
+    return 0;
+  }
+
+  const result = await reviewPresentationWorkspace(flags.project, {
+    version: flags.version,
+    presentationPath: flags.presentation,
+    write: flags.write,
+  });
+  console.log(JSON.stringify(result, null, 2));
+  return flags.failOnViolation && !result.ok ? 1 : 0;
+}
+
+main().then((exitCode) => {
+  process.exitCode = exitCode;
+}).catch((error) => {
+  console.error(error?.message ?? error);
+  process.exitCode = 1;
+});

package/skills/openprd-benchmark-router/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: openprd-benchmark-router
+description: 为 OpenPrd 产品、CLI、Agent harness、AI code review / PR review harness、上下文工程、提示词优化和图标资源选择对标来源与调研路径。适用于最佳实践、benchmark、参考产品、Superpowers、OpenSpec、Anthropic Skills、Lark CLI、长程 Agent、harness、深度审查 lane、context engineering、prompt engineering 和 icon resource 相关请求。
+---
+
+# OpenPrd Benchmark Router
+
+## 概览
+
+这份 skill 负责把“最佳实践 / 对标 / benchmark / 参考产品 / prompt engineering / Agent harness / context engineering / CLI skill 体系优化 / 图标资源”类请求先路由到合适的证据源，再把结论落回 OpenPrd 的生成规则、skills、hooks、CLI 或测试。
+
+它不是长文资料库，也不是外部项目复刻器。它的职责是：先判断该参考谁、怎么查、查到什么程度够用，然后再进入 OpenPrd 的设计和修改。
+
+## 核心原则
+
+- 不把对标当成固定关键词匹配。结合用户目标判断参考源是否真的能提升设计、实现、排查、评审、规划或文档质量。
+- 不强行对标。环境、权限、账号、普通脚本报错、一次性短问答或与产品/领域设计无关的问题，继续当前任务即可。
+- 不默认下载全文、仓库或整站。先保留轻量链接、来源 ID 和适用边界；真正需要事实时再读取。
+- 通常只选 1-3 个最相关来源；不要为了显得全面而扩大上下文。
+- 不把索引、来源目录或记忆当事实来源；未经核验的外部内容不能作为已确认事实输出。
+
+## 触发信号
+
+- 用户提到 OpenPrd、OpenSpec、Superpowers、Anthropic Skills、Lark CLI、Agent harness、AI code review、PR review、review lane、long-running agents、context engineering、prompt engineering、最佳实践、对标、参考、复刻或优化设计。
+- 用户提到图标、icon、图标站、图标库、图标资源、UI 图标、AI 图标、技术图标、3D 图标、功能图标、iconfont 或视觉资产参考。
+- 用户要求解释某个 Codex / Claude / Cursor agent 为什么没有发现 skill，或希望提升 skill 自动识别、路由、生成、安装和持续执行能力。
+- 用户没有显式说 skill 名也要触发；不要要求用户记住 `$openprd-benchmark-router`。
+
+## 路由流程
+
+1. 先识别优化对象：OpenPrd 产品/PRD 流程、CLI、skill 体系、长程任务、通用 harness、AI code review / PR review harness、context engineering、prompt engineering、图标资源或图标实现库。
+2. 读取当前工作区证据：`.openprd/`、`.openprd/benchmarks/index.md`、`.openprd/benchmarks/sources.yaml`、`AGENTS.md`、repo-local skills、生成的 `.codex/.claude/.cursor` 引导和相关源码。
+3. 选择最小足够的外部证据源：公开 GitHub 仓库走 DeepWiki；第三方工具、SDK、CLI 或官方 API 用 Context7；产品官方文档、工程博客和一手资料用官方来源。
+4. 形成 OpenPrd 设计判断时，明确区分已证实事实、从来源归纳出的设计原则，以及对本项目的推断。
+5. 用分析维度提炼可迁移原则，避免照搬表面功能。
+6. 如果任务变成大量参考项目行为挖掘、长时间覆盖或需求补全，再路由到 `$openprd-discovery-loop` 承接持续调研。
+
+## Project Registry
+
+- 项目自己的 `.openprd/benchmarks/` 优先于 OpenPrd 内置 Source Map。
+- `sources.yaml` 里的 approved source 是长期可复用参考；`inbox/` 里的 candidate 只表示待确认线索。
+- 用 `openprd benchmark add <url|repo|file>` 写入 candidate，用 `openprd benchmark approve <id>` 纳入 approved registry。
+- 用 `openprd benchmark verify` 检查重复来源、失效链接、缺失本地文件和过宽触发规则。
+
+## Source Policy
+
+- GitHub 仓库：需要理解架构、核心模块、关键流程或对标结论时，先用 DeepWiki。默认顺序是 `read_wiki_structure` 1 次，再 `ask_question` 1-2 次；只有在本地源码和已有结论仍不足时才追加。DeepWiki 不可用或覆盖不足时，再回退到 GitHub README、源码和官方文档。
+- 官方技术文档：涉及第三方库、框架、API、SDK、MCP、CLI 工具的用法、配置、限制、版本差异或迁移路径时，先检查本地代码、锁文件、README、类型定义；本地不足时再用 Context7，默认顺序是 `resolve_library_id` 1 次，再 `query_docs` 1-2 次。Context7 不足时说明缺口，再补官方文档、源码或其他一手资料。
+- 工程文章和产品文档：优先读取当前线上一手页面，只抽取和当前任务相关的观点与设计原则，不复制长文；如果内容可能过时，要说明时效风险。
+- 本地源码优先：当前工作区已经有相关源码时，常规修 bug、查实现、改功能优先读本地代码；DeepWiki 主要用于外部仓库架构理解和对标分析。
+- 停止调研：找到足以支持当前决策的 1-3 个高相关来源后停止扩展；候选来源重复时保留更权威、更新或更贴近当前任务的来源。
+- 追加调用前先写清“已确认什么、还缺什么”；不要为了同一问题只换个说法反复查询。
+
+## Source Map
+
+- OpenPrd / PRD 设计对标：`obra/superpowers`、`Fission-AI/OpenSpec`。
+- CLI 与 skill 体系对标：`larksuite/cli`、`anthropics/skills`、Claude Skills 官方文档、Claude Code Skills 官方文档。
+- 长程 Agent 任务：Anthropic long-running agents harness 工程文章。
+- 通用 harness：OpenAI harness engineering、LangChain agent harness anatomy。
+- AI code review / PR review harness：Nolan Lawson 的 “Using AI to write better code more slowly”、Milvus 关于多模型代码审查辩论/交叉验证的实验文章。
+- Context engineering：Manus context engineering、Anthropic context engineering。
+- Prompt engineering：OpenAI prompt engineering / prompt guidance、Claude prompt engineering、Gemini prompting strategies。
+- 图标资源站一级最佳实践：UI 图标优先看 Phosphor Icons（https://phosphoricons.com/）；AI 公司与产品图标看 LobeHub Icons（https://lobehub.com/icons）；技术栈图标看 Tech Icons（https://techicons.dev/）；透明底 3D 图标看 Thiings（https://www.thiings.co/things）；功能图标、矢量插画、3D 插画和字体资源看 iconfont（https://www.iconfont.cn/）。
+- 图标实现库二级最佳实践：Lucide、Tabler、React Icons。需要落到前端代码时，再结合当前项目框架、包管理器、bundle 体积和导入方式选择具体库。
+
+## Evaluation Lenses
+
+- 产品与工作流：用户从哪里开始、如何知道下一步、模糊输入如何变成结构化产物、哪些步骤要保存/展示/恢复、哪些步骤必须保留用户确认。
+- Agent 与 Harness：目标、边界、停止条件、工具选择、进度记录、证据、验证结果、失败恢复和人工接管点是否清楚。
+- PR 审查 lane：reviewer 是否独立审查、主代理是否先汇总再验证、是否有误报过滤、agreement matrix、严重级别和 merge recommendation。
+- 上下文工程：哪些信息常驻、哪些按需检索，是否使用稳定路径、链接和来源 ID 支持 just-in-time 检索，如何处理过期、冲突和可信度。
+- 提示词与 Skill 设计：触发描述是否具体但不过度强制，主说明是否短，细节是否按需放到 reference，是否明确不要硬套参考源。
+- 图标与视觉资产：先判断用途是 UI、AI 品牌、技术栈、3D 物件还是功能图标；优先选最贴近用途的资源站，再在实现阶段选择合适的代码图标库。
+- CLI 与开发者体验：命令是否可发现、可组合、可预测；错误信息是否说明发生了什么、影响是什么、下一步怎么做；危险操作是否有确认。
+
+## 设计输出
+
+- 给出 OpenPrd 应该内置什么、生成什么、路由什么、保留什么门禁。
+- 优先把结论落到 `CANONICAL_SKILLS`、repo-local skills、AGENTS/CLAUDE/Cursor 生成规则、hooks 或测试，而不是停留在口头建议。
+- 不把外部项目整包复制进 OpenPrd；只吸收可验证的路由、生成、门禁、状态承接和用户体验原则。
+- 需要显式说明时，简短写出参考了哪个来源、借鉴点、适用原因、不照搬边界，以及落到当前任务的具体决策。
+
+## Stop Rule
+
+- 同一来源默认只做一次结构理解和一到两次聚焦问题；证据足够支撑当前决策后立即停止调研。
+- 如果 DeepWiki、Context7 或官方资料覆盖不足，明确说明缺口，再把后续结论标为推断。
+
+## 参考资料
+
+- `references/benchmark-sources.md`
+- `references/source-policy.md`
+- `references/evaluation-lenses.md`

package/skills/openprd-benchmark-router/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "OpenPrd Benchmark Router"
+  short_description: "Route OpenPrd benchmark, deep-review-lane, and icon resource requests to the right evidence"
+  default_prompt: "Use $openprd-benchmark-router to choose benchmark sources and route best-practice, PR-review-harness, or icon-resource research before changing OpenPrd."

package/skills/openprd-benchmark-router/references/benchmark-sources.md

@@ -0,0 +1,74 @@
+# Benchmark Sources
+
+## 选择原则
+
+- 先选和当前优化对象最贴近的来源，不做泛泛资料堆叠。
+- 不把对标当成固定关键词匹配；如果参考源不能明显提升当前任务质量，就不要为了使用 skill 而调研。
+- 通常只选 1-3 个来源；候选重复时保留更权威、更新或更贴近当前任务的来源。
+- 环境、权限、账号、普通脚本报错、一次性短问答或与产品/领域设计无关的问题，不强行对标。
+- 公开 GitHub 仓库需要理解架构、子系统或生成链路时，优先用 DeepWiki。
+- 第三方工具、SDK、CLI、API、MCP 或版本相关文档，优先用 Context7。
+- 官方工程博客和官方文档只提炼可验证原则，不复制大段原文。
+- 足够支撑当前 OpenPrd 决策后停止调研。
+
+## 来源分组
+
+### OpenPrd / PRD 设计
+
+- `obra/superpowers`：重点看启动时 skill check、项目级 skill 优先级、强制路由和 session bootstrap。
+- `Fission-AI/OpenSpec`：重点看 tool adapter、动态生成 skill/command、配置 profile 和 instruction layering。
+
+### CLI 与 Skill 体系
+
+- `larksuite/cli`：重点看 CLI 入口、插件/命令组织和用户引导。
+- `anthropics/skills`：重点看 skill 文件结构、触发描述、progressive disclosure 和跨工具分发。
+- Claude Skills / Claude Code Skills 官方文档：重点看 agent 如何发现、选择和调用 skill。
+
+### 长程 Agent 任务
+
+- Anthropic long-running agents harness：重点看任务拆分、状态承接、失败恢复、验证回路和人工接管点。
+
+### 通用 Harness
+
+- OpenAI harness engineering：重点看 agent harness 的环境、工具、评估和反馈闭环。
+- LangChain agent harness anatomy：重点看 harness 组成、状态、工具执行和观察面。
+
+### AI Code Review / PR Review Harness
+
+- Nolan Lawson《Using AI to write better code more slowly》：重点看独立 reviewer 并行、主代理先不站队、汇总后再验证、严重级别与 merge 建议。
+- Milvus 多模型代码审查实验：重点看 reviewer agreement、交叉验证如何降低 hallucination 和 false positive。
+
+### Context Engineering
+
+- Manus context engineering：重点看上下文压缩、文件系统作为记忆、可恢复状态和错误保留。
+- Anthropic context engineering：重点看上下文选择、组织、工具反馈和长期任务信息边界。
+
+### Prompt Engineering
+
+- OpenAI prompt engineering / prompt guidance。
+- Claude prompt engineering。
+- Gemini prompting strategies。
+
+### 图标资源站一级最佳实践
+
+- Phosphor Icons（https://phosphoricons.com/）：UI、图表、演示和通用界面图标；适合需要统一线性/填充风格、开源授权和批量下载的场景。
+- LobeHub Icons（https://lobehub.com/icons）：AI 公司、AI 产品和模型品牌图标；适合需要 SVG、PNG、WebP 高清素材的 AI 相关页面、图示和演示。
+- Tech Icons（https://techicons.dev/）：Python、Swift 等技术栈图标；适合开发者工具、技术架构图、工程文档和技术产品界面。
+- Thiings（https://www.thiings.co/things）：透明底 3D 动物、物品、人物等图标；适合需要轻量 3D 视觉资产、封面或运营配图的场景。
+- iconfont（https://www.iconfont.cn/）：功能图标、矢量插画、3D 插画和字体资源；适合中文生态、语义搜索、在线编辑和彩色/可变字体图标场景。
+
+### 图标实现库二级最佳实践
+
+- Lucide：适合需要轻量、统一、开源线性图标并直接落到现代前端组件的场景。
+- Tabler：适合需要大量通用 UI 符号、细线风格和稳定 SVG/React 资产的场景。
+- React Icons：适合需要聚合多个图标集、快速覆盖品牌或历史图标需求的 React 项目；使用时关注子包导入和 bundle 体积。
+
+## 输出模板
+
+每次 benchmark 调研后，用这个结构回到 OpenPrd 设计：
+
+1. 已确认的外部事实。
+2. 对 OpenPrd 有价值的设计原则。
+3. 应改动的 OpenPrd 表面：CLI、skill、AGENTS/CLAUDE/Cursor 生成、hooks、文档或测试。
+4. 不采用的做法和原因。
+5. 仍缺的证据或需要用户确认的取舍。

package/skills/openprd-benchmark-router/references/evaluation-lenses.md

@@ -0,0 +1,66 @@
+# Evaluation Lenses
+
+使用这些维度把参考源转成当前任务可执行的判断。不要逐项机械套用；选择最相关的 3-5 个即可。
+
+## 产品与工作流
+
+- 用户从哪里开始，如何知道下一步做什么？
+- 系统如何把模糊输入变成结构化产物？
+- 哪些状态需要被显式保存、展示或恢复？
+- 哪些步骤应该自动化，哪些步骤必须保留用户确认？
+- 成功结果是什么，失败时用户如何继续？
+
+## Agent 与 Harness
+
+- Agent 的目标、边界和停止条件是否清楚？
+- 工具选择是否有歧义？工具结果是否高信号、低噪声？
+- 长程任务如何记录计划、进度、证据和验证结果？
+- 失败恢复靠重试、回滚、人工确认，还是重新规划？
+- 如何避免为了自主性牺牲安全性和可解释性？
+
+## PR 审查 Lane
+
+- reviewer 是独立并行审查，还是被前一个结论污染了上下文？
+- 主代理是在 reviewer 返回前就先做研究，还是先汇总再验证？
+- 是否显式区分发现、 dismissed findings、agreement matrix 和最终 merge recommendation？
+- 误报过滤和 hallucination filter 靠什么完成？是人工复核、代码验证，还是多 reviewer 交叉确认？
+- 这条 lane 是“高风险时可选增强”，还是被误做成所有 PR 默认开启的高成本流程？
+
+## 上下文工程
+
+- 哪些信息应常驻，哪些应按需检索？
+- 当前上下文是否包含足够证据，又没有塞入过多无关资料？
+- 是否使用稳定标识符、文件路径、链接、来源 ID 来支持 just-in-time 检索？
+- 历史状态、用户偏好和任务进度分别应该放在哪里？
+- 如何处理上下文过期、冲突和来源可信度？
+
+## 提示词与 Skill 设计
+
+- 触发描述是否具体，但不过度强制？
+- 主说明是否足够短，细节是否放到 reference 里按需读取？
+- 是否使用清晰标题、列表、表格或 XML/Markdown 分区？
+- 示例是否覆盖真实用法，而不是堆满边缘情况？
+- 是否明确说明不要做什么，尤其是不要硬套参考源？
+
+## 图标与视觉资产
+
+- 当前用途是 UI 图标、AI 品牌图标、技术栈图标、3D 物件还是功能图标？
+- 需要直接下载素材，还是需要落到代码里的图标组件库？
+- 授权、格式、透明背景、批量下载、Figma/Sketch 插件或在线编辑是否影响选择？
+- 图标风格是否和当前产品界面一致，是否会引入混杂的视觉语言？
+- 代码实现时是否关注 tree-shaking、子路径导入、包体积和已有设计系统约束？
+
+## CLI 与开发者体验
+
+- 命令是否可发现、可组合、可预测？
+- 帮助文本是否面向用户结果，而不是内部实现？
+- 错误信息是否说明发生了什么、影响是什么、下一步怎么做？
+- 默认行为是否安全，危险操作是否需要确认？
+- 配置、插件和扩展点是否容易理解和维护？
+
+## 输出判断
+
+- 借鉴了哪个原则。
+- 为什么它适合当前任务。
+- 哪些地方没有照搬。
+- 最终落到当前任务的具体决策。

package/skills/openprd-benchmark-router/references/source-policy.md

@@ -0,0 +1,35 @@
+# Source Policy
+
+按来源类型选择最小必要调研方式。不要因为索引里有链接，就默认读取所有来源。
+
+## GitHub 仓库
+
+- 如果任务需要理解公开仓库的架构、核心模块、关键流程或对标结论，先用 DeepWiki：先读 wiki structure，再做聚焦问答。
+- 如果 DeepWiki 不可用或覆盖不足，再回退到 GitHub README、源码和官方文档。
+- 如果当前工作区已经有该仓库源码，常规修 bug、查实现、改功能优先读本地代码。
+- 输出时区分 DeepWiki 结论、补充来源和推断。
+
+## 官方技术文档
+
+- 如果任务涉及第三方库、框架、API、SDK、MCP、CLI 工具的用法、配置、限制、版本差异或迁移路径，优先用 Context7。
+- 先 resolve library id，再查询文档。
+- Context7 不足时，说明不足点，再补官方文档、源码或其他一手资料。
+- 不要把记忆中的 API、参数、默认值、最佳实践当作已验证事实。
+
+## 工程文章和产品文档
+
+- 对工程文章、产品文章、博客和网页，优先读取当前线上页面。
+- 只抽取与当前任务相关的观点和设计原则，不复制长文。
+- 如果文章有发布日期或内容可能过时，在输出中说明核验日期或时效风险。
+
+## 本地索引与记忆
+
+- `benchmark-sources.md` 是路由索引，不是事实来源。
+- 来源目录只代表候选来源，不代表来源内容已经被核验。
+- 长期偏好只能记录用户确认过的复用经验，不替代外部核验。
+
+## 何时停止调研
+
+- 已找到足以支持当前决策的 1-3 个高相关来源时，停止扩展。
+- 如果候选来源互相重复，保留更权威、更新或更贴近当前任务的来源。
+- 如果没有明显收益，不要为了使用 Skill 而进行外部调研。

package/skills/openprd-diagram-review/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: openprd-diagram-review
+description: 生成并迭代 OpenPrd 图示产物，供用户确认。适用于架构图、产品流程图、用户旅程、流程图、系统边界图、依赖图，以及 freeze 前的可视化评审场景。
+---
+
+# OpenPrd Diagram Review
+
+## 概览
+
+这份 skill 用来判断当前需要哪种图、生成可渲染的 diagram contract、调用 OpenPrd 当前支持的渲染能力，并把结果变成和用户往返确认的评审循环，而不是一次性出图。
+
+## 动手前
+
+1. 读取 `skills/openprd-shared/SKILL.md`
+2. 重建当前工作区状态，判断用户究竟想确认什么
+3. 决定用户需要的是：
+   - `architecture` 视图
+   - `product-flow` 视图
+4. 不要虚构今天还不存在的 OpenPrd diagram 命令
+
+## 图示类型选择
+
+当用户在问这些内容时，选 `architecture`：
+
+- 模块
+- 系统边界
+- 服务
+- 外部依赖
+- 可靠性 / 合规性问题
+- handoff 形态
+
+当用户在问这些内容时，选 `product-flow`：
+
+- 用户步骤
+- 决策点
+- 正常路径 / 错误路径
+- onboarding 或旅程流程
+- 页面到页面、步骤到步骤的推进
+
+如果两者都出现：
+
+- 当用户行为和流程仍不清楚时，先做 `product-flow` contract
+- 流程清楚后，再做架构评审
+
+## 当前工具能力
+
+当前 OpenPrd CLI 提供：
+
+- `openprd diagram <path> [--open] [--json]`
+
+现在它主要渲染面向架构的 HTML / JSON 产物。
+
+因此：
+
+- 对 `architecture`，直接调用内置命令
+- 对 `product-flow`，即使还没有专门渲染器，也先生成结构化 contract 和评审清单
+- 如果工具还没有专用流程渲染器，就不要假装它已经存在
+
+## 语言规则
+
+- 所有用户可见标签和评审说明都跟随用户当前主语言
+- Diagram contract 是用户可见产物。当 `locale` 为 `zh-CN` 时，以下可见字段必须写成简体中文：
+  - `title`、`subtitle`
+  - `components[].name`、`components[].subtitle`、`components[].details`
+  - `flows[].label`
+  - `summaryCards[].title`、`summaryCards[].items`
+  - `sidePanels[].title`、`sidePanels[].items`
+  - `reviewInstructions`
+- 专有名词、产品名、协议名、API 名称、框架名和云服务名在翻译会降低清晰度时保持原样
+- 像 MotiClaw、Electron、TypeScript、CLI、API、JSON、NDJSON、dry-run、Host API、schema、`waiting_approval` 这类必要术语可以保留，但周围句子必须译成简体中文
+- 不要在 zh-CN diagram contract 里写完整英文句子。运行 `openprd diagram --input` 前，至少人工检查一遍并把英文偏重的可见文本改成简体中文
+- 如果对话语言混合，优先跟随最近几轮需求澄清中占主导的语言
+
+## 评审循环
+
+生成图示产物后：
+
+1. 展示或打开图示产物
+2. 请用户确认：
+   - 是否缺了组件或步骤
+   - 系统边界或泳道是否画错
+   - 是否遗漏依赖或路径
+   - 是否缺少错误路径或签核点
+3. 把未解决项继续保留为假设或开放问题
+4. 只有在可视化评审收敛后，才建议 freeze
+
+## 需要时阅读这些参考资料
+
+- `references/diagram-contracts.md`：架构图和产品流程图 contract
+- `references/review-checklist.md`：渲染后应该问用户什么
+- `references/cocoon-patterns.md`：从 `Cocoon-AI/architecture-diagram-generator` 借来的可复用模式

package/skills/openprd-diagram-review/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "OpenPrd Diagram Review"
+  short_description: "Generate and review OpenPrd diagrams before freeze"
+  default_prompt: "Use $openprd-diagram-review to generate a diagram artifact and get user confirmation before freeze."