{
"canonical_name": "product-on-purpose/pm-skills",
"compilation_id": "pack_918aed8b56854b819557377d07aea8f4",
"created_at": "2026-05-21T19:56:19.956472+00:00",
"created_by": "project-pack-compiler",
"feedback": {
"carrier_selection_notes": [
"viable_asset_types=skill, recipe, host_instruction, eval, preflight",
"recommended_asset_types=skill, recipe, host_instruction, eval, preflight"
],
"evidence_delta": {
"confirmed_claims": [
"identity_anchor_present",
"capability_and_host_targets_present",
"install_path_declared_or_better"
],
"missing_required_fields": [],
"must_verify_forwarded": [
"Run or inspect `npx skills` in an isolated environment.",
"Confirm the project exposes the claimed capability to at least one target host."
],
"quickstart_execution_scope": "allowlisted_sandbox_smoke",
"sandbox_command": "npx skills",
"sandbox_container_image": "node:22-slim",
"sandbox_execution_backend": "docker",
"sandbox_planner_decision": "deterministic_isolated_install",
"sandbox_validation_id": "sbx_872562e496ef422eb5a52d08ac389f31"
},
"feedback_event_type": "project_pack_compilation_feedback",
"learning_candidate_reasons": [],
"template_gaps": []
},
"identity": {
"canonical_id": "project_1946e9a0df31daef219b75cd77ba04c6",
"canonical_name": "product-on-purpose/pm-skills",
"homepage_url": null,
"license": "unknown",
"repo_url": "https://github.com/product-on-purpose/pm-skills",
"slug": "pm-skills",
"source_packet_id": "phit_bfd86b1db1474cf8bbbfd3d8b389d519",
"source_validation_id": "dval_cc1ee5e3a68649afb70f283d91795cd3"
},
"merchandising": {
"best_for": "需要软件开发与交付能力，并使用 claude的用户",
"github_forks": 32,
"github_stars": 212,
"one_liner_en": "Curated, plug-and-play product management skills for AI agents. 40 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0.",
"one_liner_zh": "Curated, plug-and-play product management skills for AI agents. 40 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0.",
"primary_category": {
"category_id": "software-development",
"confidence": "high",
"name_en": "Software Development",
"name_zh": "软件开发与交付",
"reason": "matched_keywords:code, git, ci"
},
"target_user": "使用 claude, claude_code 等宿主 AI 的用户",
"title_en": "pm-skills",
"title_zh": "pm-skills 能力包",
"visible_tags": [
{
"label_en": "MCP Tools",
"label_zh": "MCP 工具",
"source": "repo_evidence_project_characteristics",
"tag_id": "product_domain-mcp-tools",
"type": "product_domain"
},
{
"label_en": "Knowledge Base Q&A",
"label_zh": "知识库问答",
"source": "repo_evidence_project_characteristics",
"tag_id": "user_job-knowledge-base-q-a",
"type": "user_job"
},
{
"label_en": "Workflow Automation",
"label_zh": "流程自动化",
"source": "repo_evidence_project_characteristics",
"tag_id": "core_capability-workflow-automation",
"type": "core_capability"
},
{
"label_en": "Node-based Workflow",
"label_zh": "节点式流程编排",
"source": "repo_evidence_project_characteristics",
"tag_id": "workflow_pattern-node-based-workflow",
"type": "workflow_pattern"
},
{
"label_en": "Evaluation Suite",
"label_zh": "评测体系",
"source": "repo_evidence_project_characteristics",
"tag_id": "selection_signal-evaluation-suite",
"type": "selection_signal"
}
]
},
"packet_id": "phit_bfd86b1db1474cf8bbbfd3d8b389d519",
"page_model": {
"artifacts": {
"artifact_slug": "pm-skills",
"files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json",
"REPO_INSPECTION.md",
"CAPABILITY_CONTRACT.json",
"EVIDENCE_INDEX.json",
"CLAIM_GRAPH.json"
],
"required_files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json"
]
},
"detail": {
"capability_source": "Project Hit Packet + DownstreamValidationResult",
"commands": [
{
"command": "npx skills",
"label": "Node.js / npx · 官方安装入口",
"source": "https://github.com/product-on-purpose/pm-skills#readme",
"verified": true
}
],
"display_tags": [
"MCP 工具",
"知识库问答",
"流程自动化",
"节点式流程编排",
"评测体系"
],
"eyebrow": "软件开发与交付",
"glance": [
{
"body": "判断自己是不是目标用户。",
"label": "最适合谁",
"value": "需要软件开发与交付能力，并使用 claude的用户"
},
{
"body": "先理解能力边界，再决定是否继续。",
"label": "核心价值",
"value": "Curated, plug-and-play product management skills for AI agents. 40 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0."
},
{
"body": "未完成验证前保持审慎。",
"label": "继续前",
"value": "publish to Doramagic.ai project surfaces"
}
],
"guardrail_source": "Boundary & Risk Card",
"guardrails": [
{
"body": "Prompt Preview 只展示流程，不证明项目已安装或运行。",
"label": "Check 1",
"value": "不要把试用当真实运行"
},
{
"body": "claude, claude_code",
"label": "Check 2",
"value": "确认宿主兼容"
},
{
"body": "publish to Doramagic.ai project surfaces",
"label": "Check 3",
"value": "先隔离验证"
}
],
"mode": "skill, recipe, host_instruction, eval, preflight",
"pitfall_log": {
"items": [
{
"body": "仓库名 `pm-skills` 与安装入口 `skills` 不完全一致。",
"category": "身份坑",
"evidence": [
"identity.distribution | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | repo=pm-skills; install=skills"
],
"severity": "medium",
"suggested_check": "在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。",
"title": "仓库名和安装名不一致",
"user_impact": "用户照着仓库名搜索包或照着包名找仓库时容易走错入口。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-14] Workflow Builder (/workflow-builder)",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_fd2240d9f58c49edbcc147428ff9b561 | https://github.com/product-on-purpose/pm-skills/issues/133 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：[F-14] Workflow Builder (/workflow-builder)",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-15] Ad-Hoc Skill Chaining (/chain)",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_151a0a8448c84b81b626bf03b88d2714 | https://github.com/product-on-purpose/pm-skills/issues/134 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：[F-15] Ad-Hoc Skill Chaining (/chain)",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v2.11.1 - skills.sh CLI Compatibility Patch",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_55aa5dc614634b48a39a0310a9b5fd45 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.11.1 - skills.sh CLI Compatibility Patch",
"user_impact": "可能影响升级、迁移或版本选择。"
},
{
"body": "项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。",
"category": "配置坑",
"evidence": [
"capability.host_targets | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | host_targets=claude, claude_code"
],
"severity": "medium",
"suggested_check": "列出会写入的配置文件、目录和卸载/回滚步骤。",
"title": "可能修改宿主 AI 配置",
"user_impact": "安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。"
},
{
"body": "README/documentation is current enough for a first validation pass.",
"category": "能力坑",
"evidence": [
"capability.assumptions | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | README/documentation is current enough for a first validation pass."
],
"severity": "medium",
"suggested_check": "将假设转成下游验证清单。",
"title": "能力判断依赖假设",
"user_impact": "假设不成立时，用户拿不到承诺的能力。"
},
{
"body": "GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：[M-21] Explore release-please Integration",
"category": "维护坑",
"evidence": [
"community_evidence:github | cevd_acdd9d4cd91c449f964bf1924ec0b6e1 | https://github.com/product-on-purpose/pm-skills/issues/136 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：[M-21] Explore release-please Integration",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：v2.12.0 OKR Skills Launch",
"category": "维护坑",
"evidence": [
"community_evidence:github | cevd_f2a160e56ca04946816b63eab92a85cd | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.12.0 OKR Skills Launch",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "未记录 last_activity_observed。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | last_activity_observed missing"
],
"severity": "medium",
"suggested_check": "补 GitHub 最近 commit、release、issue/PR 响应信号。",
"title": "维护活跃度未知",
"user_impact": "新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"downstream_validation.risk_items | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "进入安全/权限治理复核队列。",
"title": "下游验证发现风险项",
"user_impact": "下游已经要求复核，不能在页面中弱化。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"risks.scoring_risks | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "把风险写入边界卡，并确认是否需要人工复核。",
"title": "存在评分风险",
"user_impact": "风险会影响是否适合普通用户安装。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.13.1",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_e5dab862059242fd8f82b7814ef33eb8 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.13.1 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.13.1",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "issue_or_pr_quality=unknown。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | issue_or_pr_quality=unknown"
],
"severity": "low",
"suggested_check": "抽样最近 issue/PR，判断是否长期无人处理。",
"title": "issue/PR 响应质量未知",
"user_impact": "用户无法判断遇到问题后是否有人维护。"
},
{
"body": "release_recency=unknown。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | release_recency=unknown"
],
"severity": "low",
"suggested_check": "确认最近 release/tag 和 README 安装命令是否一致。",
"title": "发布节奏不明确",
"user_impact": "安装命令和文档可能落后于代码，用户踩坑概率升高。"
}
],
"source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals",
"summary": "发现 14 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。",
"title": "踩坑日志"
},
"snapshot": {
"contributors": 5,
"forks": 32,
"license": "unknown",
"note": "站点快照，非实时质量证明；用于开工前背景判断。",
"stars": 212
},
"source_url": "https://github.com/product-on-purpose/pm-skills",
"steps": [
{
"body": "不安装项目，先体验能力节奏。",
"code": "preview",
"title": "先试 Prompt"
},
{
"body": "理解输入、输出、失败模式和边界。",
"code": "manual",
"title": "读说明书"
},
{
"body": "把上下文交给宿主 AI 继续工作。",
"code": "context",
"title": "带给 AI"
},
{
"body": "进入主力环境前先完成安装入口与风险边界验证。",
"code": "verify",
"title": "沙箱验证"
}
],
"subtitle": "Curated, plug-and-play product management skills for AI agents. 40 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0.",
"title": "pm-skills 能力包",
"trial_prompt": "# pm-skills - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 pm-skills 的“安装前体验版”。\n这不是项目介绍、不是评价报告、不是 README 总结。你的任务是让我用最小成本体验它的核心服务。\n\n我的试用任务：我想用它完成一个真实的软件开发与交付任务。\n我常用的宿主 AI：claude / Claude Code\n\n【体验目标】\n围绕我的真实任务，现场演示这个项目如何把输入转成 步骤建议, 检查清单, 专业工作流。重点是让我感受到工作方式，而不是给我项目背景。\n\n【业务流约束】\n- 你必须像一个正在提供服务的项目能力包，而不是像一个讲解员。\n- 每一轮只推进一个步骤；提出问题后必须停下来等我回答。\n- 每一步都必须让我感受到一个具体服务动作：澄清、整理、规划、检查、判断或收尾。\n- 每一步都要说明：当前目标、你需要我提供什么、我回答后你会产出什么。\n- 不要安装、不要运行命令、不要写代码、不要声称测试通过、不要声称已经修改文件。\n- 需要真实安装或宿主加载后才能验证的内容，必须明确说“这一步需要安装后验证”。\n- 如果我说“用示例继续”，你可以用虚构示例推进，但仍然不能声称真实执行。\n\n【可体验服务能力】\n- AI Skill / Agent 指令资产库: 项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 输入：用户任务, 宿主 AI 对话上下文, 项目内 Skill/Agent 文档；输出：步骤建议, 检查清单, 专业工作流。\n\n【必须安装后才可验证的能力】\n- 多宿主安装与分发: 项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 输入：宿主 AI 工具, 插件配置, 安装命令；输出：宿主内可发现的插件/技能集合。\n- 命令行启动或安装流程: 项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 输入：终端环境, 包管理器, 项目依赖；输出：安装结果, 列表/更新/运行结果。\n\n【核心服务流】\n请严格按这个顺序带我体验。不要一次性输出完整流程：\n1. project-introduction：项目介绍。围绕“项目介绍”模拟一次用户任务，不展示安装或运行结果。\n2. skill-library-overview：技能库概览。围绕“技能库概览”模拟一次用户任务，不展示安装或运行结果。\n3. skill-anatomy：技能结构解析。围绕“技能结构解析”模拟一次用户任务，不展示安装或运行结果。\n4. skill-lifecycle：技能生命周期管理。围绕“技能生命周期管理”模拟一次用户任务，不展示安装或运行结果。\n5. sub-agents：子代理系统。围绕“子代理系统”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. project-introduction\n输入：用户提供的“项目介绍”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. skill-library-overview\n输入：用户提供的“技能库概览”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. skill-anatomy\n输入：用户提供的“技能结构解析”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. skill-lifecycle\n输入：用户提供的“技能生命周期管理”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n5. sub-agents\n输入：用户提供的“子代理系统”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / project-introduction：Step 1 必须围绕“项目介绍”形成一个小中间产物，并等待用户确认。\n- Step 2 / skill-library-overview：Step 2 必须围绕“技能库概览”形成一个小中间产物，并等待用户确认。\n- Step 3 / skill-anatomy：Step 3 必须围绕“技能结构解析”形成一个小中间产物，并等待用户确认。\n- Step 4 / skill-lifecycle：Step 4 必须围绕“技能生命周期管理”形成一个小中间产物，并等待用户确认。\n- Step 5 / sub-agents：Step 5 必须围绕“子代理系统”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/product-on-purpose/pm-skills\n- https://github.com/product-on-purpose/pm-skills#readme\n- docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md\n- docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md\n- docs/templates/skill-template/SKILL.md\n- skills/define-hypothesis/SKILL.md\n- skills/define-jtbd-canvas/SKILL.md\n- skills/define-opportunity-tree/SKILL.md\n- skills/define-problem-statement/SKILL.md\n- skills/deliver-acceptance-criteria/SKILL.md\n- skills/deliver-edge-cases/SKILL.md\n- skills/deliver-launch-checklist/SKILL.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 pm-skills 的核心服务。\n2. 当前步骤：明确进入 Step 1，并说明这一步要解决什么。\n3. 你会如何服务我：说明你会先改变我完成任务的哪个动作。\n4. 只问我 3 个问题，然后停下等待回答。\n\n首次回复禁止输出：后续完整流程、证据清单、安装命令、项目评价、营销文案、已经安装或运行的说法。\n\nStep 1 / brainstorming 的二轮协议：\n- 我回答首次三问后，你仍然停留在 Step 1 / brainstorming，不要进入 Step 2。\n- 第二次回复必须产出 6 个部分：澄清后的任务定义、成功标准、边界条件、\n 2-3 个可选方案、每个方案的权衡、推荐方案。\n- 第二次回复最后必须问我是否确认推荐方案；只有我明确确认后，才能进入下一步。\n- 第二次回复禁止输出 git worktree、代码计划、测试文件、命令或真实执行结果。\n\n后续对话规则：\n- 我回答后，你先完成当前步骤的中间产物并等待确认；只有我确认后，才能进入下一步。\n- 每一步都要生成一个小的中间产物，例如澄清后的目标、计划草案、测试意图、验证清单或继续/停止判断。\n- 所有演示都写成“我会建议/我会引导/这一步会形成”，不要写成已经真实执行。\n- 不要声称已经测试通过、文件已修改、命令已运行或结果已产生。\n- 如果某个能力必须安装后验证，请直接说“这一步需要安装后验证”。\n- 如果证据不足，请明确说“证据不足”，不要补事实。\n```\n",
"voices": [
{
"body": "来源平台：github。github/github_issue: [M-21] Explore release-please Integration（https://github.com/product-on-purpose/pm-skills/issues/136）；github/github_issue: [F-15] Ad-Hoc Skill Chaining (/chain)（https://github.com/product-on-purpose/pm-skills/issues/134）；github/github_issue: [F-14] Workflow Builder (/workflow-builder)（https://github.com/product-on-purpose/pm-skills/issues/133）；github/github_release: v2.17.0 - Native Sub-Agent Registration + Frontmatter Spec Alignment（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.17.0）；github/github_release: v2.16.2（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.16.2）；github/github_release: v2.16.1（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.16.1）；github/github_release: v2.16.0（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.16.0）；github/github_release: v2.15.1 - Post-Tag Audit Remediation + Preventive CI（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.15.1）；github/github_release: v2.15.0 - Sprint Skills Launch（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.15.0）；github/github_release: v2.13.1（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.13.1）；github/github_release: v2.12.0 OKR Skills Launch（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0）；github/github_release: v2.11.1 - skills.sh CLI Compatibility Patch（https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1）。这些是项目级外部声音，不作为单独质量证明。",
"items": [
{
"kind": "github_issue",
"source": "github",
"title": "[M-21] Explore release-please Integration",
"url": "https://github.com/product-on-purpose/pm-skills/issues/136"
},
{
"kind": "github_issue",
"source": "github",
"title": "[F-15] Ad-Hoc Skill Chaining (/chain)",
"url": "https://github.com/product-on-purpose/pm-skills/issues/134"
},
{
"kind": "github_issue",
"source": "github",
"title": "[F-14] Workflow Builder (/workflow-builder)",
"url": "https://github.com/product-on-purpose/pm-skills/issues/133"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.17.0 - Native Sub-Agent Registration + Frontmatter Spec Alignment",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.17.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.16.2",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.16.2"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.16.1",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.16.1"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.16.0",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.16.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.15.1 - Post-Tag Audit Remediation + Preventive CI",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.15.1"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.15.0 - Sprint Skills Launch",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.15.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.13.1",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.13.1"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.12.0 OKR Skills Launch",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.11.1 - skills.sh CLI Compatibility Patch",
"url": "https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1"
}
],
"status": "已收录 13 条来源",
"title": "社区讨论"
}
]
},
"homepage_card": {
"category": "软件开发与交付",
"desc": "Curated, plug-and-play product management skills for AI agents. 40 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0.",
"effort": "安装已验证",
"forks": 32,
"icon": "code",
"name": "pm-skills 能力包",
"risk": "可发布",
"slug": "pm-skills",
"stars": 212,
"tags": [
"MCP 工具",
"知识库问答",
"流程自动化",
"节点式流程编排",
"评测体系"
],
"thumb": "gray",
"type": "Skill Pack"
},
"manual": {
"markdown": "# https://github.com/product-on-purpose/pm-skills 项目说明书\n\n生成时间: 2026-05-21 19:54:48 UTC\n\n## 目录\n\n- [项目介绍](#project-introduction)\n- [技能库概览](#skill-library-overview)\n- [技能结构解析](#skill-anatomy)\n- [技能分类体系](#skill-categories)\n- [技能生命周期管理](#skill-lifecycle)\n- [子代理系统](#sub-agents)\n- [工作流系统](#workflows)\n- [工具家族](#tool-families)\n- [安装与平台配置](#installation-guide)\n- [样本输出库](#sample-outputs)\n\n\n\n## 项目介绍\n\n### 相关页面\n\n相关主题：[技能库概览](#skill-library-overview), [安装与平台配置](#installation-guide)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/product-on-purpose/pm-skills/blob/main/README.md)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n \n\n# 项目介绍\n\n## 概述\n\n**pm-skills** 是一个面向产品经理（Product Manager）的技能框架与文档站点，托管于 GitHub 仓库 [product-on-purpose/pm-skills](https://github.com/product-on-purpose/pm-skills)。该项目旨在将产品管理工作中常见的流程拆解为可复用的技能（Skills）、标准化的工作流（Workflows）以及可自动化执行的子代理（Sub-agents）。\n\n资料来源：[package.json:2](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 技术栈\n\npm-skills 基于现代前端技术构建文档站点，核心技术选型如下：\n\n| 技术选型 | 版本 | 用途 |\n|---------|------|------|\n| Astro | ^6.3.0 | 静态站点生成框架 |\n| @astrojs/starlight | ~0.39.0 | 文档主题与 UI 组件 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表渲染 |\n| Mermaid | ^11.15.0 | 流程图与架构图绘制 |\n| sharp | ^0.34.5 | 图片处理优化 |\n| devalue | ^5.8.1 | 序列化库 |\n\n项目要求 Node.js 版本不低于 **22.12.0**，采用 ES Module（`\"type\": \"module\"`）规范。\n\n资料来源：[package.json:3-18](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 核心架构\n\npm-skills 的架构围绕三大核心概念展开：**工作流（Workflows）**、**技能（Skills）** 和 **子代理（Sub-agents）**。\n\n```mermaid\ngraph TD\n A[pm-skills 项目] --> B[Workflows 工作流]\n A --> C[Skills 技能库]\n A --> D[Sub-agents 子代理]\n \n B --> B1[多技能引导序列]\n B --> B2[PM 标准流程定义]\n \n C --> C1[define-hypothesis]\n C --> C2[更多技能模块]\n \n D --> D1[pm-critic 评审代理]\n D --> D2[pm-skill-auditor 审计代理]\n D --> D3[pm-changelog-curator 变更日志代理]\n D --> D4[pm-release-conductor 发布代理]\n```\n\n资料来源：[_workflows/README.md:1-10](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n## 内容组织\n\n### 文档结构\n\n项目采用 Astro Starlight 构建文档站点，内容目录结构如下：\n\n| 目录 | 说明 |\n|------|------|\n| `docs/` | 用户文档（skills、guides、concepts、contributing 等） |\n| `library/` | 示例输出与子代理样本库 |\n| `_workflows/` | 工作流定义源文件 |\n| `_agent-context/` | AI 代理工作区策略文档 |\n| `scripts/` | 构建与生成脚本 |\n\n内容配置支持通过 glob 模式加载 Markdown/MDX 文件，并自动排除以下内容：\n\n- `docs/internal/`：Gitignored 的发布计划与内部笔记\n- `docs/templates/`：包含 `` 语法的模板文件\n- `docs/**/README.md`：GitHub 目录自动渲染页面（避免重复）\n- 遗留样本文件：符合 `sample_*_legacy_*` 或 `sample_*_orbit_*` 模式的文件\n\n资料来源：[src/content.config.ts:1-80](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### 技能输出样本\n\n`library/skill-output-samples/` 目录包含真实场景下的子代理输出样本，用于展示各子代理的标准输出格式与行为模式。\n\n每个样本包含：\n\n- **Frontmatter 元数据**：title、description、artifact、version、repo_version、agent_version、created、status、thread、context\n- **Scenario 场景**：触发子代理的背景信息\n- **Output 输出**：子代理的实际输出内容\n- **Notes 笔记**：样本的演示说明\n\n资料来源：[library/sub-agent-samples/README.md:1-30](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 子代理体系\n\n### 代理分类\n\n| 子代理名称 | 功能 | 样本数量 |\n|-----------|------|---------|\n| `pm-critic` | 对 PRD、OKR、会议记录进行对抗性评审 | 3 |\n| `pm-skill-auditor` | 跨技能审计与漂移检测 | 3 |\n| `pm-changelog-curator` | 生成规范化的变更日志 | 3 |\n| `pm-release-conductor` | 协调发布流程与门控检查 | 3 |\n\n### 叙事线程\n\n子代理输出跨越三个叙事线程，用于验证代理在不同产品场景下的一致性表现：\n\n| 线程 | 产品类型 | 场景特征 |\n|------|---------|---------|\n| **Brainshelf** | 消费者 PKM（个人知识管理）应用 | 消费级产品 PM 语境 |\n| **Storevine** | B2B 营销分析平台 | 数据产品 PM 语境 |\n| **Workbench** | 内部平台工具团队 | 平台/DX PM 语境 |\n\n资料来源：[library/sub-agent-samples/README.md:80-100](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 工作流定义\n\n`_workflows/` 目录采用 Markdown 格式定义多技能工作流，每个文件描述一个产品管理流程的引导式技能序列。\n\n### 链接约定\n\n工作流文件使用 **仓库相对路径** 引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n此约定确保 AI 代理（Copilot、Cursor、Windsurf）和仓库浏览器可直接解析链接。\n\n资料来源：[_workflows/README.md:8-15](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 编辑规范\n\n工作流内容直接在 `_workflows/` 目录编辑，**不要**直接修改 `docs/workflows/`，后者由 `scripts/generate-workflow-pages.py` 脚本自动生成。\n\n## AI 代理工作区\n\n`_agent-context/codex/` 目录定义了 Codex 工作区的策略规范：\n\n### 持久化文件（Git 跟踪）\n\n| 文件 | 用途 |\n|------|------|\n| `CONTEXT.md` | 稳定的当前状态事实 |\n| `DECISIONS.md` | 已接受的决策与理由 |\n| `WRAP-SESSION_TEMPLATE.md` | 会话交接模板 |\n| `WORKTREE-PRIMER.md` | 清洁分支工作流指南 |\n\n### 本地文件（Git 忽略）\n\n| 路径/文件 | 用途 |\n|----------|------|\n| `PLANNING/**` | 探索性规划草稿 |\n| `TODO.md` | 临时任务清单 |\n| `AGENTS/SESSION-LOG/` | 会话日志目录 |\n\n资料来源：[_agent-context/codex/README.md:1-40](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n\n## 样式与渲染\n\n### 自定义样式\n\n项目通过 `src/styles/custom.css` 实现 Starlight 主题定制：\n\n- **Mermaid 图表**：最大宽度 100%，SVG 高度自适应\n- **图表优化**：线条宽度 1.75px、节点圆角 6px、聚类填充透明度 0.4\n\n### 主题变量\n\nAstro 配置文件中定义了 Mermaid 主题变量（`lineColor` 与 `fontFamily`），确保图表在浅色与深色模式下的一致呈现。\n\n资料来源：[src/styles/custom.css:1-35](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n\n## 构建流程\n\n### NPM 脚本\n\n| 命令 | 功能 |\n|------|------|\n| `npm run dev` | 启动开发服务器（热重载） |\n| `npm run build` | 生产构建（含 Markdown 链接清理） |\n| `npm run preview` | 预览生产构建结果 |\n| `npm run astro` | 调用 Astro CLI |\n\n构建流程包含后处理步骤 `scripts/post-build-strip-md-links.mjs`，用于清理生成的 Markdown 链接。\n\n资料来源：[package.json:7-12](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 扩展字段\n\n内容配置为文档和样本定义了丰富的 Frontmatter 扩展字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `generated` | boolean | 内容是否由脚本生成 |\n| `source` | string | 原始来源 |\n| `phase` | string | 所属阶段 |\n| `classification` | string | 分类 |\n| `version` | string/number | 版本号 |\n| `updated` | string/Date | 更新时间 |\n| `artifact` | string | 子代理输出类型 |\n| `created` | string/Date | 创建时间 |\n| `status` | string | 样本状态 |\n| `thread` | string | 叙事线程 |\n| `context` | string | 上下文信息 |\n| `tags` | string[] | 标签数组 |\n| `metadata` | object | 额外元数据 |\n\n资料来源：[src/content.config.ts:50-75](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 快速开始\n\n```bash\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm run dev\n\n# 生产构建\nnpm run build\n```\n\n访问本地开发服务器（默认 `http://localhost:4321`）查看文档站点。\n\n---\n\n\n\n## 技能库概览\n\n### 相关页面\n\n相关主题：[技能结构解析](#skill-anatomy), [技能分类体系](#skill-categories), [项目介绍](#project-introduction)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n \n\n# 技能库概览\n\n## 概述\n\npm-skills 是一个面向产品经理（PM）的技能库与文档站点，基于 Astro Starlight 构建。该项目为产品管理全生命周期提供结构化的技能指导，覆盖从发现机会到持续迭代的完整流程。\n\n技能库采用 Markdown 文件组织，每个技能独立成篇，支持 AI 代理（如 Copilot、Cursor、Windsurf）直接调用和解析。\n\n资料来源：[package.json:3-7](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 技能库架构\n\n### 技能分类\n\n技能库按产品管理流程阶段划分为七大类别：\n\n| 技能类别 | 用途 | 示例技能 |\n|---------|------|---------|\n| discover | 发现问题与机会 | 用户研究、竞品分析 |\n| define | 定义问题与目标 | 定义假设、绘制用户旅程 |\n| develop | 方案构思与设计 | 原型设计、功能规划 |\n| deliver | 交付与发布 | 发布计划、变更管理 |\n| measure | 度量与评估 | 指标定义、数据分析 |\n| iterate | 迭代优化 | 优先级排序、复盘总结 |\n| foundation | 基础工具与方法论 | OKR 设定、会议主持 |\n\n资料来源：[src/content.config.ts:15-25](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### 目录结构\n\n技能文件采用统一目录布局，每个技能目录下包含核心文档：\n\n```text\nskills/\n├── discover/\n│ └── SKILL.md\n├── define/\n│ ├── define-hypothesis/\n│ │ └── SKILL.md\n│ └── SKILL.md\n├── develop/\n├── deliver/\n├── measure/\n├── iterate/\n└── foundation/\n```\n\n技能文件使用 **repo-relative 路径** 进行内部引用，确保 AI 代理和仓库浏览器直接解析：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n资料来源：[_workflows/README.md:9-13](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n## 内容加载机制\n\n### Astro 内容集合配置\n\n技能库通过 Astro 内容集合加载，支持 Markdown 和 MDX 格式：\n\n```typescript\nloader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md',\n ],\n base: '.',\n})\n```\n\n资料来源：[src/content.config.ts:15-25](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### Slug 生成规则\n\n系统自动处理路径转换，生成干净的 URL slug：\n\n| 源文件 | 生成 Slug |\n|--------|----------|\n| `docs/skills/index.md` | `skills` |\n| `docs/skills/define-hypothesis/SKILL.md` | `skills/define-hypothesis/SKILL` |\n| `library/skill-output-samples/` 下的文件 | `samples/...` |\n\n资料来源：[src/content.config.ts:26-40](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 技能内容 Schema\n\n### 通用字段\n\n每个技能文档支持以下标准 frontmatter 字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `title` | string | 技能标题 |\n| `description` | string | 技能描述 |\n| `generated` | boolean | 是否为生成内容 |\n| `source` | string | 来源引用 |\n| `phase` | string | 所属阶段 |\n| `classification` | string | 分类标识 |\n| `version` | string \\| number | 技能版本 |\n| `updated` | string \\| Date | 更新时间 |\n| `tags` | string[] | 标签列表 |\n| `draft` | boolean | 是否为草稿 |\n\n资料来源：[src/content.config.ts:45-60](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 技能输出样本库\n\n### 样本分类\n\n技能库包含真实场景的技能输出样本，按三个叙事线程组织：\n\n| 线程 | 应用场景 | 产品类型 |\n|------|----------|----------|\n| **Brainshelf** | 消费者 PKM 应用 | 个人知识管理 App |\n| **Storevine** | B2B 活动分析平台 | 数据分析产品 |\n| **Workbench** | 内部平台工具团队 | 平台/DX 产品 |\n\n资料来源：[library/sub-agent-samples/README.md:85-90](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### 子代理能力\n\n技能库通过子代理扩展功能，每个子代理专注于特定任务：\n\n| 子代理 | 职能 | 输出类型 |\n|--------|------|----------|\n| `pm-critic` | 对抗性评审 | 问题分级（P0-P3） |\n| `pm-skill-auditor` | 技能审计 | 跨技能一致性检查 |\n| `pm-changelog-curator` | 变更日志整理 | 版本发布草稿 |\n\n资料来源：[library/sub-agent-samples/README.md:17-24](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 工作流集成\n\n### 工作流定义\n\n工作流是多技能的有序组合，定义产品管理常见流程：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n每个 `.md` 文件定义一个多技能工作流，指导 AI 代理完成完整的产品管理流程。\n\n资料来源：[_workflows/README.md:5-10](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 工作流与技能关系\n\n```mermaid\ngraph TD\n A[工作流定义] --> B[discover 技能]\n A --> C[define 技能]\n A --> D[develop 技能]\n A --> E[deliver 技能]\n A --> F[measure 技能]\n A --> G[iterate 技能]\n \n B --> H[pm-critic 评审]\n C --> H\n D --> H\n E --> H\n F --> H\n G --> H\n \n H --> I[pm-skill-auditor 审计]\n I --> J[pm-changelog-curator 变更整理]\n J --> K[pm-release-conductor 发布]\n```\n\n## 可视化样式\n\n### Mermaid 图表集成\n\n技能库全面支持 Mermaid 图表，通过 `astro-mermaid` 集成：\n\n```json\n{\n \"astro-mermaid\": \"~2.0.1\",\n \"overrides\": {\n \"mermaid\": \"^11.15.0\"\n }\n}\n```\n\n资料来源：[package.json:18-22](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n### 图表样式定制\n\n自定义样式提供更好的可读性：\n\n```css\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n资料来源：[src/styles/custom.css:14-25](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n\n## 文档生成与发布\n\n### 构建流程\n\n项目使用自动化构建流程：\n\n```json\n{\n \"build\": \"astro build && node scripts/post-build-strip-md-links.mjs\"\n}\n```\n\n构建后脚本移除 Markdown 链接，生成最终静态站点。\n\n资料来源：[package.json:12](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n### 节点版本要求\n\n```json\n{\n \"engines\": {\n \"node\": \">=22.12.0\"\n }\n}\n```\n\n资料来源：[package.json:8](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 快速入门\n\n1. **浏览技能**：访问 `/skills/` 目录查看所有可用技能\n2. **选择阶段**：根据产品管理流程阶段选择对应技能\n3. **查看样本**：参考 `/samples/` 目录中的实际输出样本\n4. **使用工作流**：通过 `/workflows/` 中的工作流串联多个技能\n\n## 相关资源\n\n- [子代理库样本](../library/sub-agent-samples/index.md) - 各子代理的真实输出示例\n- [工作流定义](../_workflows/index.md) - 多技能组合的工作流\n- [发布运行手册](../docs/contributing/release-runbook.md) - 发布流程指南\n\n---\n\n\n\n## 技能结构解析\n\n### 相关页面\n\n相关主题：[技能生命周期管理](#skill-lifecycle), [技能分类体系](#skill-categories)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [docs/reference/pm-skill-anatomy.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/pm-skill-anatomy.md)\n- [docs/reference/frontmatter-schema.yaml](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/frontmatter-schema.yaml)\n- [docs/templates/skill-template/SKILL.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/templates/skill-template/SKILL.md)\n- [docs/templates/skill-template/references/TEMPLATE.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/templates/skill-template/references/TEMPLATE.md)\n- [docs/templates/skill-template/references/EXAMPLE.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/templates/skill-template/references/EXAMPLE.md)\n \n\n# 技能结构解析\n\n## 概述\n\n技能（Skill）是 pm-skills 项目中 PM（产品经理）工作流程的核心执行单元。每个技能定义了一个具体的、可复用的产品管理实践或决策框架，供 AI Agent 在不同场景下调用。技能以 Markdown 文件形式存储在仓库的 `skills/` 目录下，具有标准化的结构、元数据和引用机制。\n\n技能的设计目标是使 PM 工作流程原子化、可组合、可追溯。通过统一的技能格式，AI Agent（如 Codex、Claude）能够理解并执行从需求假设定义到产品决策验证的完整链条。\n\n## 技能核心结构\n\n### 文件组成\n\n一个完整的技能包含以下文件：\n\n| 文件 | 说明 | 必需 |\n|------|------|------|\n| `SKILL.md` | 技能主定义文件，包含元数据和执行指南 | 是 |\n| `references/` | 目录，包含 `TEMPLATE.md` 和 `EXAMPLE.md` | 是 |\n\n资料来源：[docs/templates/skill-template/SKILL.md]()\n\n### 主文件元数据（Frontmatter）\n\n每个技能的主文件必须包含 YAML frontmatter，定义技能的身份信息：\n\n```yaml\n---\ntitle: 技能标题\ndescription: 技能简短描述（1-2 句话）\nversion: 1.0.0\ncreated: YYYY-MM-DD\nstatus: draft | published | deprecated\nsource: 初始来源或灵感引用\nskill_version: 当前版本号\ncontext: 适用场景标签（如 brainshelf、storevine、workbench）\n---\n```\n\n支持的扩展字段包括：\n\n| 字段名 | 类型 | 说明 |\n|--------|------|------|\n| `title` | 字符串 | 技能显示标题 |\n| `description` | 字符串 | 简短功能描述 |\n| `version` | 字符串或数字 | 语义化版本号 |\n| `created` | 字符串或日期 | 创建时间 |\n| `status` | 枚举 | 技能状态：draft、published、deprecated |\n| `source` | 字符串 | 来源引用 |\n| `skill_version` | 字符串或数字 | 技能特定版本 |\n| `context` | 字符串 | 适用场景 |\n| `generated` | 布尔值 | 是否为生成内容 |\n| `classification` | 字符串 | 技能分类 |\n| `tags` | 字符串数组 | 标签列表 |\n| `metadata` | 对象 | 自定义元数据 |\n\n资料来源：[docs/reference/frontmatter-schema.yaml]()\n资料来源：[src/content.config.ts:25-70]()\n\n### 正文结构\n\n技能主文件正文遵循标准化的文档结构：\n\n```markdown\n## 目的\n说明技能解决的问题和价值\n\n## 触发条件\n何时应该使用此技能\n\n## 使用指南\n技能的详细执行步骤\n\n## 变体与场景\n不同情境下的适配方式\n```\n\n## 引用系统\n\n### references 目录结构\n\n每个技能必须包含 `references/` 子目录，用于存放扩展文档：\n\n```\nskills/技能名称/\n├── SKILL.md\n└── references/\n ├── TEMPLATE.md # 该技能的模板文档\n └── EXAMPLE.md # 该技能的示例文档\n```\n\n资料来源：[docs/templates/skill-template/SKILL.md]()\n\n### 引用命名规范\n\n| 文件名 | 用途 | 内容特点 |\n|--------|------|----------|\n| `TEMPLATE.md` | 模板参考 | 展示如何创建该技能的变体或扩展 |\n| `EXAMPLE.md` | 实际示例 | 真实场景的应用案例 |\n\n### 跨技能引用\n\n技能之间可以相互引用，使用仓库相对路径：\n\n```markdown\n[`define-hypothesis`](../define-hypothesis/SKILL.md)\n```\n\n这种链接格式确保 AI Agent 和文档系统都能正确解析技能间关系。资料来源：[_workflows/README.md:15-17]()\n\n## 技能分类体系\n\npm-skills 项目采用多层分类体系组织技能：\n\n### 场景分类（Thread）\n\n| 场景 | 说明 | 典型用例 |\n|------|------|----------|\n| `brainshelf` | 消费者 PKM（个人知识管理）应用 | 产品重 surfaced PRD 评审 |\n| `storevine` | B2B 活动分析平台 | Q2 OKR 设置与验证 |\n| `workbench` | 内部平台工具团队 | Sprint 回顾与决策追踪 |\n\n资料来源：[library/sub-agent-samples/README.md:60-74]()\n\n### 问题优先级体系\n\n技能执行过程中使用 P0-P3 优先级标记问题：\n\n| 优先级 | 含义 | 处理要求 |\n|--------|------|----------|\n| P0 | 阻断性问题 | 必须立即修复 |\n| P1 | 重要缺陷 | 下一迭代修复 |\n| P2 | 次要问题 | 计划内修复 |\n| P3 | 建议改进 | 视情况处理 |\n\n资料来源：[library/sub-agent-samples/README.md:6-11]()\n\n## 技能执行流程\n\n技能的执行通过子代理（Sub-Agent）系统完成，不同类型的技能由相应的子代理处理：\n\n```mermaid\ngraph TD\n A[用户触发] --> B{技能类型判断}\n B -->|PRD 评审| C[pm-critic]\n B -->|技能审计| D[pm-skill-auditor]\n B -->|变更日志| E[pm-changelog-curator]\n B -->|发布流程| F[pm-release-conductor]\n C --> G[问题评级 P0-P3]\n D --> G\n E --> H[生成输出]\n F --> H\n G --> I[状态信封]\n I --> H\n```\n\n资料来源：[library/sub-agent-samples/README.md:1-45]()\n\n### 子代理职责\n\n| 子代理 | 功能 | 输出类型 |\n|--------|------|----------|\n| `pm-critic` | 对抗性评审，捕获合同完整性、可证伪性、实验设计问题 | 评审报告 |\n| `pm-skill-auditor` | 跨技能审计，检测漂移和结构问题 | 审计发现 |\n| `pm-changelog-curator` | 自动生成变更日志 | 草稿文档 |\n| `pm-release-conductor` | 执行发布门控流程 | 门控状态 |\n\n## 技能与工作流的关系\n\n### 工作流定义\n\n工作流（Workflow）是由多个技能组成的引导序列，定义在 `_workflows/` 目录中。每个工作流文件（`.md`）使用技能引用链接构建执行路径。\n\n```mermaid\ngraph LR\n subgraph 工作流示例\n W1[define-hypothesis] --> W2[design-experiment]\n W2 --> W3[analyze-results]\n W3 --> W4[decide-pivot]\n end\n```\n\n资料来源：[_workflows/README.md:1-8]()\n\n### 链接规范\n\n工作流文件中的技能链接必须使用仓库相对路径：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n此格式确保 AI Agent 和 GitHub 目录浏览器都能正确解析。\n\n## 文档生成机制\n\npm-skills 使用 Astro Starlight 构建文档站点，技能文件通过内容收集器加载：\n\n```typescript\n// src/content.config.ts\nconst collections = {\n docs: defineCollection({\n loader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n 'library/skill-output-samples/**/sample_*.md',\n // ...\n ],\n base: '.',\n }),\n schema: docsSchema({\n extend: z.object({ /* pm-skills 扩展字段 */ })\n }),\n }),\n};\n```\n\n资料来源：[src/content.config.ts:1-80]()\n\n### 内容加载规则\n\n| 规则 | 说明 |\n|------|------|\n| `docs/**` | 文档主目录 |\n| `!docs/internal/**` | 排除内部工作文件 |\n| `!docs/templates/**` | 排除模板目录 |\n| `!docs/**/README.md` | 排除目录着陆页 |\n\n## 技能模板使用\n\n创建新技能时应基于技能模板，遵循以下步骤：\n\n1. 复制 `docs/templates/skill-template/` 目录结构\n2. 修改 `SKILL.md` 的 frontmatter 元数据\n3. 填写正文各节内容\n4. 完善 `references/` 中的模板和示例\n5. 将新技能放置于 `skills/` 目录相应分类下\n\n### 模板字段说明\n\n| 字段 | 填写要求 |\n|------|----------|\n| `title` | 使用动词短语，准确描述技能行为 |\n| `description` | 限 1-2 句话，说明技能解决的问题 |\n| `version` | 遵循语义化版本 `MAJOR.MINOR.PATCH` |\n| `status` | 新技能初始为 `draft`，审核通过后改为 `published` |\n\n资料来源：[docs/templates/skill-template/references/TEMPLATE.md]()\n资料来源：[docs/templates/skill-template/references/EXAMPLE.md]()\n\n## 最佳实践\n\n### 技能编写规范\n\n- **原子性**：每个技能应专注于单一职责\n- **可组合性**：技能应能与其他技能组合形成工作流\n- **可测试性**：技能应有明确的成功/失败判定标准\n- **文档完整性**：所有字段必须填写，引用必须有效\n\n### 状态管理\n\n| 状态 | 使用场景 |\n|------|----------|\n| `draft` | 开发中或审核中的技能 |\n| `published` | 已完成审核，可正式使用的技能 |\n| `deprecated` | 已废弃，不建议新项目使用 |\n\n### 版本控制\n\n技能版本遵循语义化版本规范：\n\n- **MAJOR**：不兼容的 API 变更\n- **MINOR**：向后兼容的功能添加\n- **PATCH**：向后兼容的问题修复\n\n## 相关资源\n\n- 技能目录：`skills/`\n- 工作流目录：`_workflows/`\n- 子代理定义：`agents/`\n- 运行时组件参考：[docs/reference/runtime-components.md]()\n- 发布运行手册：[docs/contributing/release-runbook.md]()\n\n---\n\n\n\n## 技能分类体系\n\n### 相关页面\n\n相关主题：[技能库概览](#skill-library-overview), [技能结构解析](#skill-anatomy)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [docs/reference/categories.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/categories.md)\n- [docs/reference/skill-families/index.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/index.md)\n- [docs/reference/skill-families/design-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/design-sprint-skills-contract.md)\n- [docs/reference/skill-families/foundation-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/foundation-sprint-skills-contract.md)\n- [docs/reference/skill-families/meeting-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/meeting-skills-contract.md)\n \n\n# 技能分类体系\n\n## 概述\n\npm-skills 项目采用分层分类体系来组织产品管理技能（PM Skills），通过技能家族（Skill Families）和技能契约（Skills Contract）机制实现技能的结构化管理。该体系是项目架构的核心支柱，为 AI 代理提供标准化的技能调用接口和一致性的输出格式。\n\n技能分类体系的核心目标是：\n\n- 建立产品管理领域的技能分类标准\n- 为不同叙事线程（Threads）提供统一的技能调用框架\n- 通过技能契约确保子代理输出的结构一致性\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 技能家族架构\n\n### 技能家族定义\n\n技能家族是相关技能的逻辑分组，每个家族定义了特定产品管理场景下的技能集合。根据项目结构，主要的技能家族包括：\n\n| 技能家族 | 描述 | 典型场景 |\n|---------|------|---------|\n| Foundation Sprint Skills | 基础产品管理技能集 | 需求定义、假设验证、用户研究 |\n| Design Sprint Skills | 设计冲刺相关技能 | 快速原型、用户测试、设计决策 |\n| Meeting Skills | 会议与协作技能 | 会议复盘、决策追踪、团队沟通 |\n| Utility PM Roles | 跨场景工具技能 | 发布管理、变更日志、技能审计 |\n\n资料来源：[docs/reference/skill-families/index.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/index.md)\n\n### 技能契约机制\n\n技能契约（Skills Contract）是定义技能家族行为规范的核心文档，每个契约包含：\n\n```mermaid\ngraph TD\n A[技能契约] --> B[输入规范]\n A --> C[输出格式]\n A --> D[状态封装]\n A --> E[评级标准]\n \n B --> B1[工件类型]\n B --> B2[上下文要求]\n \n C --> C1[结构化输出]\n C --> C2[元数据字段]\n \n D --> D1[Status 信封]\n D --> D2[分类标签]\n \n E --> E1[P0-P3 优先级]\n E --> E2[验收标准]\n```\n\n资料来源：[docs/reference/skill-families/design-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/design-sprint-skills-contract.md)\n\n## 技能契约类型详解\n\n### Foundation Sprint 技能契约\n\nFoundation Sprint 技能家族聚焦于产品管理的基础活动，涵盖从概念到验证的完整链路。\n\n#### 核心技能\n\n| 技能名称 | 功能描述 | 触发条件 |\n|---------|---------|---------|\n| define-hypothesis | 定义可验证的产品假设 | 新功能规划、问题分析 |\n| user-research | 用户研究整合 | 需求调研、用户反馈分析 |\n| okr-review | OKR 设置审查 | 季度规划、目标对齐 |\n| prd-review | 产品需求文档审查 | 需求评审、PRD 验收 |\n\n#### 契约规范\n\nFoundation Sprint 技能契约定义了标准化的输入输出格式。输入端接受工件（Artifact）类型，包括产品需求文档、OKR 设置、用户研究数据等。输出端采用分层状态封装（Status Envelope）模式，确保子代理输出的一致性。\n\n资料来源：[docs/reference/skill-families/foundation-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/foundation-sprint-skills-contract.md)\n\n### Design Sprint 技能契约\n\nDesign Sprint 技能家族服务于快速设计和验证流程，强调短周期、高密度的迭代模式。\n\n#### 契约特点\n\n```mermaid\ngraph LR\n A[问题定义] --> B[原型设计]\n B --> C[用户测试]\n C --> D[数据分析]\n D -->|快速反馈| A\n \n E[Design Sprint 契约] --> F[时限约束]\n E --> G[原型标准]\n E --> H[测试协议]\n```\n\nDesign Sprint 契约相比 Foundation Sprint 增加了以下约束：\n\n- **时限约束**：明确规定各阶段的完成时间窗口\n- **原型标准**：定义可测试原型的最低要求\n- **测试协议**：标准化用户测试的流程和数据收集方式\n\n资料来源：[docs/reference/skill-families/design-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/design-sprint-skills-contract.md)\n\n### Meeting Skills 契约\n\nMeeting Skills 家族专注于会议相关的技能定义和输出规范。\n\n#### 契约结构\n\n| 字段 | 类型 | 说明 |\n|-----|------|-----|\n| title | string | 会议标题 |\n| decisions | array | 会议决策清单 |\n| action_items | array | 行动项列表 |\n| owner | string | 决策责任人 |\n| status | enum | 决策状态（待处理/进行中/已完成）|\n\n资料来源：[docs/reference/skill-families/meeting-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/meeting-skills-contract.md)\n\n## 分类维度\n\n### 按叙事线程分类\n\npm-skills 围绕三个叙事线程组织内容，每个线程代表不同的产品管理上下文：\n\n```mermaid\ngraph TD\n P[产品管理技能] --> B[Brainshelf]\n P --> S[Storevine]\n P --> W[Workbench]\n \n B --> B1[消费者 PKM 应用]\n B --> B2[个人知识管理]\n \n S --> S1[B2B 活动分析]\n S --> S2[数据产品管理]\n \n W --> W1[内部平台工具]\n W --> W2[开发者体验]\n```\n\n- **Brainshelf**：面向消费者的个人知识管理应用场景\n- **Storevine**：B2B 活动分析平台的产品管理场景\n- **Workbench**：内部平台工具团队的开发者体验场景\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### 按子代理分类\n\n系统中的四个核心子代理分别承担不同的评审和执行职责：\n\n| 子代理 | 职责 | 输出类型 |\n|-------|------|---------|\n| pm-critic | 对抗性评审 | 问题发现与评级 |\n| pm-skill-auditor | 技能一致性审计 | 漂移检测报告 |\n| pm-changelog-curator | 变更日志整理 | 发布说明草稿 |\n| pm-release-conductor | 发布流程编排 | 门控流程执行 |\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 分类元数据\n\n### Frontmatter 字段\n\n技能文档和样本输出使用统一的 frontmatter 字段定义：\n\n| 字段 | 类型 | 说明 |\n|-----|------|-----|\n| title | string | 文档标题 |\n| version | string/number | 版本号 |\n| artifact | string | 工件类型 |\n| status | string | 状态标识 |\n| thread | string | 叙事线程 |\n| classification | string | 分类标识 |\n| created | string/Date | 创建时间 |\n\n资料来源：[src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts:58-78)\n\n### 分类标识系统\n\n项目采用分层分类标识系统，通过 classification 字段区分不同类型的技能定义：\n\n```mermaid\ngraph TD\n C[Classification] --> C1[skill]\n C --> C2[sub-agent]\n C --> C3[workflow]\n C --> C4[sample]\n \n C1 --> C1A[foundation]\n C1 --> C1B[design-sprint]\n C1 --> C1C[meeting]\n \n C2 --> C2A[critic]\n C2 --> C2B[auditor]\n C2 --> C2C[curator]\n C2 --> C2D[conductor]\n```\n\n## 分类体系的工程实现\n\n### 内容配置架构\n\n技能分类通过 Astro 内容集合（Content Collections）实现：\n\n```typescript\nexport const collections = {\n docs: defineCollection({\n loader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n 'library/skill-output-samples/**/sample_*.md',\n ],\n }),\n schema: docsSchema({\n extend: z.object({\n classification: z.string().optional(),\n thread: z.string().optional(),\n artifact: z.string().optional(),\n }),\n }),\n }),\n};\n```\n\n资料来源：[src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts:1-20)\n\n### 样式与渲染\n\n技能分类文档的渲染遵循 Starlight 主题规范，通过自定义 CSS 实现 Mermaid 图表和技能契约的可视化展示：\n\n```css\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n```\n\n资料来源：[src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css:15-27)\n\n## 使用指南\n\n### 调用技能的正确路径\n\n在技能文档中使用仓库相对路径引用相关技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n这种方式确保 AI 代理可以直接解析和调用技能定义。\n\n资料来源：[_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 样本输出的分类标记\n\n子代理样本输出按照以下规范标记分类信息：\n\n| 标记项 | 示例值 | 说明 |\n|-------|-------|------|\n| thread | brainshelf/storevine/workbench | 叙事上下文 |\n| artifact | grading/report/draft/flow | 输出工件类型 |\n| status | sample | 标识为样本输出 |\n\n## 总结\n\n技能分类体系是 pm-skills 项目的基础架构，通过技能家族、技能契约和叙事线程三个维度实现了产品管理技能的结构化组织。该体系确保了不同子代理输出的可预测性和一致性，同时为 AI 代理提供了标准化的技能调用接口。开发者应遵循既定的分类规范，通过技能契约定义新技能，并通过统一的 frontmatter 字段确保分类元数据的完整性。\n\n---\n\n\n\n## 技能生命周期管理\n\n### 相关页面\n\n相关主题：[技能结构解析](#skill-anatomy)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n \n\n# 技能生命周期管理\n\n## 概述\n\npm-skills 是一个基于 Starlight 构建的产品管理技能文档站点，通过 AI Agent 子代理（Sub-agent）系统实现对产品管理（PM）工作流程的结构化支持。技能生命周期管理涵盖了从技能定义、验证、迭代优化到最终发布评审的完整流程。\n\n当前仓库包含多类子代理，用于支持不同的 PM 工作场景：\n\n| 子代理 | 用途 | 触发场景 |\n|--------|------|----------|\n| `pm-critic` | 对抗性评审 | PRD 审查、OKR 审查、会议复盘审查 |\n| `pm-skill-auditor` | 技能审计 | 预发布审计、漂移检测、跨切面检查 |\n| `pm-changelog-curator` | 变更日志整理 | 版本发布变更记录生成 |\n| `pm-release-conductor` | 发布协调 | 发布流程编排、门控管理 |\n\n资料来源：[library/sub-agent-samples/README.md:1-30]()\n\n## 三条叙事主线\n\npm-skills 通过三条叙事主线（Thread）贯穿整个技能库和子代理示例系统，每条主线代表不同的产品管理场景上下文：\n\n| 叙事主线 | 产品类型 | PM 场景特点 |\n|----------|----------|-------------|\n| **Brainshelf** | 消费级 PKM（个人知识管理）应用 | 消费产品 PM 上下文 |\n| **Storevine** | B2B 营销分析平台 | 数据产品 / 分析 PM 上下文 |\n| **Workbench** | 内部平台工具团队 | 平台 / 开发者体验（DX）PM 上下文 |\n\n这三条主线确保同一子代理在不同场景下能产生结构一致的输出（统一的 P0/P1/P2/P3 优先级语法、D26 规范的 Status 信封结构），而场景差异仅影响被审阅产物的内容本身。\n\n资料来源：[library/sub-agent-samples/README.md:85-100]()\n\n## 技能文件结构\n\n### 技能目录组织\n\n每个 PM 技能作为独立目录存储在 `skills/` 下，包含标准化文件结构：\n\n```\nskills/\n└── /\n └── SKILL.md # 技能定义文件\n```\n\n### 技能链接规范\n\n工作流文件（`_workflows/` 目录）使用**仓库相对路径**引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n这种格式确保 AI 代理（Copilot、Cursor、Windsurf）和仓库浏览器可直接解析链接。\n\n资料来源：[_workflows/README.md:14-16]()\n\n## 内容集合架构\n\npm-skills 使用 Astro Starlight 构建文档站点，内容通过 `src/content.config.ts` 中的 collections 配置管理：\n\n```typescript\nexport const collections = {\n docs: defineCollection({\n loader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md',\n '!library/skill-output-samples/**/sample_*_legacy_*.md',\n '!library/skill-output-samples/**/sample_*_orbit_*.md',\n ],\n base: '.',\n }),\n // ...\n }),\n};\n```\n\n### 内容加载规则\n\n| 模式 | 说明 |\n|------|------|\n| `docs/**/*.{md,mdx}` | 文档主内容 |\n| `!docs/internal/**` | 排除内部文件（gitignored） |\n| `!docs/templates/**` | 排除模板文件 |\n| `!docs/**/README.md` | 排除 GitHub 目录自动渲染页 |\n| `library/skill-output-samples/**/sample_*.md` | 包含技能输出样本 |\n| `!sample_*_legacy_*.md` / `!sample_*_orbit_*.md` | 排除历史遗留样本 |\n\n资料来源：[src/content.config.ts:30-45]()\n\n### Slug 生成策略\n\n内容加载器使用自定义 `generateId` 函数处理路径前缀，确保 URL 整洁：\n\n| 源文件路径 | 生成 Slug |\n|------------|-----------|\n| `docs/foo/bar.md` | `foo/bar` |\n| `docs/skills/index.md` | `skills` |\n| `library/skill-output-samples/define-hypothesis/sample_X.md` | `samples/define-hypothesis/sample_X` |\n| `docs/README.md` | `readme`（统一小写） |\n\n资料来源：[src/content.config.ts:55-75]()\n\n## 子代理样本体系\n\n### 样本文件规范\n\n每个子代理样本文件包含标准化的 Frontmatter 元数据：\n\n```yaml\n---\ntitle: <样本标题>\ndescription: <场景描述>\nartifact: <子代理输出类型>\nversion: <版本号>\nrepo_version: <仓库版本>\ncreated: <创建日期>\nstatus: sample\nthread: \ncontext: <上下文说明>\n---\n```\n\n### 样本结构\n\n每个样本文件包含三个主要部分：\n\n1. **Scenario（场景）**：触发子代理调用的具体情况（产物、受众、触发器）\n2. **Output（输出）**：子代理的实际输出（分级、发现、草稿、门控流程）\n3. **Notes（备注）**：样本演示内容和与三线程目录的关联\n\n资料来源：[library/sub-agent-samples/README.md:47-62]()\n\n## 技能输出样本示例\n\n以下是各子代理在不同叙事主线下的典型输出场景：\n\n| 子代理 | 叙事主线 | 典型场景 | 输出特点 |\n|--------|----------|----------|----------|\n| `pm-critic` | Brainshelf | PRD 审查 | 1 P0 + 3 P1 + 2 P2 + 1 P3，覆盖契约完整性、可证伪性、实验设计 |\n| `pm-critic` | Storevine | OKR 审查 | 2 P0 拒绝协议捕获（伪造基线 + 功能交付 KR） |\n| `pm-critic` | Workbench | 会议复盘审查 | 1 P0 家族契约违反：决策无负责人 |\n| `pm-skill-auditor` | Brainshelf | 预发布审计 | 2 P1 前瞻性发现 + 3 P2 周期内预期漂移 |\n| `pm-skill-auditor` | Storevine | 漂移检测 | 1 P0 CONTEXT.md 声明与文件系统派生不匹配 |\n| `pm-skill-auditor` | Workbench | 跨切面检查 | 1 P0 孤立命令 + 1 P1 缺失配对 |\n| `pm-changelog-curator` | Brainshelf | 次要版本草稿 | 50 commits；5 Added + 2 Changed + 1 Fixed + 2 Security + 1 Known Limitations |\n| `pm-changelog-curator` | Storevine | 补丁版本草稿 | 3 commits；2 Fixed + 1 Security |\n| `pm-changelog-curator` | Workbench | 功能版本草稿 | 80 commits；多轨形态跨越子代理 + 内容 + hooks + 解析器 |\n| `pm-release-conductor` | Brainshelf | 干净运行 | 全部 6 个门控首次通过；基线形态 |\n| `pm-release-conductor` | Storevine | 门控失败恢复 | G0 聚合计数器漂移 + 维护者恢复（失败恢复循环；无绕过；G0 幂等性） |\n| `pm-release-conductor` | Workbench | 链式干跑 | 审计员在 G0 + G2.5；策展人在 G2；分层 Status 信封 |\n\n资料来源：[library/sub-agent-samples/README.md:18-35]()\n\n## 发布门控系统\n\n`pm-release-conductor` 子代理实现了多层级发布门控（Gate）系统：\n\n### 门控层级\n\n| 门控层级 | 触发时机 | 检查内容 |\n|----------|----------|----------|\n| G0 | 初始阶段 | 审计员执行基线检查 |\n| G2 | 中期阶段 | 策展人执行变更日志验证 |\n| G2.5 | 中后期 | 审计员执行补充检查 |\n| G3 | 最终阶段 | 综合评审 |\n\n### 门控状态信封\n\n每个门控结果使用统一的状态信封结构（符合 D26 规范）：\n\n```json\n{\n \"status\": \"PASS|FAIL|WARNING\",\n \"gate\": \"G0|G2|G2.5|G3\",\n \"findings\": [...],\n \"recommendations\": [...]\n}\n```\n\n资料来源：[library/sub-agent-samples/README.md:30-35]()\n\n## 技术栈与构建系统\n\npm-skills 采用以下技术栈：\n\n| 组件 | 版本 | 用途 |\n|------|------|------|\n| Astro | ^6.3.0 | 静态站点生成器 |\n| @astrojs/starlight | ~0.39.0 | 文档框架 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表集成 |\n| sharp | ^0.34.5 | 图片处理 |\n| Mermaid | ^11.15.0 | 图表渲染 |\n| Node.js | >=22.12.0 | 运行时要求 |\n\n资料来源：[package.json:1-25]()\n\n### 构建流程\n\n```bash\nnpm run build # 执行 astro build + post-build-strip-md-links 脚本\nnpm run dev # 开发服务器\nnpm run preview # 预览构建结果\n```\n\n资料来源：[package.json:10-15]()\n\n## 可视化样式配置\n\n### Mermaid 图表样式\n\n文档站点的 Mermaid 图表使用自定义样式规则：\n\n```css\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n这些样式规则适用于亮色和暗色模式，覆盖所有图表类型（流程图、序列图、甘特图等）。\n\n资料来源：[src/styles/custom.css:18-35]()\n\n## 工作流与技能协调\n\n### 多技能工作流定义\n\n`_workflows/` 目录定义了多技能工作流，作为常见 PM 流程的引导式技能序列。每个 `.md` 文件对应一个完整的工作流定义，使用仓库相对路径引用相关技能文件。\n\n### 子代理任务分配\n\n| 子代理 | 典型任务 | 协调关系 |\n|--------|----------|----------|\n| `pm-critic` | 质量把关 | 上游输入评审 |\n| `pm-skill-auditor` | 一致性检查 | 中游验证 |\n| `pm-changelog-curator` | 版本记录 | 下游文档化 |\n| `pm-release-conductor` | 流程编排 | 全局协调 |\n\n资料来源：[_workflows/README.md:1-20]()\n\n## 最佳实践\n\n### 技能文件编辑\n\n- 直接编辑 `docs/` 目录下的内容\n- **不要**直接编辑 `docs/workflows/` 目录下的文件（这些由脚本自动生成）\n- 使用 `scripts/generate-workflow-pages.py` 脚本从 `_workflows/` 目录生成工作流页面\n\n### 代理会话管理\n\nCodex 工作区使用以下策略管理会话：\n\n- **持久化文件**（由 git 追踪）：`CONTEXT.md`、`DECISIONS.md`、`WRAP-SESSION_TEMPLATE.md`、`WORKTREE-PRIMER.md`\n- **本地文件**（被 gitignore）：`PLANNING/**`、`TODO.md`\n- **会话日志**：写入共享的 `AGENTS/SESSION-LOG/` 目录\n\n资料来源：[_agent-context/codex/README.md:5-20]()\n\n## 总结\n\n技能生命周期管理在 pm-skills 项目中体现为：\n\n1. **结构化技能定义**：每个 PM 技能以标准化目录结构存储在 `skills/` 下\n2. **多场景验证**：通过三条叙事主线（Brainshelf、Storevine、Workbench）确保技能在不同上下文中的一致性\n3. **自动化质量保障**：子代理系统（pm-critic、pm-skill-auditor 等）覆盖从设计到发布的全流程\n4. **版本化文档系统**：基于 Astro Starlight 的文档站点支持技能输出样本的持续积累\n5. **发布门控机制**：多层级门控系统确保发布质量，失败恢复机制保障流程健壮性\n\n---\n\n\n\n## 子代理系统\n\n### 相关页面\n\n相关主题：[工作流系统](#workflows), [工具家族](#tool-families)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n \n\n# 子代理系统\n\n子代理系统是 pm-skills 项目中的核心模块化组件架构，旨在为产品管理流程提供专业化、可复用的 AI 辅助能力。每个子代理（Sub-agent）专注于特定的产品管理任务，通过标准化的接口与主系统集成。\n\n## 系统概述\n\npm-skills 的子代理系统包含四个核心子代理，分别对应产品管理工作流中的不同环节：\n\n| 子代理名称 | 主要职能 | 输出产物 |\n|---|---|---|\n| `pm-critic` | 对 PRDs、OKRs、会议决策等进行对抗性审查 | 分级审查报告（P0/P1/P2/P3 问题标注） |\n| `pm-skill-auditor` | 审计技能定义的完整性和一致性 | 审计报告（漂移检测、孤岛检测） |\n| `pm-changelog-curator` | 根据提交记录生成规范的变更日志 | CHANGELOG 草稿 |\n| `pm-release-conductor` | 协调发布流程中的多阶段门控验证 | 发布流程状态报告 |\n\n资料来源：[library/sub-agent-samples/README.md:1-40](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 子代理线程模型\n\n子代理系统基于三个叙事线程（Thread）来组织示例和场景，每个线程代表不同的产品管理上下文：\n\n- **Brainshelf**：消费级 PKM（个人知识管理）应用场景\n- **Storevine**：B2B 营销分析平台场景\n- **Workbench**：内部平台工具团队场景\n\n这种设计确保同一子代理在不同业务上下文中产生结构一致的输出，同时内容贴合实际场景需求。\n\n```mermaid\ngraph TD\n subgraph 叙事线程\n B[brainshelf
消费级 PKM]\n S[storevine
B2B 分析平台]\n W[workbench
平台工具团队]\n end\n \n subgraph 子代理能力\n C[pm-critic
对抗性审查]\n A[pm-skill-auditor
技能审计]\n L[pm-changelog-curator
变更日志整理]\n R[pm-release-conductor
发布协调]\n end\n \n B --> C\n S --> C\n W --> C\n \n B --> A\n S --> A\n W --> A\n \n B --> L\n S --> L\n W --> L\n \n B --> R\n S --> R\n W --> R\n```\n\n资料来源：[library/sub-agent-samples/README.md:130-145](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 子代理详细规格\n\n### pm-critic\n\n`pm-critic` 是对抗性审查子代理，负责对产品文档和决策进行严格的质量检查。\n\n**典型场景：**\n\n- PRD（产品需求文档）审查\n- OKR（目标与关键成果）设定审核\n- 会议决策回顾\n\n**问题分级标准：**\n\n| 级别 | 含义 | 示例问题类型 |\n|---|---|---|\n| P0 | 致命问题 | 契约完整性违规、基线数据伪造 |\n| P1 | 严重问题 | 可证伪性不足、实验设计缺陷 |\n| P2 | 一般问题 | 文档完整性缺失 |\n| P3 | 轻微问题 | 格式规范问题 |\n\n资料来源：[library/sub-agent-samples/README.md:30-35](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### pm-skill-auditor\n\n`pm-skill-auditor` 负责审计技能定义的健康状态，确保技能定义的完整性和文件系统的一致性。\n\n**检测类型：**\n\n- **上下文漂移检测**：CONTEXT.md 声明与文件系统实际状态不匹配\n- **孤岛检测**：存在命令但无对应技能定义，或存在技能定义但无对应命令\n- **预发布审计**：在发布周期中期进行前瞻性检查\n\n### pm-changelog-curator\n\n`pm-changelog-curator` 根据提交记录自动生成符合规范的变更日志。\n\n**输出格式遵循语义化版本规范：**\n\n- Added：新功能\n- Changed：功能变更\n- Fixed：问题修复\n- Security：安全更新\n- Known Limitations：已知限制\n\n资料来源：[library/sub-agent-samples/README.md:45-50](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### pm-release-conductor\n\n`pm-release-conductor` 协调多阶段发布流程，执行门控验证（Gate）并管理失败恢复。\n\n**门控层级：**\n\n| 门控级别 | 验证内容 | 失败策略 |\n|---|---|---|\n| G0 | 聚合计数器校验 | 失败后维护者介入恢复 |\n| G1 | 基础构建验证 | 自动重试 |\n| G2 | 变更日志完整性 | 需人工审批 |\n| G2.5 | 跨代理协同验证 | 条件性通过 |\n\n资料来源：[library/sub-agent-samples/README.md:55-60](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 示例样本规范\n\n每个子代理的示例样本（Sample）遵循统一的文档结构：\n\n```yaml\n# Frontmatter 元数据\ntitle: 样本标题\ndescription: 场景描述\nartifact: 子代理输出类型\nversion: 版本号\nrepo_version: 仓库版本\nagent_version: 代理版本\ncreated: 创建日期\nstatus: sample\nthread: 叙事线程\ncontext: 上下文信息\n```\n\n**文档结构：**\n\n1. **Scenario 部分**：描述触发子代理调用的具体场景\n2. **Output 部分**：子代理的实际输出结果\n3. **Notes 部分**：说明样本演示的内容及其在 3-线程目录中的定位\n\n资料来源：[library/sub-agent-samples/README.md:65-75](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 内容配置与集成\n\n子代理系统通过 Astro 内容配置与文档站点深度集成：\n\n```typescript\n// src/content.config.ts\nschema: docsSchema({\n extend: z.object({\n // 样本特定字段 (W7)\n artifact: z.string().optional(),\n repo_version: z.string().or(z.number()).optional(),\n skill_version: z.string().or(z.number()).optional(),\n created: z.string().or(z.date()).optional(),\n status: z.string().optional(),\n thread: z.string().optional(),\n context: z.string().optional(),\n }),\n})\n```\n\n**样本文件加载规则：**\n\n- 匹配模式：`library/skill-output-samples/**/sample_*.md`\n- 排除模式：\n - `sample_*_legacy_*.md`：历史遗留样本\n - `sample_*_orbit_*.md`：Orbit 线程样本\n\n资料来源：[src/content.config.ts:1-70](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 依赖关系\n\n子代理系统基于以下技术栈构建：\n\n| 依赖项 | 版本 | 用途 |\n|---|---|---|\n| Astro | ^6.3.0 | 文档框架 |\n| @astrojs/starlight | ~0.39.0 | 文档主题 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表渲染 |\n| mermaid | ^11.15.0 | 图表生成 |\n| sharp | ^0.34.5 | 图像处理 |\n\n资料来源：[package.json:1-25](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 样式定制\n\n子代理输出文档中的 Mermaid 图表使用自定义样式：\n\n```css\n/* Mermaid SVG polish */\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n资料来源：[src/styles/custom.css:1-35](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n\n## 子代理调用流程\n\n子代理通过标准化的调用模式与外部 AI 代理（Copilot、Cursor、Windsurf 等）集成：\n\n```mermaid\ngraph LR\n A[外部 AI 代理] -->|调用| B[pm-skills 子代理]\n B -->|审查/审计/生成| C[标准化输出]\n C --> D[用户文档]\n \n E[技能定义] -->|被审计| B\n F[提交记录] -->|被分析| B\n G[产品文档] -->|被审查| B\n```\n\n## 相关文档路径\n\n| 文档类型 | 路径 |\n|---|---|\n| 概念文档 | `docs/concepts/sub-agents.md` |\n| 运行时组件参考 | `docs/reference/runtime-components.md` |\n| 子代理兼容性矩阵 | `docs/reference/sub-agent-compatibility.md` |\n| 子代理定义 | `agents/` |\n| 示例样本库 | `library/sub-agent-samples/` |\n\n资料来源：[_workflows/README.md:1-20](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n---\n\n\n\n## 工作流系统\n\n### 相关页面\n\n相关主题：[子代理系统](#sub-agents), [工具家族](#tool-families)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [docs/workflows/index.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/workflows/index.md)\n- [docs/guides/using-workflows.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-workflows.md)\n- [docs/guides/workflows-guide.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/workflows-guide.md)\n- [_workflows/feature-kickoff.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/feature-kickoff.md)\n- [_workflows/sprint-planning.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/sprint-planning.md)\n- [_workflows/product-strategy.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/product-strategy.md)\n \n\n# 工作流系统\n\n## 概述\n\n工作流系统（Workflows）是 pm-skills 项目中用于定义产品管理（Product Management）流程的核心组件。它通过多技能引导序列（multi-skill workflow）为常见的产品管理流程提供结构化的指导路径。\n\n每个工作流由 `.md` 文件定义，包含一系列产品管理技能的编排，指导用户完成特定的产品管理任务。资料来源：[_workflows/README.md:1-10]()\n\n## 架构设计\n\n### 双目录结构\n\npm-skills 采用源目录与生成目录分离的架构：\n\n```mermaid\ngraph LR\n A[\"_workflows/
(源目录)\"] -->|generate-workflow-pages.py| B[\"docs/workflows/
(生成目录)\"]\n A -->|直接使用| C[\"AI Agents
(Copilot/Cursor/Windsurf)\"]\n```\n\n| 目录 | 用途 | 可编辑性 |\n|------|------|----------|\n| `_workflows/` | 工作流定义源文件 | 可直接编辑 |\n| `docs/workflows/` | 生成的文档站点 | 自动生成，不可手动编辑 |\n\n资料来源：[_workflows/README.md:13-17]()\n\n### 链接约定\n\n工作流文件使用**仓库相对路径**（repo-relative paths）来引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n这种设计使工作流文件能够被 AI 代理（Copilot、Cursor、Windsurf）和仓库浏览器直接使用。资料来源：[_workflows/README.md:7-10]()\n\n## 工作流类型\n\n### 预定义工作流\n\n| 工作流 | 描述 | 源文件 |\n|--------|------|--------|\n| Feature Kickoff | 功能启动流程 | [`_workflows/feature-kickoff.md`](_workflows/feature-kickoff.md) |\n| Sprint Planning | 冲刺规划流程 | [`_workflows/sprint-planning.md`](_workflows/sprint-planning.md) |\n| Product Strategy | 产品战略流程 | [`_workflows/product-strategy.md`](_workflows/product-strategy.md) |\n\n### 工作流结构\n\n每个工作流文件遵循统一的结构：\n\n```mermaid\ngraph TD\n A[\"工作流文件\"] --> B[\"元数据 (Frontmatter)\"]\n A --> C[\"技能序列\"]\n A --> D[\"步骤说明\"]\n B -->|title| E[\"工作流名称\"]\n B -->|description| F[\"工作流描述\"]\n C --> G[\"技能1\"]\n C --> H[\"技能2\"]\n C --> I[\"技能N\"]\n```\n\n## 生成机制\n\n### 生成脚本\n\n工作流文档从 `_workflows/` 目录生成到 `docs/workflows/` 目录，使用专用脚本：\n\n```bash\nscripts/generate-workflow-pages.py\n```\n\n**编辑规则：**\n- 直接编辑 `_workflows/` 中的工作流内容\n- **不要**直接编辑 `docs/workflows/` 中的文件\n- 这些文件由生成脚本自动更新\n\n资料来源：[_workflows/README.md:13-17]()\n\n### 生成配置\n\n在 `src/content.config.ts` 中，工作流文件被纳入 Astro 内容集合：\n\n```typescript\npattern: [\n 'docs/**/*.{md,mdx}',\n 'library/skill-output-samples/**/sample_*.md',\n // ...\n]\n```\n\n资料来源：[src/content.config.ts:7-16]()\n\n## 工作流与子代理系统\n\n### 子代理类型\n\n工作流系统与子代理（Sub-agents）系统协同工作：\n\n| 子代理 | 功能 | 与工作流的关系 |\n|--------|------|----------------|\n| `pm-critic` | 对抗性审查 | 工作流产出的评审 |\n| `pm-skill-auditor` | 技能审计 | 工作流合规性检查 |\n| `pm-changelog-curator` | 变更日志整理 | 发布流程的一部分 |\n| `pm-release-conductor` | 发布编排 | 工作流执行协调 |\n\n资料来源：[library/sub-agent-samples/README.md:1-20]()\n\n### 执行流程\n\n```mermaid\nsequenceDiagram\n participant U as 用户\n participant W as 工作流\n participant S as 子代理\n participant A as AI Agent\n \n U->>W: 选择工作流\n W->>A: 加载技能序列\n A->>S: 调用子代理\n S->>A: 返回结果\n A->>U: 展示结果\n```\n\n## 使用指南\n\n### 编辑工作流\n\n1. 打开 `_workflows/` 目录下的目标工作流文件\n2. 编辑工作流内容和技能序列\n3. 提交更改\n4. 生成脚本自动更新 `docs/workflows/` 目录\n\n### 在 AI 代理中使用\n\n工作流文件可直接被 AI 代理使用：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n引用技能时使用仓库相对路径，确保代理能够正确定位技能文件。\n\n资料来源：[docs/guides/using-workflows.md]()\n\n### 工作流最佳实践\n\n- 保持工作流文件简洁明了\n- 使用一致的技能引用格式\n- 在技能序列中包含清晰的步骤说明\n- 定期审计工作流与实际流程的匹配度\n\n## 相关资源\n\n| 资源 | 路径 | 描述 |\n|------|------|------|\n| 工作流索引 | `docs/workflows/index.md` | 所有工作流的入口页面 |\n| 使用指南 | `docs/guides/using-workflows.md` | 详细的使用说明 |\n| 工作流指南 | `docs/guides/workflows-guide.md` | 工作流系统完整指南 |\n| 技能系统 | `skills/` | 工作流引用的技能定义 |\n| 子代理库 | `library/sub-agent-samples/` | 子代理输出示例 |\n\n---\n\n\n\n## 工具家族\n\n### 相关页面\n\n相关主题：[工作流系统](#workflows), [技能分类体系](#skill-categories)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [docs/concepts/foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/foundation-sprint.md)\n- [docs/concepts/design-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/design-sprint.md)\n- [docs/guides/using-foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-foundation-sprint.md)\n- [docs/guides/using-design-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-design-sprint.md)\n- [docs/reference/workshop-method-comparison.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/workshop-method-comparison.md)\n \n\n# 工具家族\n\n工具家族（Tool Family）是 pm-skills 项目中用于组织和管理产品管理（PM）相关技能的层次化分类体系。该体系通过结构化的方法论框架，将不同的产品管理工作流、技能模板和子代理整合为统一的工具体系。\n\n## 概述\n\npm-skills 的工具家族包含多个核心工具，每个工具对应一个独立的产品管理方法论或工作流程。这些工具被设计为可组合、可扩展的模块，支持从需求发现到产品发布的完整生命周期管理。\n\n### 工具家族的核心组成\n\n| 工具名称 | 类型 | 主要用途 |\n|---------|------|---------|\n| Foundation Sprint | 概念工具 | 需求发现与问题定义 |\n| Design Sprint | 概念工具 | 快速原型与方案验证 |\n| PM 子代理 | 执行代理 | 自动化评审与审查 |\n| 工作流编排 | 流程工具 | 多工具协同作业 |\n\n资料来源：[docs/concepts/foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/foundation-sprint.md)\n\n## 核心工具详解\n\n### Foundation Sprint\n\nFoundation Sprint 是一个结构化的需求发现框架，用于在项目初期明确问题和目标。它强调从用户痛点出发，通过系统化的方法论建立产品基础。\n\n**核心阶段：**\n\n1. **问题发现** - 识别并定义核心用户问题\n2. **假设构建** - 形成可验证的产品假设\n3. **边界明确** - 界定解决方案的范围和约束\n\n资料来源：[docs/guides/using-foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-foundation-sprint.md)\n\n### Design Sprint\n\nDesign Sprint 是一个高强度的时间boxed工作坊方法，通常在5天内完成从问题理解到可测试原型的完整流程。\n\n**标准流程：**\n\n```mermaid\ngraph TD\n A[理解问题
Day 1] --> B[发散方案
Day 2]\n B --> C[决策选择
Day 3]\n C --> D[原型制作
Day 4]\n D --> E[用户测试
Day 5]\n```\n\n资料来源：[docs/concepts/design-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/design-sprint.md)\n\n## 工具编排与工作流\n\n工具家族支持多种编排模式，允许不同工具之间协同工作以完成复杂的产品管理任务。\n\n### 工作流类型\n\npm-skills 定义了标准化的多工具工作流，通过预定义的 `.md` 文件描述引导序列。\n\n**链接约定：**\n\n工作流文件使用仓库相对路径引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n资料来源：[_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 工作流生成机制\n\n工作流内容在 `_workflows/` 目录中编辑和维护，通过 `scripts/generate-workflow-pages.py` 脚本自动生成到 `docs/workflows/` 目录。\n\n```mermaid\ngraph LR\n A[_workflows/*.md] -->|生成脚本| B[docs/workflows/]\n B --> C[静态站点]\n```\n\n## 子代理体系\n\n工具家族包含一组专门的 PM 子代理，每个子代理负责特定的分析或执行任务。\n\n### 子代理类型\n\n| 子代理 | 功能 | 输出类型 |\n|-------|------|---------|\n| pm-critic | 对抗性评审 | 问题分级报告 |\n| pm-skill-auditor | 技能审计 | 审计发现清单 |\n| pm-changelog-curator | 变更日志整理 | 格式化的变更条目 |\n| pm-release-conductor | 发布流程控制 | 门控状态信封 |\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### 子代理样本模式\n\n每个子代理样本包含标准化的元数据结构：\n\n- **Frontmatter 字段：** title、description、artifact、version、created、status、thread、context\n- **场景部分：** 触发子代理调用的具体情况\n- **输出部分：** 实际的子代理输出（分级、发现、草案）\n- **注释部分：** 样本演示内容和分类说明\n\n## 叙事线程架构\n\n工具家族通过三条叙事线程覆盖不同的产品管理场景上下文。\n\n### 线程定义\n\n| 线程 | 上下文领域 | 描述 |\n|-----|-----------|------|\n| Brainshelf | 消费者 PKM 应用 | 个人知识管理场景 |\n| Storevine | B2B 营销分析平台 | 数据产品分析场景 |\n| Workbench | 内部平台工具团队 | 平台/DX 产品场景 |\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 方法论对比\n\n工具家族中的不同工具适用于不同的场景和目标。选择合适的方法论对于有效的产品管理至关重要。\n\n### Workshop 方法对比\n\n| 方法 | 目标 | 时长 | 输出物 |\n|-----|------|------|--------|\n| Foundation Sprint | 问题定义与假设构建 | 1-2 周 | 需求文档、假设列表 |\n| Design Sprint | 原型验证与方案选择 | 5 天 | 可测试原型、验证结论 |\n| 敏捷冲刺 | 增量交付与迭代 | 2-4 周 | 可部署功能 |\n\n资料来源：[docs/reference/workshop-method-comparison.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/workshop-method-comparison.md)\n\n## 技术架构\n\n### 文档生成架构\n\n工具家族的内容通过 Astro Starlight 框架进行管理和发布。\n\n```mermaid\ngraph TD\n A[源文件
docs/, library/] --> B[内容配置
src/content.config.ts]\n B --> C[Starlight 加载器]\n C --> D[静态站点生成]\n D --> E[用户文档站点]\n```\n\n### 内容集合配置\n\n内容集合使用 Astro 的 glob 加载器，支持以下模式：\n\n```typescript\npattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md'\n]\n```\n\n资料来源：[src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### 自定义字段扩展\n\nSchema 扩展包含以下 pm-skills 特定字段：\n\n| 字段 | 类型 | 用途 |\n|-----|------|------|\n| generated | boolean | 标记自动生成内容 |\n| source | string | 原始来源引用 |\n| phase | string | 生命周期阶段 |\n| classification | string | 内容分类 |\n| version | string/number | 版本标识 |\n\n## 使用指南\n\n### 选择合适的工具\n\n1. **明确目标** - 确定当前的产品管理目标\n2. **评估场景** - 匹配目标与工具能力\n3. **组合使用** - 必要时组合多个工具\n\n### 工具集成模式\n\n工具家族支持三种主要集成模式：\n\n**独立使用：**\n单个工具独立解决特定问题，适用于局部优化。\n\n**串联工作：**\n多个工具按顺序使用，形成完整的流程链条。\n\n**并行协作：**\n多个工具同时运行，处理不同的分析维度。\n\n## 最佳实践\n\n- 优先使用结构化的工作流定义文档\n- 子代理输出遵循统一的 P0/P1/P2/P3 问题分级标准\n- 保持叙事线程的一致性，确保上下文连贯\n- 定期审计工具家族的使用效果\n\n## 扩展工具家族\n\n添加新工具到家族中需要：\n\n1. 在 `skills/` 目录创建工具定义\n2. 实现标准化的 SKILL.md 模板\n3. 添加样本输出到 `library/skill-output-samples/`\n4. 更新工作流文档以包含新工具\n\n---\n\n\n\n## 安装与平台配置\n\n### 相关页面\n\n相关主题：[项目介绍](#project-introduction), [样本输出库](#sample-outputs)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n> **注意**：以下文件在仓库中存在但本次检索未返回实际内容，页面基于现有上下文推理：\n> - `docs/getting-started/index.md`\n> - `docs/getting-started/quickstart.md`\n> - `docs/getting-started/platforms.md`\n> - `scripts/sync-claude.md`\n> - `.claude-plugin/plugin.json`\n\n \n\n# 安装与平台配置\n\n## 概述\n\npm-skills 是一个基于 Astro Starlight 框架构建的产品管理技能文档站点，旨在为产品经理提供系统化的技能、工作流和子代理（sub-agent）指导。 资料来源：[package.json:5-8]()\n\n项目采用现代化前端技术栈，通过 Markdown 文件驱动的文档系统，支持 Mermaid 图表渲染，并集成了 AI 代理（Codex、Claude 等）的协作工作区。 资料来源：[src/content.config.ts:1-4]()\n\n## 环境要求\n\n### 系统依赖\n\n| 组件 | 最低版本 | 说明 |\n|------|----------|------|\n| Node.js | >= 22.12.0 | 必须使用 LTS 或更新版本 |\n| npm/yarn/pnpm | 最新稳定版 | 用于包管理 |\n\n> 项目 `package.json` 中明确指定了 Node.js 引擎要求，低于 22.12.0 的版本将无法正常运行构建脚本。 资料来源：[package.json:7-10]()\n\n### 核心依赖包\n\n| 包名 | 版本 | 用途 |\n|------|------|------|\n| astro | ^6.3.0 | 文档站点框架 |\n| @astrojs/starlight | ~0.39.0 | Starlight 文档主题 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表集成 |\n| sharp | ^0.34.5 | 图片处理优化 |\n\n资料来源：[package.json:13-20]()\n\n## 安装步骤\n\n### 1. 克隆仓库\n\n```bash\ngit clone https://github.com/product-on-purpose/pm-skills.git\ncd pm-skills\n```\n\n### 2. 安装依赖\n\n```bash\nnpm install\n```\n\n该命令会根据 `package.json` 中的依赖声明自动安装所有必要的包。\n\n### 3. 开发模式启动\n\n```bash\nnpm run dev\n```\n\n启动后访问 `http://localhost:4321` 查看本地文档站点。开发模式支持热重载，文档修改后页面会自动刷新。\n\n### 4. 构建生产版本\n\n```bash\nnpm run build\n```\n\n构建过程包含两个步骤：\n\n1. `astro build` - 生成静态站点\n2. `node scripts/post-build-strip-md-links.mjs` - 移除 Markdown 链接的后处理脚本\n\n资料来源：[package.json:11-15]()\n\n### 5. 预览构建结果\n\n```bash\nnpm run preview\n```\n\n## 平台配置\n\n### 文档内容配置\n\npm-skills 使用 Astro 的内容集合（Content Collections）系统管理文档。核心配置位于 `src/content.config.ts`。 资料来源：[src/content.config.ts:1-6]()\n\n#### 内容集合架构\n\n```mermaid\ngraph TD\n A[docs/ 目录] --> B[Markdown/MDX 文件]\n A --> C[library/skill-output-samples/]\n B --> D[skills/ 技能定义]\n B --> E[guides/ 使用指南]\n B --> F[workflows/ 工作流]\n B --> G[reference/ 参考文档]\n C --> H[sample_*.md 示例输出]\n D --> I[define-hypothesis/]\n D --> J[utility-pm-*/]\n```\n\n#### 内容加载规则\n\n`content.config.ts` 中定义的内容加载器使用 glob 模式匹配，支持以下文件包含和排除逻辑： 资料来源：[src/content.config.ts:35-43]()\n\n| 模式类型 | 路径模式 | 说明 |\n|----------|----------|------|\n| 包含 | `docs/**/*.{md,mdx}` | 文档目录下的所有 Markdown 文件 |\n| 排除 | `!docs/internal/**` | 内部工作文件（gitignored） |\n| 排除 | `!docs/templates/**` | 模板目录 |\n| 排除 | `!docs/**/README.md` | 目录级 README 文件 |\n| 包含 | `library/skill-output-samples/**/sample_*.md` | 技能输出示例 |\n| 排除 | `!library/skill-output-samples/**/sample_*_legacy_*.md` | 历史遗留示例 |\n| 排除 | `!library/skill-output-samples/**/sample_*_orbit_*.md` | Orbit 相关示例 |\n\n#### 自定义 Slug 生成\n\n系统采用自定义 ID 生成策略，将不同路径的前缀统一处理为干净的 slug： 资料来源：[src/content.config.ts:45-57]()\n\n| 原始路径 | 生成 Slug |\n|----------|-----------|\n| `docs/foo/bar.md` | `foo/bar` |\n| `docs/skills/index.md` | `skills` |\n| `library/skill-output-samples/define-hypothesis/sample_X.md` | `samples/define-hypothesis/sample_X` |\n| `docs/section/README.md` | `section/readme` |\n\n### 自定义字段模式\n\n内容集合扩展了 Starlight 的 `docsSchema`，支持以下 pm-skills 专用字段： 资料来源：[src/content.config.ts:63-82]()\n\n| 字段名 | 类型 | 说明 |\n|--------|------|------|\n| `generated` | boolean | 标记是否为自动生成内容 |\n| `source` | string | 原始来源路径 |\n| `phase` | string | 开发阶段 |\n| `classification` | string | 分类标签 |\n| `version` | string \\| number | 版本号（支持 semver 格式） |\n| `updated` | string \\| Date | 更新时间 |\n| `artifact` | string | 子代理输出类型 |\n| `repo_version` | string \\| number | 仓库版本 |\n| `created` | string \\| Date | 创建时间 |\n| `status` | string | 状态标记 |\n| `thread` | string | 叙事线程（brainshelf/storevine/workbench） |\n| `context` | string | 上下文描述 |\n\n### Mermaid 图表配置\n\n项目在 `src/styles/custom.css` 中为 Mermaid 图表定义了统一的视觉风格： 资料来源：[src/styles/custom.css:1-32]()\n\n#### 样式规则\n\n```css\n/* 图表容器 */\n.mermaid {\n max-width: 100%;\n}\n\n/* SVG 自适应 */\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n\n/* 连线样式 */\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n\n/* 节点圆角 */\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n\n/* 集群背景透明度 */\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n这些样式在浅色和深色模式下均生效，覆盖所有图表类型（流程图、序列图、甘特图等）。\n\n## AI 代理集成\n\n### Codex 工作区策略\n\n仓库为 Codex AI 代理维护了一个专用工作区 `_agent-context/codex/`，其中包含以下策略文件： 资料来源：[_agent-context/codex/README.md:1-8]()\n\n| 文件 | 用途 |\n|------|------|\n| `CONTEXT.md` | 稳定的当前状态事实 |\n| `DECISIONS.md` | 已接受的决策及理由 |\n| `WRAP-SESSION_TEMPLATE.md` | 交接模板 |\n| `WORKTREE-PRIMER.md` | 干净分支工作流指南 |\n\n### 本地忽略文件\n\n以下文件类型被 Git 忽略，仅在本地保留： 资料来源：[_agent-context/codex/README.md:11-13]()\n\n- `PLANNING/**` - 探索性规划草稿\n- `TODO.md` - 临时任务\n- `AGENTS/SESSION-LOG/` - 会话日志目录\n\n### 会话日志规范\n\n会话交接文件按以下命名规范存储： 资料来源：[_agent-context/codex/README.md:19-21]()\n\n```\nAGENTS/SESSION-LOG/YYYY-MM-DD[_HH-MM]_codex_.md\n```\n\n文件名中包含模型名称（`_codex_`），使 Claude 和 Codex 的会话可以在同一目录下按日期共存。\n\n## 工作流与技能系统\n\n### 工作流定义\n\n工作流文件位于 `_workflows/` 目录，每个 `.md` 文件定义一个多技能工作流，指导用户完成常见的产品管理流程。 资料来源：[_workflows/README.md:1-8]()\n\n#### 链接约定\n\n工作流文件使用仓库相对路径引用技能： 资料来源：[_workflows/README.md:10-13]()\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n此约定确保 AI 代理（Copilot、Cursor、Windsurf 等）和仓库浏览器可以直接使用这些链接。\n\n#### 编辑策略\n\n- 在 `_workflows/` 目录编辑工作流内容\n- **不要**直接编辑 `docs/workflows/` 目录\n- `docs/workflows/` 文件由 `scripts/generate-workflow-pages.py` 脚本从源目录自动生成\n\n### 子代理库\n\n`library/sub-agent-samples/` 目录包含每个 pm-skills 子代理的真实输出示例： 资料来源：[library/sub-agent-samples/README.md:1-12]()\n\n| 子代理 | 功能 |\n|--------|------|\n| `pm-critic` | 对 PRD、OKR、会议纪要进行对抗性审查 |\n| `pm-skill-auditor` | 审计技能定义的完整性和一致性 |\n| `pm-changelog-curator` | 生成符合规范的变更日志草稿 |\n| `pm-release-conductor` | 编排发布流程的门控检查 |\n\n#### 叙事线程\n\n示例覆盖三个叙事场景： 资料来源：[library/sub-agent-samples/README.md:92-101]()\n\n| 线程 | 场景 | 上下文 |\n|------|------|--------|\n| **Brainshelf** | 消费者 PKM 应用 | 产品经理的消费品视角 |\n| **Storevine** | B2B 营销分析平台 | 数据产品的 PM 视角 |\n| **Workbench** | 内部平台工具团队 | 平台/DX 的 PM 视角 |\n\n## 常见问题排查\n\n### 节点版本不匹配\n\n如果遇到构建错误，首先检查 Node.js 版本：\n\n```bash\nnode --version\n```\n\n确保版本 >= 22.12.0。\n\n### 内容未出现在站点\n\n检查 `src/content.config.ts` 中的 glob 模式是否正确匹配目标文件，确保文件不在排除列表中。\n\n### Mermaid 图表不渲染\n\n确保 `astro-mermaid` 依赖已正确安装，且 Mermaid 语法符合规范。样式问题可参考 `src/styles/custom.css` 中的自定义规则。\n\n---\n\n\n\n## 样本输出库\n\n### 相关页面\n\n相关主题：[技能结构解析](#skill-anatomy), [安装与平台配置](#installation-guide)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [library/skill-output-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/skill-output-samples/README.md)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n \n\n# 样本输出库\n\n样本输出库（Skill Output Samples Library）是 pm-skills 项目中用于存储、分类和展示子代理（sub-agent）实际输出的标准化示例集合。该库为项目维护者、AI 代理和人类审查者提供了可验证的参考基准，确保子代理在不同场景下的行为符合预期规范。\n\n## 设计目标与核心价值\n\n样本输出库的核心价值体现在以下几个方面：\n\n1. **行为验证**：通过真实输出样本验证子代理的批评、审计、变更日志生成和发布流程控制等能力\n2. **规范参照**：为 AI 代理（Copilot、Cursor、Windsurf）提供可学习的标准输出模式\n3. **回归测试**：在代码变更后可通过对比样本输出检测行为漂移\n4. **文档支撑**：为用户指南和贡献者文档提供具体案例\n\n资料来源：[library/sub-agent-samples/README.md:1-15]()\n\n## 目录结构\n\n样本输出库采用分层目录结构，按子代理类型和叙事线程进行双重分类：\n\n```\nlibrary/sub-agent-samples/\n├── pm-critic/\n│ ├── sample_pm-critic_brainshelf_prd-review.md\n│ ├── sample_pm-critic_storevine_okr-review.md\n│ └── sample_pm-critic_workbench_meeting-recap-review.md\n├── pm-skill-auditor/\n│ ├── sample_pm-skill-auditor_brainshelf_pre-release.md\n│ ├── sample_pm-skill-auditor_storevine_drift-detection.md\n│ └── sample_pm-skill-auditor_workbench_cross-cutting.md\n├── pm-changelog-curator/\n│ ├── sample_pm-changelog-curator_brainshelf_minor-release.md\n│ ├── sample_pm-changelog-curator_storevine_patch-release.md\n│ └── sample_pm-changelog-curator_workbench_feature-release.md\n└── pm-release-conductor/\n ├── sample_pm-release-conductor_brainshelf_clean-run.md\n ├── sample_pm-release-conductor_storevine_gate-failure.md\n └── sample_pm-release-conductor_workbench_chained-run.md\n```\n\n资料来源：[library/sub-agent-samples/README.md:18-33]()\n\n## 子代理类型\n\npm-skills 项目定义了四个核心子代理，每个子代理产生特定类型的输出样本：\n\n| 子代理名称 | 功能描述 | 输出类型 | 样本数量 |\n|---|---|---|---|\n| `pm-critic` | 对 PRD、OKR、会议决策等进行对抗性评审 | 分级评审报告（P0-P3） | 3 |\n| `pm-skill-auditor` | 审计技能定义的完整性和一致性 | 审计发现清单 | 3 |\n| `pm-changelog-curator` | 根据提交历史生成变更日志 | 结构化变更条目 | 3 |\n| `pm-release-conductor` | 控制多阶段发布门控流程 | 门控状态信封 | 3 |\n\n资料来源：[library/sub-agent-samples/README.md:34-45]()\n\n## 叙事线程体系\n\n样本输出库采用三个叙事线程（Thread）作为场景化背景，确保样本输出覆盖不同产品管理上下文：\n\n### Brainshelf - 消费级 PKM 应用\n\n个人知识管理（PKM）应用场景，捕获消费者产品管理上下文。典型问题域包括：\n- 文档完整性验证\n- 假设定义与验证\n- 竞品分析\n\n资料来源：[library/sub-agent-samples/README.md:118-120]()\n\n### Storevine - B2B 营销分析平台\n\nB2B 营销分析平台场景，捕获数据分析与数据产品管理上下文。典型问题域包括：\n- OKR 设置与评审\n- 聚合计数器管理\n- 上下文漂移检测\n\n资料来源：[library/sub-agent-samples/README.md:122-124]()\n\n### Workbench - 内部平台工具团队\n\n内部平台与开发者体验（DX）管理上下文。典型问题域包括：\n- 会议决策追踪\n- 跨切面技能审计\n- 链式发布编排\n\n资料来源：[library/sub-agent-samples/README.md:126-128]()\n\n## 样本文件结构\n\n每个样本文件采用标准化 YAML frontmatter 元数据格式：\n\n```yaml\n---\ntitle: <样本标题>\ndescription: <样本描述>\nartifact: <子代理输出类型>\nversion: <版本号>\nrepo_version: <仓库版本>\nagent_version: <代理版本>\ncreated: <创建日期>\nstatus: sample\nthread: <叙事线程>\ncontext: <场景上下文>\n---\n```\n\n关键字段说明：\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `title` | string | 样本的人类可读标题 |\n| `artifact` | string | 子代理输出类型（如 grading-report、audit-findings） |\n| `thread` | string | 叙事线程标识（brainshelf/storevine/workbench） |\n| `status` | string | 固定值 `sample`，标识文件类型 |\n| `created` | string/date | ISO 格式日期，YAML 可能解析为 Date 对象 |\n\n资料来源：[library/sub-agent-samples/README.md:54-68]()\n\n## 问题严重性分级\n\n样本输出遵循统一的 P0-P3 问题严重性分级体系：\n\n| 级别 | 名称 | 说明 | 典型示例 |\n|---|---|---|---|\n| P0 | 关键 | 必须立即修复，如合同违规、拒绝协议失效 | 伪造基线数据、关键决策缺失所有者 |\n| P1 | 重要 | 应在当前周期内修复 | 前瞻性审计发现、实验设计缺陷 |\n| P2 | 中等 | 应在合理周期内修复 | 预期漂移、可验证性不足 |\n| P3 | 低 | 建议改进 | 文档清晰度、格式一致性 |\n\n资料来源：[library/sub-agent-samples/README.md:34-50]()\n\n## 工作流程\n\n样本从创建到发布的完整工作流程如下：\n\n```mermaid\ngraph TD\n A[场景定义] --> B[子代理执行]\n B --> C[输出捕获]\n C --> D[前端元数据标注]\n D --> E[样本文件写入]\n E --> F[内容配置加载]\n F --> G[文档站点发布]\n \n H[维护者审查] --> I{命名规范检查}\n I -->|通过| E\n I -->|失败| J[重命名排除]\n \n J --> K[保留磁盘历史]\n K -.-> L[不发布到站点]\n```\n\n### 样本命名约定\n\n样本文件名遵循严格的命名模式：\n\n```\nsample___.md\n```\n\n示例：\n- `sample_pm-critic_brainshelf_prd-review.md`\n- `sample_pm-release-conductor_workbench_chained-run.md`\n\n不符合命名模式的文件将被内容配置排除，不发布到文档站点，但保留在磁盘上供历史参考。\n\n资料来源：[src/content.config.ts:25-30]()\n\n## 内容配置集成\n\n样本输出库通过 Astro 内容加载器与文档站点深度集成。配置位于 `src/content.config.ts`：\n\n```typescript\nloader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md',\n '!library/skill-output-samples/**/sample_*_legacy_*.md',\n '!library/skill-output-samples/**/sample_*_orbit_*.md',\n ],\n base: '.',\n})\n```\n\n### 排除规则\n\n以下文件被排除在站点发布之外：\n\n| 排除模式 | 原因 |\n|---|---|\n| `sample_*_legacy_*.md` | 历史遗留样本（9个），保留磁盘记录 |\n| `sample_*_orbit_*.md` | Orbit 线程样本（2个），保留磁盘记录 |\n| `docs/internal/**` | 发布计划和工作笔记，不对外公开 |\n| `docs/templates/**` | 使用 `` 语法导致 YAML 解析问题 |\n\n资料来源：[src/content.config.ts:18-30]()\n\n### Slug 生成规则\n\n样本文件的 URL slug 通过 `generateId` 函数自动生成：\n\n```javascript\n// library/skill-output-samples/define-hypothesis/sample_X.md\n// → slug: 'samples/define-hypothesis/sample_X'\n```\n\n| 原始路径 | 生成 Slug |\n|---|---|\n| `docs/foo/bar.md` | `foo/bar` |\n| `docs/skills/index.md` | `skills` |\n| `library/skill-output-samples/define-hypothesis/sample_X.md` | `samples/define-hypothesis/sample_X` |\n\n资料来源：[src/content.config.ts:36-45]()\n\n## 示例场景说明\n\n### PRD 对抗性评审\n\n`pm-critic` 子代理对 Brainshelf 应用的产品需求文档进行评审，输出包含：\n- 1 个 P0 合同完整性问题\n- 3 个 P1 可证伪性设计缺陷\n- 2 个 P2 实验设计问题\n- 1 个 P3 文档清晰度建议\n\n资料来源：[library/sub-agent-samples/README.md:35-36]()\n\n### 发布门控流程\n\n`pm-release-conductor` 子代理在 Workbench 项目中执行链式干运行：\n- 审计门控 G0 和 G2.5 阶段\n- 变更日志门控 G2 阶段\n- 分层 Status 信封输出\n\n资料来源：[library/sub-agent-samples/README.md:48-49]()\n\n## 扩展前端字段\n\n样本文件支持额外的 YAML 前端字段，由 Astro schema 定义：\n\n```typescript\nschema: docsSchema({\n extend: z.object({\n generated: z.boolean().optional(),\n source: z.string().optional(),\n phase: z.string().optional(),\n classification: z.string().optional(),\n artifact: z.string().optional(),\n repo_version: z.string().or(z.number()).optional(),\n skill_version: z.string().or(z.number()).optional(),\n created: z.string().or(z.date()).optional(),\n status: z.string().optional(),\n thread: z.string().optional(),\n context: z.string().optional(),\n tags: z.array(z.string()).optional(),\n draft: z.boolean().optional(),\n }),\n})\n```\n\n这些字段支持：\n- `generated`: 标记自动生成的内容\n- `source`: 溯源引用\n- `phase`: 处理阶段\n- `tags`: 分类标签\n\n资料来源：[src/content.config.ts:56-77]()\n\n## 技术栈依赖\n\n样本输出库的展示依赖于以下技术组件：\n\n| 组件 | 版本 | 用途 |\n|---|---|---|\n| Astro | ^6.3.0 | 静态站点生成框架 |\n| @astrojs/starlight | ~0.39.0 | 文档主题系统 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表渲染 |\n| mermaid | ^11.15.0 | 图表定义语言 |\n\n资料来源：[package.json:1-20]()\n\n## 维护指南\n\n### 添加新样本\n\n1. 在对应的 `library/sub-agent-samples//` 目录创建文件\n2. 使用 `sample___.md` 命名模式\n3. 填写标准化的 YAML frontmatter\n4. 在 `Scenario` 部分描述触发场景\n5. 在 `Output` 部分展示实际代理输出\n6. 在 `Notes` 部分说明样本的演示目的\n\n### 样本验证清单\n\n- [ ] 文件名符合命名约定\n- [ ] frontmatter 包含所有必需字段\n- [ ] P0-P3 分级与实际内容一致\n- [ ] 场景上下文与叙事线程匹配\n- [ ] 无敏感信息泄露\n\n## 相关资源\n\n- 子代理定义：[agents/](../../agents/)\n- 技能定义：[skills/](../../skills/)\n- 运行时组件：[docs/reference/runtime-components.md](../../docs/reference/runtime-components.md)\n- 对抗性评审指南：[docs/guides/adversarial-review.md](../../docs/guides/adversarial-review.md)\n- 发布手册：[docs/contributing/release-runbook.md](../../docs/contributing/release-runbook.md)\n\n资料来源：[library/sub-agent-samples/README.md:130-137]()\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：product-on-purpose/pm-skills\n\n摘要：发现 14 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `pm-skills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令: `npx skills`\n- 防护动作: 页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | repo=pm-skills; install=skills\n\n## 2. 安装坑 · 来源证据：[F-14] Workflow Builder (/workflow-builder)\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-14] Workflow Builder (/workflow-builder)\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_fd2240d9f58c49edbcc147428ff9b561 | https://github.com/product-on-purpose/pm-skills/issues/133 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：[F-15] Ad-Hoc Skill Chaining (/chain)\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-15] Ad-Hoc Skill Chaining (/chain)\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_151a0a8448c84b81b626bf03b88d2714 | https://github.com/product-on-purpose/pm-skills/issues/134 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：v2.11.1 - skills.sh CLI Compatibility Patch\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v2.11.1 - skills.sh CLI Compatibility Patch\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_55aa5dc614634b48a39a0310a9b5fd45 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 5. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作: 涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | host_targets=claude, claude_code\n\n## 6. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作: 假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | README/documentation is current enough for a first validation pass.\n\n## 7. 维护坑 · 来源证据：[M-21] Explore release-please Integration\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：[M-21] Explore release-please Integration\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_acdd9d4cd91c449f964bf1924ec0b6e1 | https://github.com/product-on-purpose/pm-skills/issues/136 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 8. 维护坑 · 来源证据：v2.12.0 OKR Skills Launch\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：v2.12.0 OKR Skills Launch\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_f2a160e56ca04946816b63eab92a85cd | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 9. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作: 维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | last_activity_observed missing\n\n## 10. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作: 下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作: 评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n\n## 12. 安全/权限坑 · 来源证据：v2.13.1\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.13.1\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e5dab862059242fd8f82b7814ef33eb8 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.13.1 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 13. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作: issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | issue_or_pr_quality=unknown\n\n## 14. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作: 发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | release_recency=unknown\n\n\n",
"markdown_key": "pm-skills",
"pages": "draft",
"source_refs": [
{
"evidence_id": "github_repo:1130952330",
"kind": "repo",
"supports_claim_ids": [
"claim_identity",
"claim_distribution",
"claim_capability"
],
"url": "https://github.com/product-on-purpose/pm-skills"
},
{
"evidence_id": "art_cd7c5da2db2d4d3db902d8b25878f1a8",
"kind": "docs",
"supports_claim_ids": [
"claim_identity",
"claim_distribution",
"claim_capability"
],
"url": "https://github.com/product-on-purpose/pm-skills#readme"
}
],
"summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
"title": "pm-skills 说明书",
"toc": [
"https://github.com/product-on-purpose/pm-skills 项目说明书",
"目录",
"项目介绍",
"概述",
"技术栈",
"核心架构",
"内容组织",
"子代理体系",
"Doramagic 踩坑日志"
]
}
},
"quality_gate": {
"blocking_gaps": [],
"category_confidence": "medium",
"compile_status": "ready_for_review",
"five_assets_present": true,
"install_sandbox_verified": true,
"missing_evidence": [],
"next_action": "publish to Doramagic.ai project surfaces",
"prompt_preview_boundary_ok": true,
"publish_status": "publishable",
"quick_start_verified": true,
"repo_clone_verified": true,
"repo_commit": "ae771c7aafef58d2a1197453c9d153ce88498822",
"repo_inspection_error": null,
"repo_inspection_files": [
"package.json",
"README.md",
"docs/changelog.md",
"docs/index.mdx",
"docs/tags.md",
"docs/skills/index.md",
"docs/skills/README.md",
"docs/reference/frontmatter-schema.yaml",
"docs/reference/mermaid-style-guide.md",
"docs/reference/index.md",
"docs/reference/runtime-components.md",
"docs/reference/project-structure.md",
"docs/reference/commands.md",
"docs/reference/sub-agent-compatibility.md",
"docs/reference/categories.md",
"docs/reference/README.md",
"docs/reference/pm-skill-anatomy.md",
"docs/reference/sprint-methodology-glossary.md",
"docs/reference/workshop-method-comparison.md",
"docs/reference/ecosystem.md",
"docs/reference/pm-skill-versioning.md",
"docs/concepts/index.md",
"docs/concepts/workshop-sprints-vs-agile-sprints.md",
"docs/concepts/agent-skill-anatomy.md",
"docs/concepts/design-sprint.md",
"docs/concepts/sprint-skills-overview.md",
"docs/concepts/sub-agents.md",
"docs/concepts/README.md",
"docs/concepts/triple-diamond-delivery-process.md",
"docs/concepts/foundation-sprint.md",
"docs/concepts/active-orchestration.md",
"docs/contributing/privacy.md",
"docs/contributing/ci-overview.md",
"docs/contributing/security.md",
"docs/contributing/index.md",
"docs/contributing/code-of-conduct.md",
"docs/contributing/README.md",
"docs/contributing/sub-agent-design-patterns.md",
"docs/contributing/release-runbook.md",
"docs/contributing/authoring-sub-agents.md"
],
"repo_inspection_verified": true,
"review_reasons": [],
"tag_count_ok": true,
"unsupported_claims": []
},
"schema_version": "0.1",
"user_assets": {
"ai_context_pack": {
"asset_id": "ai_context_pack",
"filename": "AI_CONTEXT_PACK.md",
"markdown": "# pm-skills-docs - Doramagic AI Context Pack\n\n> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。\n\n## 充分原则\n\n- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。\n- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。\n\n## 给宿主 AI 的使用方式\n\n你正在读取 Doramagic 为 pm-skills-docs 编译的 AI Context Pack。请把它当作开工前上下文：帮助用户理解适合谁、能做什么、如何开始、哪些必须安装后验证、风险在哪里。不要声称你已经安装、运行或执行了目标项目。\n\n## Claim 消费规则\n\n- **事实来源**：Repo Evidence + Claim/Evidence Graph；Human Wiki 只提供显著性、术语和叙事结构。\n- **事实最低状态**：`supported`\n- `supported`：可以作为项目事实使用，但回答中必须引用 claim_id 和证据路径。\n- `weak`：只能作为低置信度线索，必须要求用户继续核实。\n- `inferred`：只能用于风险提示或待确认问题，不能包装成项目事实。\n- `unverified`：不得作为事实使用，应明确说证据不足。\n- `contradicted`：必须展示冲突来源，不得替用户强行选择一个版本。\n\n## 它最适合谁\n\n- **正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**：README 或插件配置提到多个宿主 AI。 证据：`README.md` Claim：`clm_0004` supported 0.86\n- **希望把专业流程带进宿主 AI 的用户**：仓库包含 Skill 文档。 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`, `docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`, `docs/templates/skill-template/SKILL.md`, `skills/define-hypothesis/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n\n## 它能做什么\n\n- **AI Skill / Agent 指令资产库**（可做安装前预览）：项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`, `docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`, `docs/templates/skill-template/SKILL.md`, `skills/define-hypothesis/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**（需要安装后验证）：项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `docs/internal/release-plans/v3.0.0/marketplace-repo-skeleton/marketplace.json` Claim：`clm_0002` unverified 0.25\n- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n## 怎么开始\n\n- `/plugin marketplace add product-on-purpose/pm-skills` 证据：`README.md` Claim：`clm_0006` supported 0.86\n- `/plugin install pm-skills@pm-skills-marketplace` 证据：`README.md` Claim：`clm_0007` supported 0.86\n- `npx skills add product-on-purpose/pm-skills` 证据：`README.md` Claim：`clm_0008` supported 0.86\n- `git clone https://github.com/product-on-purpose/pm-skills.git` 证据：`README.md` Claim：`clm_0009` supported 0.86\n\n## 继续前判断卡\n\n- **当前建议**：先做研究框架试用\n- **为什么**：这个项目面向研究工作流，核心风险是资料可信度和输出质量；先用 Prompt Preview 验证研究框架，再在隔离环境试装。\n\n### 30 秒判断\n\n- **现在怎么做**：先做研究框架试用\n- **最小安全下一步**：先用 Prompt Preview 验证研究框架；满意后再隔离试装\n- **先别相信**：研究结论、引用和实验结果不能在安装前相信。\n- **继续会触碰**：研究判断、命令执行、宿主 AI 配置\n\n### 现在可以相信\n\n- **适合人群线索：正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`README.md` Claim：`clm_0004` supported 0.86\n- **适合人群线索：希望把专业流程带进宿主 AI 的用户**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`, `docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`, `docs/templates/skill-template/SKILL.md`, `skills/define-hypothesis/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n- **能力存在：AI Skill / Agent 指令资产库**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`, `docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`, `docs/templates/skill-template/SKILL.md`, `skills/define-hypothesis/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **能力存在：命令行启动或安装流程**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`README.md` Claim：`clm_0003` supported 0.86\n- **存在 Quick Start / 安装命令线索**（supported）：可以相信项目文档出现过启动或安装入口；不要因此直接在主力环境运行。 证据：`README.md` Claim：`clm_0006` supported 0.86\n\n### 现在还不能相信\n\n- **研究结论、引用和实验结果不能在安装前相信。**（unverified）：研究 Skill 可以组织问题和路径，但不能替代真实资料检索、论文核验和实验复现。\n- **是否适合你的具体研究领域不能直接相信。**（unverified）：Skill 覆盖很多研究主题，不代表对你的领域、资料要求和可信度标准足够。\n- **真实输出质量不能在安装前相信。**（unverified）：Prompt Preview 只能展示引导方式，不能证明真实项目中的结果质量。\n- **宿主 AI 版本兼容性不能在安装前相信。**（unverified）：Claude、Cursor、Codex、Gemini 等宿主加载规则和版本差异必须在真实环境验证。\n- **不会污染现有宿主 AI 行为，不能直接相信。**（inferred）：Skill、plugin、AGENTS/CLAUDE/GEMINI 指令可能改变宿主 AI 的默认行为。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `AGENTS.md`, `CLAUDE.md` 等\n- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。\n- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `docs/internal/release-plans/v3.0.0/marketplace-repo-skeleton/marketplace.json`\n- **项目输出质量是否满足用户具体任务？**（unverified）：安装前预览只能展示流程和边界，不能替代真实评测。\n\n### 继续会触碰什么\n\n- **研究判断**：问题拆解、资料路径、实验路径、结论结构和可信度判断。 原因：研究型 Skill 可能让输出看起来更专业，但不能替代真实证据核验。\n- **命令执行**：包管理器、网络下载、本地插件目录、项目配置或用户主目录。 原因：运行第一条命令就可能产生环境改动；必须先判断是否值得跑。 证据：`README.md`\n- **宿主 AI 配置**：Claude/Codex/Cursor/Gemini/OpenCode 等宿主的 plugin、Skill 或规则加载配置。 原因：宿主配置会改变 AI 后续工作方式，可能和用户已有规则冲突。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `AGENTS.md`, `CLAUDE.md` 等\n- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `README.md`, `docs/internal/release-plans/v3.0.0/marketplace-repo-skeleton/marketplace.json`\n- **宿主 AI 上下文**：AI Context Pack、Prompt Preview、Skill 路由、风险规则和项目事实。 原因：导入上下文会影响宿主 AI 后续判断，必须避免把未验证项包装成事实。\n\n### 最小安全下一步\n\n- **先跑 Prompt Preview**：先验证它能否正确界定研究问题和证据边界，不要先相信研究输出。（适用：任何项目都适用，尤其是输出质量未知时。）\n- **只在隔离目录或测试账号试装**：避免安装命令污染主力宿主 AI、真实项目或用户主目录。（适用：存在命令执行、插件配置或本地写入线索时。）\n- **先备份宿主 AI 配置**：Skill、plugin、规则文件可能改变 Claude/Cursor/Codex 的默认行为。（适用：存在插件 manifest、Skill 或宿主规则入口时。）\n- **安装后只验证一个最小任务**：先验证加载、兼容、输出质量和回滚，再决定是否深用。（适用：准备从试用进入真实工作流时。）\n\n### 退出方式\n\n- **保留安装前状态**：记录原始宿主配置和项目状态，后续才能判断是否可恢复。\n- **准备移除宿主 plugin / Skill / 规则入口**：如果试装后行为异常，可以把宿主 AI 恢复到试装前状态。\n- **保留资料和结论核验清单**：如果后续发现引用或实验路径不可靠，可以回到证据边界阶段重新校验。\n- **记录安装命令和写入路径**：没有明确卸载说明时，至少要知道哪些目录或配置需要手动清理。\n- **如果没有回滚路径，不进入主力环境**：不可回滚是继续前阻断项，不应靠信任或运气继续。\n\n## 哪些只能预览\n\n- 解释项目适合谁和能做什么\n- 基于项目文档演示典型对话流程\n- 帮助用户判断是否值得安装或继续研究\n\n## 哪些必须安装后验证\n\n- 真实安装 Skill、插件或 CLI\n- 执行脚本、修改本地文件或访问外部服务\n- 验证真实输出质量、性能和兼容性\n\n## 边界与风险判断卡\n\n- **把安装前预览误认为真实运行**：用户可能高估项目已经完成的配置、权限和兼容性验证。 处理方式：明确区分 prompt_preview_can_do 与 runtime_required。 Claim：`clm_0010` inferred 0.45\n- **宿主 AI 插件或 Skill 规则冲突**：新规则可能改变用户现有宿主 AI 的工作方式。 处理方式：安装前先检查插件 manifest 和 Skill 文件，必要时隔离测试。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `docs/internal/release-plans/v3.0.0/marketplace-repo-skeleton/marketplace.json` Claim：`clm_0011` inferred 0.45\n- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`README.md` Claim：`clm_0012` supported 0.86, `clm_0019` contradicted 0.20\n- **源文档冲突：skill_count**：项目文档中存在数量表述不一致，AI Context Pack 必须提示用户不要把单一数字当作已验证事实。 处理方式：在 Human Manual 和 AI Context Pack 中共同标记为待核实，而不是强行选择一个数字。 证据：`docs/internal/release-plans/v2.16.0/testing-summary_v2.16.0.md`, `CHANGELOG.md`, `docs/changelog.md`, `docs/internal/release-plans/v2.15.0/plan_v2.15.0.md` 等 Claim：`clm_0013` inferred 0.45\n- **源文档冲突：agent_count**：项目文档中存在数量表述不一致，AI Context Pack 必须提示用户不要把单一数字当作已验证事实。 处理方式：在 Human Manual 和 AI Context Pack 中共同标记为待核实，而不是强行选择一个数字。 证据：`docs/internal/release-plans/v2.15.0/design-sprint-integration-plan.md`, `docs/internal/efforts/M-13-convention-alignment.md`, `docs/internal/audit/2026-05-03_tooling-process.md` Claim：`clm_0014` inferred 0.45\n- **源文件冲突 skill_count**：发现多个值 `10, 11, 15, 16, 17, 18, 19, 20, 24, 25, 26, 27, 28, 29, 30, 31, 32, 35, 38, 39, 40, 45, 55, 59, 60, 63`，应在真实使用前核实。\n- **源文件冲突 agent_count**：发现多个值 `18, 115, 135`，应在真实使用前核实。\n- **待确认**：真实安装后是否与用户当前宿主 AI 版本兼容？。原因：兼容性只能通过实际宿主环境验证。\n- **待确认**：项目输出质量是否满足用户具体任务？。原因：安装前预览只能展示流程和边界，不能替代真实评测。\n- **待确认**：安装命令是否需要网络、权限或全局写入？。原因：这影响企业环境和个人环境的安装风险。\n\n## 开工前工作上下文\n\n### 加载顺序\n\n- 先读取 how_to_use.host_ai_instruction，建立安装前判断资产的边界。\n- 读取 claim_graph_summary，确认事实来自 Claim/Evidence Graph，而不是 Human Wiki 叙事。\n- 再读取 intended_users、capabilities 和 quick_start_candidates，判断用户是否匹配。\n- 需要执行具体任务时，优先查 role_skill_index，再查 evidence_index。\n- 遇到真实安装、文件修改、网络访问、性能或兼容性问题时，转入 risk_card 和 boundaries.runtime_required。\n\n### 任务路由\n\n- **AI Skill / Agent 指令资产库**：先基于 role_skill_index / evidence_index 帮用户挑选可用角色、Skill 或工作流。 边界：可做安装前 Prompt 体验。 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`, `docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`, `docs/templates/skill-template/SKILL.md`, `skills/define-hypothesis/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `docs/internal/release-plans/v3.0.0/marketplace-repo-skeleton/marketplace.json`\n- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n### 上下文规模\n\n- 文件总数：1113\n- 重要文件覆盖：40/1113\n- 证据索引条目：101\n- 角色 / Skill 条目：62\n\n### 证据不足时的处理\n\n- **missing_evidence**：说明证据不足，要求用户提供目标文件、README 段落或安装后验证记录；不要补全事实。\n- **out_of_scope_request**：说明该任务超出当前 AI Context Pack 证据范围，并建议用户先查看 Human Manual 或真实安装后验证。\n- **runtime_request**：给出安装前检查清单和命令来源，但不要替用户执行命令或声称已执行。\n- **source_conflict**：同时展示冲突来源，标记为待核实，不要强行选择一个版本。\n\n## Prompt Recipes\n\n### 适配判断\n\n- 目标：判断这个项目是否适合用户当前任务。\n- 预期输出：适配结论、关键理由、证据引用、安装前可预览内容、必须安装后验证内容、下一步建议。\n\n```text\n请基于 pm-skills-docs 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。\n```\n\n### 安装前体验\n\n- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。\n- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。\n\n```text\n请把 pm-skills-docs 当作安装前体验资产，而不是已安装工具或真实运行环境。\n\n请严格输出四段：\n1. 先问我 3 个必要问题。\n2. 给出一段“体验剧本”：用 [安装前可预览]、[必须安装后验证]、[证据不足] 三种标签展示它可能如何引导工作流。\n3. 给出安装后验证清单：列出哪些能力只有真实安装、真实宿主加载、真实项目运行后才能确认。\n4. 给出谨慎建议：只能说“值得继续研究/试装”“先补充信息后再判断”或“不建议继续”，不得替项目背书。\n\n硬性边界：\n- 不要声称已经安装、运行、执行测试、修改文件或产生真实结果。\n- 不要写“自动适配”“确保通过”“完美适配”“强烈建议安装”等承诺性表达。\n- 如果描述安装后的工作方式，必须使用“如果安装成功且宿主正确加载 Skill，它可能会……”这种条件句。\n- 体验剧本只能写成“示例台词/假设流程”：使用“可能会询问/可能会建议/可能会展示”，不要写“已写入、已生成、已通过、正在运行、正在生成”。\n- Prompt Preview 不负责给安装命令；如用户准备试装，只能提示先阅读 Quick Start 和 Risk Card，并在隔离环境验证。\n- 所有项目事实必须来自 supported claim、evidence_refs 或 source_paths；inferred/unverified 只能作风险或待确认项。\n\n```\n\n### 角色 / Skill 选择\n\n- 目标：从项目里的角色或 Skill 中挑选最匹配的资产。\n- 预期输出：候选角色或 Skill 列表，每项包含适用场景、证据路径、风险边界和是否需要安装后验证。\n\n```text\n请读取 role_skill_index，根据我的目标任务推荐 3-5 个最相关的角色或 Skill。每个推荐都要说明适用场景、可能输出、风险边界和 evidence_refs。\n```\n\n### 风险预检\n\n- 目标：安装或引入前识别环境、权限、规则冲突和质量风险。\n- 预期输出：环境、权限、依赖、许可、宿主冲突、质量风险和未知项的检查清单。\n\n```text\n请基于 risk_card、boundaries 和 quick_start_candidates，给我一份安装前风险预检清单。不要替我执行命令，只说明我应该检查什么、为什么检查、失败会有什么影响。\n```\n\n### 宿主 AI 开工指令\n\n- 目标：把项目上下文转成一次对话开始前的宿主 AI 指令。\n- 预期输出：一段边界明确、证据引用明确、适合复制给宿主 AI 的开工前指令。\n\n```text\n请基于 pm-skills-docs 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。\n```\n\n\n## 角色 / Skill 索引\n\n- 共索引 62 个角色 / Skill / 项目文档条目。\n\n- **utility-update-pm-skills**（skill）：Validates internet access, compares the locally installed pm-skills version against the latest public release, and updates local files with conflict-aware overwrite-or-skip options. Produces an update report listing changed files, skipped files, and new capabilities. Use when you want to bring a local pm-skills installation up to date. 激活提示：当用户任务与“utility-update-pm-skills”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`\n- **utility-update-pm-skills**（skill）：- 激活提示：当用户任务与“utility-update-pm-skills”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`\n- ****（skill）： 激活提示：当用户任务与“”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`docs/templates/skill-template/SKILL.md`\n- **define-hypothesis**（skill）：Defines a testable hypothesis with clear success metrics and validation approach. Use when forming assumptions to test, designing experiments, or aligning team on what success looks like. 激活提示：当用户任务与“define-hypothesis”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/define-hypothesis/SKILL.md`\n- **define-jtbd-canvas**（skill）：Creates a Jobs to be Done canvas capturing the functional, emotional, and social dimensions of a customer job. Use when deeply understanding customer motivations, designing for jobs, or reframing product positioning. 激活提示：当用户任务与“define-jtbd-canvas”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/define-jtbd-canvas/SKILL.md`\n- **define-opportunity-tree**（skill）：Creates an opportunity solution tree mapping desired outcomes to opportunities and potential solutions. Use for outcome-driven product discovery, prioritization, or communicating product strategy. 激活提示：当用户任务与“define-opportunity-tree”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/define-opportunity-tree/SKILL.md`\n- **define-problem-statement**（skill）：Creates a clear problem framing document with user impact, business context, and success criteria. Use when starting a new initiative, realigning a drifted project, or communicating up to leadership. 激活提示：当用户任务与“define-problem-statement”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/define-problem-statement/SKILL.md`\n- **deliver-acceptance-criteria**（skill）：Generates structured Given/When/Then acceptance criteria for a user story or feature slice. Use when translating product requirements into testable scenarios that cover the happy path, edge cases, error states, and non-functional expectations for engineering handoff and QA. 激活提示：当用户任务与“deliver-acceptance-criteria”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/deliver-acceptance-criteria/SKILL.md`\n- **deliver-edge-cases**（skill）：Documents edge cases, error states, boundary conditions, and recovery paths for a feature. Use during specification to ensure comprehensive coverage, or during QA planning to identify test scenarios. 激活提示：当用户任务与“deliver-edge-cases”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/deliver-edge-cases/SKILL.md`\n- **deliver-launch-checklist**（skill）：Creates a comprehensive pre-launch checklist covering engineering, design, marketing, support, legal, and operations readiness. Use before releasing features, products, or major updates to ensure nothing is missed. 激活提示：当用户任务与“deliver-launch-checklist”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/deliver-launch-checklist/SKILL.md`\n- **deliver-prd**（skill）：Creates a comprehensive Product Requirements Document that aligns stakeholders on what to build, why, and how success will be measured. Use when specifying features, epics, or product initiatives for engineering handoff. 激活提示：当用户任务与“deliver-prd”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/deliver-prd/SKILL.md`\n- **deliver-release-notes**（skill）：Creates user-facing release notes that communicate new features, improvements, and fixes in clear, benefit-focused language. Use when shipping updates to communicate changes to users, customers, or stakeholders. 激活提示：当用户任务与“deliver-release-notes”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/deliver-release-notes/SKILL.md`\n- **deliver-user-stories**（skill）：Generates user stories with clear acceptance criteria from product requirements or feature descriptions. Use when breaking down features for sprint planning, writing tickets, or communicating requirements to engineering. 激活提示：当用户任务与“deliver-user-stories”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/deliver-user-stories/SKILL.md`\n- **develop-adr**（skill）：Creates an Architecture Decision Record following the Nygard format to document significant technical decisions, their context, and consequences. Use when making technical choices that affect system architecture, technology selection, or development patterns. 激活提示：当用户任务与“develop-adr”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/develop-adr/SKILL.md`\n- **develop-design-rationale**（skill）：Documents the reasoning behind design decisions including alternatives considered, trade-offs evaluated, and principles applied. Use when making significant UX decisions, aligning with stakeholders on design direction, or preserving design context for future reference. 激活提示：当用户任务与“develop-design-rationale”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/develop-design-rationale/SKILL.md`\n- **develop-solution-brief**（skill）：Creates a concise one-page solution overview that communicates the proposed approach, key decisions, and trade-offs. Use when pitching solutions to stakeholders, aligning teams on approach, or documenting solution intent before detailed specification. 激活提示：当用户任务与“develop-solution-brief”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/develop-solution-brief/SKILL.md`\n- **develop-spike-summary**（skill）：Documents the results of a time-boxed technical or design exploration spike . Use after completing a spike to capture learnings, findings, and recommendations for the team. 激活提示：当用户任务与“develop-spike-summary”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/develop-spike-summary/SKILL.md`\n- **discover-competitive-analysis**（skill）：Creates a structured competitive analysis comparing features, positioning, and strategy across competitors. Use when entering a market, planning differentiation, or understanding the competitive landscape. 激活提示：当用户任务与“discover-competitive-analysis”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/discover-competitive-analysis/SKILL.md`\n- **discover-interview-synthesis**（skill）：Synthesizes user research interviews into actionable insights, patterns, and recommendations. Use after conducting user interviews, customer calls, or usability sessions to extract and communicate findings. 激活提示：当用户任务与“discover-interview-synthesis”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/discover-interview-synthesis/SKILL.md`\n- **discover-stakeholder-summary**（skill）：Documents stakeholder needs, concerns, and influence for a project or initiative. Use when starting projects, managing complex stakeholder relationships, or ensuring alignment across organizational boundaries. 激活提示：当用户任务与“discover-stakeholder-summary”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/discover-stakeholder-summary/SKILL.md`\n- **foundation-lean-canvas**（skill）：Produces a one-page lean canvas across nine interlocking blocks problem, customer, UVP, solution, channels, revenue, cost, metrics, unfair advantage with optional inline HTML and SVG visual rendering. Use when framing a new product thesis, stress-testing an existing strategy, comparing strategic options side-by-side, or aligning a team on business-model assumptions. Works as a strategic hub that cross-links to deepe… 激活提示：当用户任务与“foundation-lean-canvas”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-lean-canvas/SKILL.md`\n- **foundation-meeting-agenda**（skill）：Produces an attendee-facing agenda that sets what will be discussed, who owns each topic, and how time will be spent. Supports ten meeting type variants standup, planning, review, decision-making, brainstorm, 1-on-1, stakeholder-review, project-kickoff, working-session, exec-briefing . Emits a shareable summary suitable for Slack or email plus a full agenda with time-boxed topics, type tags, owners, attendee prep, a… 激活提示：当用户任务与“foundation-meeting-agenda”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-meeting-agenda/SKILL.md`\n- **foundation-meeting-brief**（skill）：Produces a private strategic preparation document for the user before a meeting that matters. Captures stakes, stakeholder positions and reads, ranked desired outcomes, key messages, anticipated questions with prepared responses, risks and tensions, specific asks, and success signals. Distinct from meeting-agenda because this artifact is not shared with attendees; it is the user's personal tactical prep for meetings… 激活提示：当用户任务与“foundation-meeting-brief”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-meeting-brief/SKILL.md`\n- **foundation-meeting-recap**（skill）：Produces a topic-segmented post-meeting summary for attendees with decisions highlighted and actions captured inline per topic plus a consolidated action view at the end . Auto-populates topic skeleton from a sibling meeting-agenda when available and reconciles planned vs. actual topics. Accepts transcripts from Zoom, Meet, Otter, Fireflies, Krisp MCP, or manual notes; runs on variable-quality input without blocking. 激活提示：当用户任务与“foundation-meeting-recap”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-meeting-recap/SKILL.md`\n- **foundation-meeting-synthesize**（skill）：Cross-meeting archaeology skill. Consumes multiple meeting recaps or raw notes over a period and surfaces patterns invisible in any single meeting. Shows how decisions evolved, who has been saying what, where threads are stalling, and where contradictions have emerged. Produces a plain-text timeline, themes with confidence markers, stakeholder position tracking, consolidated decision list, contradiction flags, open… 激活提示：当用户任务与“foundation-meeting-synthesize”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-meeting-synthesize/SKILL.md`\n- **foundation-okr-writer**（skill）：Drafts, reviews, rewrites, and coaches outcome-based OKR sets across team, department, product, or company scopes. Supports five entry modes Guided default, One-Shot via --oneshot, Sustained Coach, Audit Only, Rewrite . Diagnoses empowered-team context and adjusts framing; refuses to fabricate baselines or targets; refuses to use OKR scores for compensation; reframes feature-delivery KRs into outcome KRs. Use when p… 激活提示：当用户任务与“foundation-okr-writer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-okr-writer/SKILL.md`\n- **foundation-persona**（skill）：Generates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract. Use when shaping artifact perspective, stress-testing decisions, or framing product and GTM strategy. 激活提示：当用户任务与“foundation-persona”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-persona/SKILL.md`\n- **foundation-stakeholder-update**（skill）：Produces async communication to stakeholders, primarily non-attendees and secondarily some attendees who want a reference. Translates meeting outcomes into what-it-means language for readers, with channel variants slack, teams, email, notion, exec-memo and audience variants engineering, design, leadership, customer-facing, mixed . Surfaces a primary CTA up front, flags technical-to-business translations for user ver… 激活提示：当用户任务与“foundation-stakeholder-update”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/foundation-stakeholder-update/SKILL.md`\n- **iterate-lessons-log**（skill）：Creates a structured lessons learned entry for organizational memory. Use after projects, incidents, or significant learnings to capture knowledge for future teams and initiatives. 激活提示：当用户任务与“iterate-lessons-log”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/iterate-lessons-log/SKILL.md`\n- **iterate-pivot-decision**（skill）：Documents a strategic pivot or persevere decision with the evidence, analysis, and rationale. Use when evaluating whether to change direction on a product, feature, or strategy based on market feedback. 激活提示：当用户任务与“iterate-pivot-decision”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/iterate-pivot-decision/SKILL.md`\n- **iterate-refinement-notes**（skill）：Documents backlog refinement session outcomes including stories refined, estimates, questions raised, and decisions made. Use during or after refinement to capture the results and share with absent team members. 激活提示：当用户任务与“iterate-refinement-notes”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/iterate-refinement-notes/SKILL.md`\n- **iterate-retrospective**（skill）：Facilitates and documents a team retrospective capturing what went well, what to improve, and action items. Use at the end of sprints, projects, or milestones to reflect and improve team practices. 激活提示：当用户任务与“iterate-retrospective”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/iterate-retrospective/SKILL.md`\n- **measure-dashboard-requirements**（skill）：Specifies requirements for an analytics dashboard including metrics, visualizations, filters, and data sources. Use when requesting dashboards from data teams, defining KPI tracking, or documenting reporting needs. 激活提示：当用户任务与“measure-dashboard-requirements”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/measure-dashboard-requirements/SKILL.md`\n- **measure-experiment-design**（skill）：Designs an A/B test or experiment with clear hypothesis, variants, success metrics, sample size, and duration. Use when planning experiments to validate product changes or test hypotheses. 激活提示：当用户任务与“measure-experiment-design”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/measure-experiment-design/SKILL.md`\n- **measure-experiment-results**（skill）：Documents the results of a completed experiment or A/B test with statistical analysis, learnings, and recommendations. Use after experiments conclude to communicate findings, inform decisions, and build organizational knowledge. 激活提示：当用户任务与“measure-experiment-results”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/measure-experiment-results/SKILL.md`\n- **measure-instrumentation-spec**（skill）：Specifies event tracking and analytics instrumentation requirements for a feature. Use when defining what data to collect, ensuring consistent tracking implementation, or documenting analytics requirements for engineering. 激活提示：当用户任务与“measure-instrumentation-spec”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/measure-instrumentation-spec/SKILL.md`\n- **measure-okr-grader**（skill）：Scores completed OKR sets at cycle close with KR-level scoring per the canonical OKR type enum committed aspirational learning operational health compliance or safety , committed-vs-aspirational interpretation, evidence quality assessment, learning synthesis, and next-cycle recommendations. Refuses to retroactively change targets or shrink committed scope, average away guardrail KRs, treat 0.7 as success for committ… 激活提示：当用户任务与“measure-okr-grader”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/measure-okr-grader/SKILL.md`\n- **tool-design-sprint-brief**（skill）：Pre-sprint brief that locks challenge, sprint questions, team and role assignments, customer recruiting plan, prototype medium, interview format, logistics, and success criteria before Monday of a Design Sprint. Use after the readiness verdict is Go and before Monday begins. Produces a two-page artifact the team and Decider sign off on as the contract for the next five days. 激活提示：当用户任务与“tool-design-sprint-brief”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-brief/SKILL.md`\n- **tool-design-sprint-decide-and-storyboard**（skill）：Day 3 Wednesday move of a Design Sprint that runs the art museum layout, heat map, speed critique, straw poll, Decider supervote, rumble-vs-all-in-one decision, and the storyboard that drives Thursday's prototype build. The most decision-heavy day of the sprint. Use Wednesday morning and afternoon after Tuesday's sketches are collected and attribution-stripped. Produces the canonical 5-15 step storyboard that become… 激活提示：当用户任务与“tool-design-sprint-decide-and-storyboard”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-decide-and-storyboard/SKILL.md`\n- **tool-design-sprint-map-and-target**（skill）：Day 1 Monday move of a Design Sprint that produces the bundled Monday artifact containing long-term goal, sprint questions 3-7 testable risks , customer or system map 5-15 step flow , expert interview notes, HMW How Might We cluster board, and the Decider's chosen target moment. Use Day 1 morning and afternoon after the sprint brief is locked. Sets the design target for Tuesday's sketches and Wednesday's storyboard. 激活提示：当用户任务与“tool-design-sprint-map-and-target”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-map-and-target/SKILL.md`\n- **tool-design-sprint-prototype-plan**（skill）：Day 4 Thursday move of a Design Sprint that produces the planning artifact for the day. Output covers the prototype role plan Maker, Stitcher, Writer, Asset Collector, Interviewer , prototype brief what to build, fidelity bar, time allocation per role , canonical Five-Act Interview script Welcome, Context, Intro, Tasks, Debrief , trial-run checklist, and Friday participant confirmation tracker. The actual prototype… 激活提示：当用户任务与“tool-design-sprint-prototype-plan”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-prototype-plan/SKILL.md`\n- **tool-design-sprint-readiness**（skill）：Pre-sprint diagnostic that determines whether a team should run a Design Sprint now, postpone it, or do prerequisite work first. Produces a Go / Conditional Go / Wait verdict with diagnosis, recommended preconditions, attendee list, customer recruiting plan, and pre-sprint activities. Use when a team is considering starting a Design Sprint and wants a fast yes/no diagnosis before committing five days of team time an… 激活提示：当用户任务与“tool-design-sprint-readiness”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-readiness/SKILL.md`\n- **tool-design-sprint-sketch**（skill）：Day 2 Tuesday move of a Design Sprint that structures lightning demos and the four-step independent solution sketch protocol Notes, Ideas, Crazy 8s, Solution Sketch . Each team member produces one solution sketch individually; the skill orchestrates the day but does not author the sketches themselves. Use Tuesday morning after Monday's target moment is locked. Output is the lightning demo board, sketch assignments,… 激活提示：当用户任务与“tool-design-sprint-sketch”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-sketch/SKILL.md`\n- **tool-design-sprint-test-and-score**（skill）：Day 5 Friday sprint-closing move of a Design Sprint that produces the bundled Friday artifact covering per-customer interview observations, best quotes, scorecard grid sprint questions by customers , observed patterns, hot takes from each team member, and the Decider summary build, iterate, pivot, or stop, plus highest-confidence learning, most important revision, and next artifact . Use Friday after Thursday's prot… 激活提示：当用户任务与“tool-design-sprint-test-and-score”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-design-sprint-test-and-score/SKILL.md`\n- **tool-foundation-sprint-approach-options**（skill）：Day 2 morning move of a Foundation Sprint. Forces generation of 3 to 7 candidate approaches as one-page summaries before the team converges on a top bet. Use after Day 1 is signed and before Magic Lenses on Day 2 afternoon. Enforces a minimum of 3 approaches to prevent first-idea anchoring. Each approach summary names what it is, why it serves the differentiators, and includes a simple visual. 激活提示：当用户任务与“tool-foundation-sprint-approach-options”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-approach-options/SKILL.md`\n- **tool-foundation-sprint-basics**（skill）：Day 1 morning move of a Foundation Sprint. Forces explicit team choices on target customer, important problem, team advantage, and competitors and alternatives. Produces a single coherent strategic frame that becomes the input to Day 1 afternoon Differentiation. Use after the sprint brief is signed and Day 1 morning is scheduled. Bundled artifact, not four separate decisions. 激活提示：当用户任务与“tool-foundation-sprint-basics”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-basics/SKILL.md`\n- **tool-foundation-sprint-brief**（skill）：Pre-sprint brief that locks scope, the decision the sprint must unlock, team and role assignments, logistics, inputs to bring, and success criteria before Day 1 of a Foundation Sprint. Use after the readiness verdict is Go and before the sprint begins. Produces a one-page artifact the team and Decider sign off on as the contract for the next two days. 激活提示：当用户任务与“tool-foundation-sprint-brief”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-brief/SKILL.md`\n- **tool-foundation-sprint-differentiation**（skill）：Day 1 afternoon move of a Foundation Sprint. Converts the morning's Basics frame into a defensible strategic position by scoring differentiator candidates against customer-perceived value, choosing two committed differentiators, plotting alternatives on a 2x2 chart, writing decision principles, and producing a one-page Mini Manifesto. Use after Basics is signed; before Approach Options the next morning. 激活提示：当用户任务与“tool-foundation-sprint-differentiation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-differentiation/SKILL.md`\n- **tool-foundation-sprint-founding-hypothesis**（skill）：Day 2 end capstone move of a Foundation Sprint. Compresses the sprint's full strategic frame into a single canonical sentence the Founding Hypothesis plus an assumption scorecard, why-we-believe, what-could-prove-us-wrong, and recommended next validation step. Use after Magic Lenses is signed. Strict canonical template; paraphrase is not accepted in v0.1.0. The Founding Hypothesis is the spine artifact the sprint ex… 激活提示：当用户任务与“tool-foundation-sprint-founding-hypothesis”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-founding-hypothesis/SKILL.md`\n- **tool-foundation-sprint-magic-lenses**（skill）：Day 2 afternoon move of a Foundation Sprint. Evaluates the candidate approach set through multiple lenses 4 classic plus at least 1 custom to surface trade-offs, identify consistent winners and contradictions, and produce a top bet plus a backup plan. Use after Approach Options is signed. Lens scoring is a sense-making tool, not mathematical truth; arbitrary precision is a smell. 激活提示：当用户任务与“tool-foundation-sprint-magic-lenses”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-magic-lenses/SKILL.md`\n- **tool-foundation-sprint-readiness**（skill）：Pre-sprint diagnostic that determines whether a team should run a Foundation Sprint now, postpone it, or do prerequisite work first. Produces a Go / Conditional Go / Wait verdict with diagnosis, recommended preconditions, attendee list, and pre-sprint activities. Use when a team is considering starting a Foundation Sprint and wants a fast yes/no diagnosis before committing two days of facilitated work. 激活提示：当用户任务与“tool-foundation-sprint-readiness”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-foundation-sprint-readiness/SKILL.md`\n- **tool-note-and-vote**（skill）：Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact. Use when a small team needs to make a fast decision with diverse input, when groupthink is a risk, or when a workshop moment demands silent contribution before discussion. Applicable to Foundation Sprint, Design Sprint, and any participatory decision context. 激活提示：当用户任务与“tool-note-and-vote”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/tool-note-and-vote/SKILL.md`\n- **utility-mermaid-diagrams**（skill）：Teaches PMs to create syntactically valid mermaid diagrams by selecting the right diagram type for their communication need, following syntax validity rules, and validating before shipping. Covers all 15 mermaid diagram types with PM-relevant examples and a dual-lens navigation system. 激活提示：当用户任务与“utility-mermaid-diagrams”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-mermaid-diagrams/SKILL.md`\n- **utility-pm-changelog-curator**（skill）：Draft CHANGELOG entries from git log via the pm-changelog-curator sub-agent. Dispatches natively on Claude Code with the pm-skills plugin invokes @agent-pm-changelog-curator ; on non-Claude clients Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI reads agents/pm-changelog-curator.md and executes the system prompt inline. Applies CLAUDE.md hygiene rules no internal-notes references, no em-dashes, no Claude attributio… 激活提示：当用户任务与“utility-pm-changelog-curator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-changelog-curator/SKILL.md`\n- **utility-pm-critic**（skill）：Run adversarial review on a PM artifact via the pm-critic sub-agent. Dispatches natively on Claude Code with the pm-skills plugin invokes @agent-pm-critic ; on non-Claude clients Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI reads agents/pm-critic.md and executes the system prompt inline. Returns findings graded P0/P1/P2/P3 with concrete fix suggestions per finding, plus a layered Status Summary section and machi… 激活提示：当用户任务与“utility-pm-critic”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-critic/SKILL.md`\n- **utility-pm-release-conductor**（skill）：Walk the guided release runbook 6 gates G0/G1/G2/G2.5/G3/G4 via the pm-release-conductor sub-agent. Dispatches natively on Claude Code with the pm-skills plugin invokes @agent-pm-release-conductor with native chain composition to pm-skill-auditor at G0 and pm-changelog-curator at G2 ; on non-Claude clients Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI reads agents/pm-release-conductor.md and inlines auditor + cur… 激活提示：当用户任务与“utility-pm-release-conductor”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-release-conductor/SKILL.md`\n- **utility-pm-skill-auditor**（skill）：Run a repo-wide cross-cutting governance audit via the pm-skill-auditor sub-agent. Dispatches natively on Claude Code with the pm-skills plugin invokes @agent-pm-skill-auditor ; on non-Claude clients Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI reads agents/pm-skill-auditor.md and executes the system prompt inline. Returns a layered audit report full findings + Status Summary prose + Status YAML envelope per mas… 激活提示：当用户任务与“utility-pm-skill-auditor”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-skill-auditor/SKILL.md`\n- **utility-pm-skill-builder**（skill）：Guides contributors from a PM skill idea to a complete Skill Implementation Packet aligned with pm-skills conventions. Runs gap analysis, validates through a Why Gate, classifies by type and phase, generates draft files, and writes to a staging area for review before promotion. 激活提示：当用户任务与“utility-pm-skill-builder”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-skill-builder/SKILL.md`\n- **utility-pm-skill-iterate**（skill）：Applies targeted improvements to an existing pm-skills skill based on feedback, validation reports, or convention changes. Reads current files, previews proposed changes, writes on confirmation, and suggests a version bump. Use when improving a skill after validation or feedback. 激活提示：当用户任务与“utility-pm-skill-iterate”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-skill-iterate/SKILL.md`\n- **utility-pm-skill-validate**（skill）：Audits an existing pm-skills skill against structural conventions and quality criteria. Produces a structured validation report with pass/fail checks, severity-graded findings, and actionable recommendations. Use when checking whether a skill meets repo standards before shipping or after making changes. 激活提示：当用户任务与“utility-pm-skill-validate”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-pm-skill-validate/SKILL.md`\n- **utility-slideshow-creator**（skill）：Generates professional presentations from a JSON deck specification using 18 slide types with dark/light variants, content-to-layout decision logic, and calibrated character limits. Ships with a default professional theme and supports custom themes via utility-slideshow-themer. 激活提示：当用户任务与“utility-slideshow-creator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-slideshow-creator/SKILL.md`\n- **utility-update-pm-skills**（skill）：Checks for newer pm-skills releases, compares local vs. latest version, previews what would change, and updates local files after user confirmation. Generates a structured update report documenting changed files, new capabilities, and the value delta between versions. Use when you want to bring a local pm-skills installation up to date. 激活提示：当用户任务与“utility-update-pm-skills”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/utility-update-pm-skills/SKILL.md`\n\n## 证据索引\n\n- 共索引 101 条证据。\n\n- **Concepts source folder**（documentation）：The Concepts section renders at https://product-on-purpose.github.io/pm-skills/concepts/. 证据：`docs/concepts/README.md`\n- **Contributing source folder**（documentation）：The Contributing section renders at https://product-on-purpose.github.io/pm-skills/contributing/. 证据：`docs/contributing/README.md`\n- **Getting Started source folder**（documentation）：The Getting Started section renders at https://product-on-purpose.github.io/pm-skills/getting-started/. 证据：`docs/getting-started/README.md`\n- **Guides source folder**（documentation）：The Guides section renders at https://product-on-purpose.github.io/pm-skills/guides/. 证据：`docs/guides/README.md`\n- **Internal Audits**（documentation）：This folder holds analytical audits of the pm-skills repository. Each audit is a static review producing findings, recommendations, and where applicable implementation specifications. Audits are durable knowledge artifacts; they outlive the cycles that consume them. 证据：`docs/internal/audit/README.md`\n- **F-38 Release Skill Working Folder**（documentation）：This folder holds in-progress specs, plans, and working notes for the /pm-release utility skill. 证据：`docs/internal/efforts/F-38-release-skill/README.md`\n- **F-39 find-skills Empirical Test Working Folder**（documentation）：F-39 find-skills Empirical Test Working Folder 证据：`docs/internal/efforts/F-39-find-skills-empirical-test/README.md`\n- **F-40 Skill Description Discoverability Audit Working Folder**（documentation）：F-40 Skill Description Discoverability Audit Working Folder 证据：`docs/internal/efforts/F-40-skill-description-discoverability-audit/README.md`\n- **F-41 Design Sprint Skills Working Folder**（documentation）：F-41 Design Sprint Skills Working Folder 证据：`docs/internal/efforts/F-41-design-sprint-skills/README.md`\n- **F-42 Foundation Sprint Skills Working Folder**（documentation）：F-42 Foundation Sprint Skills Working Folder 证据：`docs/internal/efforts/F-42-foundation-sprint-skills/README.md`\n- **Effort Briefs**（documentation）：Status: Active Owner: Maintainers Last updated: 2026-03-17 证据：`docs/internal/efforts/README.md`\n- **Design Sprint Skill: Sample Output Artifacts**（documentation）：Design Sprint Skill: Sample Output Artifacts 证据：`docs/internal/efforts/design-sprint-skills/samples/README.md`\n- **Sprint Skills Design Working Folder**（documentation）：Sprint Skills Design Working Folder 证据：`docs/internal/efforts/foundation-sprint-skills/README.md`\n- **Foundation Sprint Skill: Sample Output Artifacts**（documentation）：Foundation Sprint Skill: Sample Output Artifacts 证据：`docs/internal/efforts/foundation-sprint-skills/samples/README.md`\n- **2026-03 Baseline Cleanup**（documentation）：Status: Complete Scope: March 2026 baseline cleanup for repo continuity, governance, contributor docs, and release-supporting standards 证据：`docs/internal/milestones/2026-03-baseline-cleanup/README.md`\n- **Internal Release Governance**（documentation）：Status: Active Owner: Maintainers Last updated: 2026-05-05 证据：`docs/internal/release-plans/README.md`\n- **v2.2.0 Internal Release Governance**（documentation）：Status: Shipped Owner: Maintainers Last updated: 2026-03-22 证据：`docs/internal/release-plans/v2.2.0/README.md`\n- **v2.3.0 Internal Release Governance**（documentation）：Status: Shipped Owner: Maintainers Last updated: 2026-03-22 证据：`docs/internal/release-plans/v2.3.0/README.md`\n- **v2.4.0 Internal Release Record**（documentation）：Status: Historical record Release: v2.4.0 Last updated: 2026-03-16 证据：`docs/internal/release-plans/v2.4.0/README.md`\n- **v2.5.0 Internal Release Record**（documentation）：Status: Released Release: v2.5.0 Last updated: 2026-03-16 证据：`docs/internal/release-plans/v2.5.0/README.md`\n- **v2.6.1 Internal Release Governance**（documentation）：Status: Shipped Owner: Maintainers Last updated: 2026-03-19 证据：`docs/internal/release-plans/v2.6.1/README.md`\n- **v2.7.0 Internal Release Governance**（documentation）：Status: Ready for tag . all gating criteria met Owner: Maintainers Last updated: 2026-03-22 证据：`docs/internal/release-plans/v2.7.0/README.md`\n- **Product on Purpose**（documentation）：DRAFT skeleton. This is the proposed content for a future product-on-purpose/plugins repo, staged here inside pm-skills planning for review. When the real repo is created, this file becomes its root README.md and this banner is removed. 证据：`docs/internal/release-plans/v3.0.0/marketplace-repo-skeleton/README.md`\n- **Reference source folder**（documentation）：The reference docs render at https://product-on-purpose.github.io/pm-skills/reference/. 证据：`docs/reference/README.md`\n- **Releases source folder**（documentation）：The Releases section renders at https://product-on-purpose.github.io/pm-skills/releases/. 证据：`docs/releases/README.md`\n- **Showcase source folder**（documentation）：The Showcase section renders at https://product-on-purpose.github.io/pm-skills/showcase/. 证据：`docs/showcase/README.md`\n- **Skills source folder**（documentation）：The Skills section renders at https://product-on-purpose.github.io/pm-skills/skills/. 证据：`docs/skills/README.md`\n- **Workflows Generated**（documentation）：Do not edit directly. Source of truth is workflows/ . 证据：`docs/workflows/README.md`\n- **PM Skills Updater**（skill_instruction）：This skill updates a local pm-skills installation to the latest public release. It validates connectivity, compares versions, detects local modifications, gives the user control over conflict resolution, and produces a structured update report documenting every change. 证据：`docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md`\n- **PM Skills Updater**（skill_instruction）：This skill updates a local pm-skills installation to the latest public release. It validates connectivity, compares versions, previews changes, and produces a structured report documenting what was updated and what new capabilities are available. 证据：`docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md`\n- **classification: For non-domain skills, use classification and omit phase**（skill_instruction）：When asked to , follow these steps: 证据：`docs/templates/skill-template/SKILL.md`\n- **PM-Skills**（documentation）：Open source Product Management skills for AI agents 证据：`AGENTS.md`\n- **Claude Code Instructions**（documentation）：NEVER use em-dash characters — , U+2014 in any output. This is a hard rule across all generated content: prose, code comments, file names, commit messages, plan docs, internal notes, memory files, or anything authored by Claude in this repo. 证据：`CLAUDE.md`\n- **Quick Start**（documentation）：A curated library of 59 best-practice, plug-and-play product management skills covering the complete product lifecycle - plus templates, workflows, and 95+ real-world sample outputs that set the quality bar. 证据：`README.md`\n- **Workflows**（documentation）：Source of truth for workflow definitions. 证据：`_workflows/README.md`\n- **Awesome Lists Submission Issues**（documentation）：This directory contains draft issue content for submitting pm-skills to various awesome lists and curated repositories. 证据：`.github/issues-drafts/README.md`\n- **GitHub Actions Scripts**（documentation）：This directory contains scripts used by GitHub Actions workflows. 证据：`.github/scripts/README.md`\n- **Codex Workspace Policy**（documentation）：This folder is the Codex working area for pm-skills . 证据：`_agent-context/codex/README.md`\n- **Sub-Agent Library Samples**（documentation）：Real example outputs from each pm-skills sub-agent demonstrating the canonical patterns each sub-agent produces. Three samples per sub-agent across the three narrative threads Brainshelf, Storevine, Workbench . 证据：`library/sub-agent-samples/README.md`\n- **Package**（package_manifest）：{ \"name\": \"pm-skills-docs\", \"version\": \"0.1.0\", \"private\": true, \"type\": \"module\", \"description\": \"Astro Starlight documentation site for pm-skills\", \"engines\": { \"node\": \" =22.12.0\" }, \"scripts\": { \"dev\": \"astro dev\", \"start\": \"astro dev\", \"build\": \"astro build && node scripts/post-build-strip-md-links.mjs\", \"preview\": \"astro preview\", \"astro\": \"astro\" }, \"dependencies\": { \"@astrojs/starlight\": \"~0.39.0\", \"astro\": \"^6.3.0\", \"astro-mermaid\": \"~2.0.1\", \"sharp\": \"^0.34.5\" }, \"overrides\": { \"mermaid\": \"^11.15.0\", \"devalue\": \"^5.8.1\" } } 证据：`package.json`\n- **Package**（package_manifest）：{ \"name\": \"issue-creation-scripts\", \"version\": \"1.0.0\", \"description\": \"Scripts for automated issue creation from markdown drafts\", \"type\": \"module\", \"scripts\": { \"create-issues\": \"node create-issues.js\" }, \"dependencies\": { \"@octokit/rest\": \"^22.0.0\", \"gray-matter\": \"^4.0.3\" } } 证据：`.github/scripts/package.json`\n- **Contributing to PM-Skills**（documentation）：Thank you for your interest in contributing to PM-Skills! This document provides guidelines for contributing skills and other improvements. 证据：`CONTRIBUTING.md`\n- **Hypothesis**（skill_instruction）：A hypothesis is a testable prediction about how a change will affect user behavior or business outcomes. It transforms assumptions into explicit statements that can be validated or invalidated through experimentation. Well-formed hypotheses prevent teams from building features based on untested beliefs and create shared understanding of what success looks like. 证据：`skills/define-hypothesis/SKILL.md`\n- **Jobs to be Done Canvas**（skill_instruction）：A Jobs to be Done JTBD canvas captures the complete picture of why customers \"hire\" products to make progress in their lives. Based on Clayton Christensen's framework, JTBD goes beyond features and demographics to understand the underlying motivations.functional, emotional, and social.that drive customer behavior. 证据：`skills/define-jtbd-canvas/SKILL.md`\n- **Opportunity Solution Tree**（skill_instruction）：An Opportunity Solution Tree OST is a visual framework for product discovery that connects business outcomes to customer opportunities and potential solutions. Developed by Teresa Torres, it prevents the common trap of jumping straight to solutions by ensuring every feature idea traces back to a customer need and measurable outcome. 证据：`skills/define-opportunity-tree/SKILL.md`\n- **Problem Statement**（skill_instruction）：A problem statement is a concise document that frames the problem you're solving, articulates the impact on users and the business, and defines clear success criteria. It serves as the foundation for all subsequent product work by ensuring alignment on what problem to solve before jumping to how to solve it. 证据：`skills/define-problem-statement/SKILL.md`\n- **Acceptance Criteria**（skill_instruction）：Acceptance criteria define the observable behavior that must be true for a story or feature to be considered done. This skill turns feature context into concise, testable Given/When/Then scenarios that engineers and QA can verify without guessing intent. 证据：`skills/deliver-acceptance-criteria/SKILL.md`\n- **Edge Cases**（skill_instruction）：An edge cases document systematically catalogs the unusual, boundary, and error scenarios for a feature. While happy-path flows are typically well-specified, edge cases often get discovered in production . causing bugs, poor user experience, and support burden. Documenting edge cases upfront ensures engineering handles them intentionally and QA knows what to test. 证据：`skills/deliver-edge-cases/SKILL.md`\n- **Launch Checklist**（skill_instruction）：A launch checklist is a comprehensive verification document that ensures all functions are ready before releasing a feature or product. It coordinates across engineering, QA, design, marketing, support, legal, and operations to prevent launch-day surprises. Good launch checklists surface blockers early and create shared accountability for launch readiness. 证据：`skills/deliver-launch-checklist/SKILL.md`\n- **Product Requirements Document PRD**（skill_instruction）：A Product Requirements Document is the primary specification artifact that communicates what to build and why. It bridges the gap between problem understanding and engineering implementation by providing clear requirements, success criteria, and scope boundaries. A good PRD enables engineering to build the right thing while maintaining flexibility on implementation details. 证据：`skills/deliver-prd/SKILL.md`\n- **Release Notes**（skill_instruction）：Release notes communicate product changes to users in a way that highlights value and builds excitement. Unlike changelogs which document what changed technically , release notes translate changes into user benefits. Good release notes help users discover new capabilities, understand improvements, and trust that issues are being addressed. 证据：`skills/deliver-release-notes/SKILL.md`\n- **User Stories**（skill_instruction）：User stories are concise descriptions of functionality from the user's perspective. They capture who needs something, what they need, and why . without prescribing how to build it. Good user stories enable teams to break large features into estimable, deliverable increments while maintaining focus on user value. 证据：`skills/deliver-user-stories/SKILL.md`\n- **Architecture Decision Record ADR**（skill_instruction）：An Architecture Decision Record documents a significant technical decision along with its context and consequences. ADRs capture the \"why\" behind architectural choices so future team members understand the reasoning . especially important when they question why something was done a particular way. This skill follows Michael Nygard's lightweight ADR format. 证据：`skills/develop-adr/SKILL.md`\n- **Design Rationale**（skill_instruction）：A design rationale document captures the \"why\" behind design decisions.the context, constraints, alternatives considered, and reasoning that led to a particular solution. While designs themselves show what was built, rationale documents preserve institutional knowledge about why it was built that way. 证据：`skills/develop-design-rationale/SKILL.md`\n- **Solution Brief**（skill_instruction）：A solution brief is a concise, one-page document that communicates the proposed solution to a problem. It serves as the bridge between problem understanding and detailed specification, providing enough context for stakeholders to align on the approach without getting lost in implementation details. The one-page constraint forces clarity and prioritization. 证据：`skills/develop-solution-brief/SKILL.md`\n- **Spike Summary**（skill_instruction）：A spike summary documents the results of a time-boxed exploration . a focused investigation to reduce uncertainty before committing to implementation. Spikes answer specific questions like \"Can we integrate with this API?\" or \"Is this technology viable for our use case?\" The summary captures findings so the team can make informed decisions without the spike participants needing to repeat explanations. 证据：`skills/develop-spike-summary/SKILL.md`\n- **Competitive Analysis**（skill_instruction）：A competitive analysis provides structured insight into the competitive landscape, helping product teams understand where they stand relative to alternatives and identify opportunities for differentiation. Rather than exhaustively cataloging every competitor, an effective analysis focuses on actionable insights that inform product strategy. 证据：`skills/discover-competitive-analysis/SKILL.md`\n- **Interview Synthesis**（skill_instruction）：An interview synthesis transforms raw user research data into structured insights that drive product decisions. Rather than simply listing what participants said, a good synthesis identifies patterns across conversations, connects observations to underlying user needs, and translates findings into actionable recommendations. 证据：`skills/discover-interview-synthesis/SKILL.md`\n- **Stakeholder Summary**（skill_instruction）：A stakeholder summary documents the people and groups who have interest in or influence over a project, capturing their needs, concerns, and relationships. Effective stakeholder management often determines project success more than technical execution, making this document essential for navigating organizational complexity. 证据：`skills/discover-stakeholder-summary/SKILL.md`\n- **Lean Canvas**（skill_instruction）：A lean canvas is a one-page business thesis that makes your assumptions about problem, customer, solution, and viability explicit and testable. Developed by Ash Maurya from Alex Osterwalder's Business Model Canvas, it is specifically adapted for startups and product teams operating under uncertainty. Nine interlocking blocks force you to articulate the whole picture at once so that changing one block's assumptions surfaces the ripple effect on the others. 证据：`skills/foundation-lean-canvas/SKILL.md`\n- 其余 41 条证据见 `AI_CONTEXT_PACK.json` 或 `EVIDENCE_INDEX.json`。\n\n## 宿主 AI 必须遵守的规则\n\n- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`docs/concepts/README.md`, `docs/contributing/README.md`, `docs/getting-started/README.md`\n- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`docs/concepts/README.md`, `docs/contributing/README.md`, `docs/getting-started/README.md`\n\n## 用户开工前应该回答的问题\n\n- 你准备在哪个宿主 AI 或本地环境中使用它？\n- 你只是想先体验工作流，还是准备真实安装？\n- 你最在意的是安装成本、输出质量、还是和现有规则的冲突？\n\n## 验收标准\n\n- 所有能力声明都能回指到 evidence_refs 中的文件路径。\n- AI_CONTEXT_PACK.md 没有把预览包装成真实运行。\n- 用户能在 3 分钟内看懂适合谁、能做什么、如何开始和风险边界。\n\n---\n\n## Doramagic Context Augmentation\n\n下面内容用于强化 Repomix/AI Context Pack 主体。Human Manual 只提供阅读骨架；踩坑日志会被转成宿主 AI 必须遵守的工作约束。\n\n## Human Manual 骨架\n\n使用规则：这里只是项目阅读路线和显著性信号，不是事实权威。具体事实仍必须回到 repo evidence / Claim Graph。\n\n宿主 AI 硬性规则：\n- 不得把页标题、章节顺序、摘要或 importance 当作项目事实证据。\n- 解释 Human Manual 骨架时，必须明确说它只是阅读路线/显著性信号。\n- 能力、安装、兼容性、运行状态和风险判断必须引用 repo evidence、source path 或 Claim Graph。\n\n- **项目介绍**：importance `high`\n - source_paths: README.md, LICENSE, docs/index.mdx\n- **技能库概览**：importance `high`\n - source_paths: docs/skills/index.md, docs/skills/discover/index.md, docs/skills/define/index.md, docs/skills/develop/index.md, docs/skills/deliver/index.md\n- **技能结构解析**：importance `high`\n - source_paths: docs/reference/pm-skill-anatomy.md, docs/reference/frontmatter-schema.yaml, docs/templates/skill-template/SKILL.md, docs/templates/skill-template/references/TEMPLATE.md, docs/templates/skill-template/references/EXAMPLE.md\n- **技能分类体系**：importance `medium`\n - source_paths: docs/reference/categories.md, docs/reference/skill-families/index.md, docs/reference/skill-families/design-sprint-skills-contract.md, docs/reference/skill-families/foundation-sprint-skills-contract.md, docs/reference/skill-families/meeting-skills-contract.md\n- **技能生命周期管理**：importance `high`\n - source_paths: docs/guides/pm-skill-lifecycle.md, docs/guides/creating-pm-skills.md, skills/utility-pm-skill-builder/SKILL.md, skills/utility-pm-skill-validate/SKILL.md, skills/utility-pm-skill-iterate/SKILL.md\n- **子代理系统**：importance `high`\n - source_paths: docs/concepts/sub-agents.md, docs/reference/runtime-components.md, agents/pm-critic.md, agents/pm-skill-auditor.md, agents/pm-changelog-curator.md\n- **工作流系统**：importance `high`\n - source_paths: docs/workflows/index.md, docs/guides/using-workflows.md, _workflows/feature-kickoff.md, _workflows/sprint-planning.md, _workflows/product-strategy.md\n- **工具家族**：importance `medium`\n - source_paths: docs/concepts/foundation-sprint.md, docs/concepts/design-sprint.md, docs/guides/using-foundation-sprint.md, docs/guides/using-design-sprint.md, docs/reference/workshop-method-comparison.md\n\n## Repo Inspection Evidence / 源码检查证据\n\n- repo_clone_verified: true\n- repo_inspection_verified: true\n- repo_commit: `ae771c7aafef58d2a1197453c9d153ce88498822`\n- inspected_files: `package.json`, `README.md`, `docs/changelog.md`, `docs/index.mdx`, `docs/tags.md`, `docs/skills/index.md`, `docs/skills/README.md`, `docs/reference/frontmatter-schema.yaml`, `docs/reference/mermaid-style-guide.md`, `docs/reference/index.md`, `docs/reference/runtime-components.md`, `docs/reference/project-structure.md`, `docs/reference/commands.md`, `docs/reference/sub-agent-compatibility.md`, `docs/reference/categories.md`, `docs/reference/README.md`, `docs/reference/pm-skill-anatomy.md`, `docs/reference/sprint-methodology-glossary.md`, `docs/reference/workshop-method-comparison.md`, `docs/reference/ecosystem.md`\n\n宿主 AI 硬性规则：\n- 没有 repo_clone_verified=true 时，不得声称已经读过源码。\n- 没有 repo_inspection_verified=true 时，不得把 README/docs/package 文件判断写成事实。\n- 没有 quick_start_verified=true 时，不得声称 Quick Start 已跑通。\n\n## Doramagic Pitfall Constraints / 踩坑约束\n\n这些规则来自 Doramagic 发现、验证或编译过程中的项目专属坑点。宿主 AI 必须把它们当作工作约束，而不是普通说明文字。\n\n### Constraint 1: 仓库名和安装名不一致\n\n- Trigger: 仓库名 `pm-skills` 与安装入口 `skills` 不完全一致。\n- Host AI rule: 在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- Why it matters: 用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- Evidence: identity.distribution | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | repo=pm-skills; install=skills\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 2: 来源证据：[F-14] Workflow Builder (/workflow-builder)\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-14] Workflow Builder (/workflow-builder)\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_fd2240d9f58c49edbcc147428ff9b561 | https://github.com/product-on-purpose/pm-skills/issues/133 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 3: 来源证据：[F-15] Ad-Hoc Skill Chaining (/chain)\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-15] Ad-Hoc Skill Chaining (/chain)\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_151a0a8448c84b81b626bf03b88d2714 | https://github.com/product-on-purpose/pm-skills/issues/134 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 4: 来源证据：v2.11.1 - skills.sh CLI Compatibility Patch\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v2.11.1 - skills.sh CLI Compatibility Patch\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能影响升级、迁移或版本选择。\n- Evidence: community_evidence:github | cevd_55aa5dc614634b48a39a0310a9b5fd45 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1 | 来源类型 github_release 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 5: 可能修改宿主 AI 配置\n\n- Trigger: 项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- Host AI rule: 列出会写入的配置文件、目录和卸载/回滚步骤。\n- Why it matters: 安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- Evidence: capability.host_targets | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | host_targets=claude, claude_code\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 6: 能力判断依赖假设\n\n- Trigger: README/documentation is current enough for a first validation pass.\n- Host AI rule: 将假设转成下游验证清单。\n- Why it matters: 假设不成立时，用户拿不到承诺的能力。\n- Evidence: capability.assumptions | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | README/documentation is current enough for a first validation pass.\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 7: 来源证据：[M-21] Explore release-please Integration\n\n- Trigger: GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：[M-21] Explore release-please Integration\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_acdd9d4cd91c449f964bf1924ec0b6e1 | https://github.com/product-on-purpose/pm-skills/issues/136 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 8: 来源证据：v2.12.0 OKR Skills Launch\n\n- Trigger: GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：v2.12.0 OKR Skills Launch\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_f2a160e56ca04946816b63eab92a85cd | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0 | 来源类型 github_release 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 9: 维护活跃度未知\n\n- Trigger: 未记录 last_activity_observed。\n- Host AI rule: 补 GitHub 最近 commit、release、issue/PR 响应信号。\n- Why it matters: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- Evidence: evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | last_activity_observed missing\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 10: 下游验证发现风险项\n\n- Trigger: no_demo\n- Host AI rule: 进入安全/权限治理复核队列。\n- Why it matters: 下游已经要求复核，不能在页面中弱化。\n- Evidence: downstream_validation.risk_items | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n",
"summary": "给宿主 AI 的上下文和工作边界。",
"title": "AI Context Pack / 带给我的 AI"
},
"boundary_risk_card": {
"asset_id": "boundary_risk_card",
"filename": "BOUNDARY_RISK_CARD.md",
"markdown": "# Boundary & Risk Card / 安装前决策卡\n\n项目：product-on-purpose/pm-skills\n\n## Doramagic 试用结论\n\n当前结论：可以进入发布前推荐检查；首次使用仍应从最小权限、临时目录和可回滚配置开始。\n\n## 用户现在可以做\n\n- 可以先阅读 Human Manual，理解项目目的和主要工作流。\n- 可以复制 Prompt Preview 做安装前体验；这只验证交互感，不代表真实运行。\n- 可以把官方 Quick Start 命令放到隔离环境中验证，不要直接进主力环境。\n\n## 现在不要做\n\n- 不要把 Prompt Preview 当成项目实际运行结果。\n- 不要把 metadata-only validation 当成沙箱安装验证。\n- 不要把未验证能力写成“已支持、已跑通、可放心安装”。\n- 不要在首次试用时交出生产数据、私人文件、真实密钥或主力配置目录。\n\n## 安装前检查\n\n- 宿主 AI 是否匹配：claude, claude_code\n- 官方安装入口状态：已发现官方入口\n- 是否在临时目录、临时宿主或容器中验证：必须是\n- 是否能回滚配置改动：必须能\n- 是否需要 API Key、网络访问、读写文件或修改宿主配置：未确认前按高风险处理\n- 是否记录了安装命令、实际输出和失败日志：必须记录\n\n## 当前阻塞项\n\n- 无阻塞项。\n\n## 项目专属踩坑\n\n- 仓库名和安装名不一致（medium）：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 来源证据：[F-14] Workflow Builder (/workflow-builder)（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 来源证据：[F-15] Ad-Hoc Skill Chaining (/chain)（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 来源证据：v2.11.1 - skills.sh CLI Compatibility Patch（medium）：可能影响升级、迁移或版本选择。 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 可能修改宿主 AI 配置（medium）：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n\n## 风险与权限提示\n\n- no_demo: medium\n\n## 证据缺口\n\n- 暂未发现结构化证据缺口。\n",
"summary": "安装、权限、验证和推荐前风险。",
"title": "Boundary & Risk Card / 边界与风险卡"
},
"human_manual": {
"asset_id": "human_manual",
"filename": "HUMAN_MANUAL.md",
"markdown": "# https://github.com/product-on-purpose/pm-skills 项目说明书\n\n生成时间: 2026-05-21 19:54:48 UTC\n\n## 目录\n\n- [项目介绍](#project-introduction)\n- [技能库概览](#skill-library-overview)\n- [技能结构解析](#skill-anatomy)\n- [技能分类体系](#skill-categories)\n- [技能生命周期管理](#skill-lifecycle)\n- [子代理系统](#sub-agents)\n- [工作流系统](#workflows)\n- [工具家族](#tool-families)\n- [安装与平台配置](#installation-guide)\n- [样本输出库](#sample-outputs)\n\n\n\n## 项目介绍\n\n### 相关页面\n\n相关主题：[技能库概览](#skill-library-overview), [安装与平台配置](#installation-guide)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/product-on-purpose/pm-skills/blob/main/README.md)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n \n\n# 项目介绍\n\n## 概述\n\n**pm-skills** 是一个面向产品经理（Product Manager）的技能框架与文档站点，托管于 GitHub 仓库 [product-on-purpose/pm-skills](https://github.com/product-on-purpose/pm-skills)。该项目旨在将产品管理工作中常见的流程拆解为可复用的技能（Skills）、标准化的工作流（Workflows）以及可自动化执行的子代理（Sub-agents）。\n\n资料来源：[package.json:2](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 技术栈\n\npm-skills 基于现代前端技术构建文档站点，核心技术选型如下：\n\n| 技术选型 | 版本 | 用途 |\n|---------|------|------|\n| Astro | ^6.3.0 | 静态站点生成框架 |\n| @astrojs/starlight | ~0.39.0 | 文档主题与 UI 组件 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表渲染 |\n| Mermaid | ^11.15.0 | 流程图与架构图绘制 |\n| sharp | ^0.34.5 | 图片处理优化 |\n| devalue | ^5.8.1 | 序列化库 |\n\n项目要求 Node.js 版本不低于 **22.12.0**，采用 ES Module（`\"type\": \"module\"`）规范。\n\n资料来源：[package.json:3-18](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 核心架构\n\npm-skills 的架构围绕三大核心概念展开：**工作流（Workflows）**、**技能（Skills）** 和 **子代理（Sub-agents）**。\n\n```mermaid\ngraph TD\n A[pm-skills 项目] --> B[Workflows 工作流]\n A --> C[Skills 技能库]\n A --> D[Sub-agents 子代理]\n \n B --> B1[多技能引导序列]\n B --> B2[PM 标准流程定义]\n \n C --> C1[define-hypothesis]\n C --> C2[更多技能模块]\n \n D --> D1[pm-critic 评审代理]\n D --> D2[pm-skill-auditor 审计代理]\n D --> D3[pm-changelog-curator 变更日志代理]\n D --> D4[pm-release-conductor 发布代理]\n```\n\n资料来源：[_workflows/README.md:1-10](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n## 内容组织\n\n### 文档结构\n\n项目采用 Astro Starlight 构建文档站点，内容目录结构如下：\n\n| 目录 | 说明 |\n|------|------|\n| `docs/` | 用户文档（skills、guides、concepts、contributing 等） |\n| `library/` | 示例输出与子代理样本库 |\n| `_workflows/` | 工作流定义源文件 |\n| `_agent-context/` | AI 代理工作区策略文档 |\n| `scripts/` | 构建与生成脚本 |\n\n内容配置支持通过 glob 模式加载 Markdown/MDX 文件，并自动排除以下内容：\n\n- `docs/internal/`：Gitignored 的发布计划与内部笔记\n- `docs/templates/`：包含 `` 语法的模板文件\n- `docs/**/README.md`：GitHub 目录自动渲染页面（避免重复）\n- 遗留样本文件：符合 `sample_*_legacy_*` 或 `sample_*_orbit_*` 模式的文件\n\n资料来源：[src/content.config.ts:1-80](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### 技能输出样本\n\n`library/skill-output-samples/` 目录包含真实场景下的子代理输出样本，用于展示各子代理的标准输出格式与行为模式。\n\n每个样本包含：\n\n- **Frontmatter 元数据**：title、description、artifact、version、repo_version、agent_version、created、status、thread、context\n- **Scenario 场景**：触发子代理的背景信息\n- **Output 输出**：子代理的实际输出内容\n- **Notes 笔记**：样本的演示说明\n\n资料来源：[library/sub-agent-samples/README.md:1-30](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 子代理体系\n\n### 代理分类\n\n| 子代理名称 | 功能 | 样本数量 |\n|-----------|------|---------|\n| `pm-critic` | 对 PRD、OKR、会议记录进行对抗性评审 | 3 |\n| `pm-skill-auditor` | 跨技能审计与漂移检测 | 3 |\n| `pm-changelog-curator` | 生成规范化的变更日志 | 3 |\n| `pm-release-conductor` | 协调发布流程与门控检查 | 3 |\n\n### 叙事线程\n\n子代理输出跨越三个叙事线程，用于验证代理在不同产品场景下的一致性表现：\n\n| 线程 | 产品类型 | 场景特征 |\n|------|---------|---------|\n| **Brainshelf** | 消费者 PKM（个人知识管理）应用 | 消费级产品 PM 语境 |\n| **Storevine** | B2B 营销分析平台 | 数据产品 PM 语境 |\n| **Workbench** | 内部平台工具团队 | 平台/DX PM 语境 |\n\n资料来源：[library/sub-agent-samples/README.md:80-100](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 工作流定义\n\n`_workflows/` 目录采用 Markdown 格式定义多技能工作流，每个文件描述一个产品管理流程的引导式技能序列。\n\n### 链接约定\n\n工作流文件使用 **仓库相对路径** 引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n此约定确保 AI 代理（Copilot、Cursor、Windsurf）和仓库浏览器可直接解析链接。\n\n资料来源：[_workflows/README.md:8-15](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 编辑规范\n\n工作流内容直接在 `_workflows/` 目录编辑，**不要**直接修改 `docs/workflows/`，后者由 `scripts/generate-workflow-pages.py` 脚本自动生成。\n\n## AI 代理工作区\n\n`_agent-context/codex/` 目录定义了 Codex 工作区的策略规范：\n\n### 持久化文件（Git 跟踪）\n\n| 文件 | 用途 |\n|------|------|\n| `CONTEXT.md` | 稳定的当前状态事实 |\n| `DECISIONS.md` | 已接受的决策与理由 |\n| `WRAP-SESSION_TEMPLATE.md` | 会话交接模板 |\n| `WORKTREE-PRIMER.md` | 清洁分支工作流指南 |\n\n### 本地文件（Git 忽略）\n\n| 路径/文件 | 用途 |\n|----------|------|\n| `PLANNING/**` | 探索性规划草稿 |\n| `TODO.md` | 临时任务清单 |\n| `AGENTS/SESSION-LOG/` | 会话日志目录 |\n\n资料来源：[_agent-context/codex/README.md:1-40](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n\n## 样式与渲染\n\n### 自定义样式\n\n项目通过 `src/styles/custom.css` 实现 Starlight 主题定制：\n\n- **Mermaid 图表**：最大宽度 100%，SVG 高度自适应\n- **图表优化**：线条宽度 1.75px、节点圆角 6px、聚类填充透明度 0.4\n\n### 主题变量\n\nAstro 配置文件中定义了 Mermaid 主题变量（`lineColor` 与 `fontFamily`），确保图表在浅色与深色模式下的一致呈现。\n\n资料来源：[src/styles/custom.css:1-35](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n\n## 构建流程\n\n### NPM 脚本\n\n| 命令 | 功能 |\n|------|------|\n| `npm run dev` | 启动开发服务器（热重载） |\n| `npm run build` | 生产构建（含 Markdown 链接清理） |\n| `npm run preview` | 预览生产构建结果 |\n| `npm run astro` | 调用 Astro CLI |\n\n构建流程包含后处理步骤 `scripts/post-build-strip-md-links.mjs`，用于清理生成的 Markdown 链接。\n\n资料来源：[package.json:7-12](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 扩展字段\n\n内容配置为文档和样本定义了丰富的 Frontmatter 扩展字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `generated` | boolean | 内容是否由脚本生成 |\n| `source` | string | 原始来源 |\n| `phase` | string | 所属阶段 |\n| `classification` | string | 分类 |\n| `version` | string/number | 版本号 |\n| `updated` | string/Date | 更新时间 |\n| `artifact` | string | 子代理输出类型 |\n| `created` | string/Date | 创建时间 |\n| `status` | string | 样本状态 |\n| `thread` | string | 叙事线程 |\n| `context` | string | 上下文信息 |\n| `tags` | string[] | 标签数组 |\n| `metadata` | object | 额外元数据 |\n\n资料来源：[src/content.config.ts:50-75](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 快速开始\n\n```bash\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm run dev\n\n# 生产构建\nnpm run build\n```\n\n访问本地开发服务器（默认 `http://localhost:4321`）查看文档站点。\n\n---\n\n\n\n## 技能库概览\n\n### 相关页面\n\n相关主题：[技能结构解析](#skill-anatomy), [技能分类体系](#skill-categories), [项目介绍](#project-introduction)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n \n\n# 技能库概览\n\n## 概述\n\npm-skills 是一个面向产品经理（PM）的技能库与文档站点，基于 Astro Starlight 构建。该项目为产品管理全生命周期提供结构化的技能指导，覆盖从发现机会到持续迭代的完整流程。\n\n技能库采用 Markdown 文件组织，每个技能独立成篇，支持 AI 代理（如 Copilot、Cursor、Windsurf）直接调用和解析。\n\n资料来源：[package.json:3-7](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 技能库架构\n\n### 技能分类\n\n技能库按产品管理流程阶段划分为七大类别：\n\n| 技能类别 | 用途 | 示例技能 |\n|---------|------|---------|\n| discover | 发现问题与机会 | 用户研究、竞品分析 |\n| define | 定义问题与目标 | 定义假设、绘制用户旅程 |\n| develop | 方案构思与设计 | 原型设计、功能规划 |\n| deliver | 交付与发布 | 发布计划、变更管理 |\n| measure | 度量与评估 | 指标定义、数据分析 |\n| iterate | 迭代优化 | 优先级排序、复盘总结 |\n| foundation | 基础工具与方法论 | OKR 设定、会议主持 |\n\n资料来源：[src/content.config.ts:15-25](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### 目录结构\n\n技能文件采用统一目录布局，每个技能目录下包含核心文档：\n\n```text\nskills/\n├── discover/\n│ └── SKILL.md\n├── define/\n│ ├── define-hypothesis/\n│ │ └── SKILL.md\n│ └── SKILL.md\n├── develop/\n├── deliver/\n├── measure/\n├── iterate/\n└── foundation/\n```\n\n技能文件使用 **repo-relative 路径** 进行内部引用，确保 AI 代理和仓库浏览器直接解析：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n资料来源：[_workflows/README.md:9-13](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n## 内容加载机制\n\n### Astro 内容集合配置\n\n技能库通过 Astro 内容集合加载，支持 Markdown 和 MDX 格式：\n\n```typescript\nloader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md',\n ],\n base: '.',\n})\n```\n\n资料来源：[src/content.config.ts:15-25](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### Slug 生成规则\n\n系统自动处理路径转换，生成干净的 URL slug：\n\n| 源文件 | 生成 Slug |\n|--------|----------|\n| `docs/skills/index.md` | `skills` |\n| `docs/skills/define-hypothesis/SKILL.md` | `skills/define-hypothesis/SKILL` |\n| `library/skill-output-samples/` 下的文件 | `samples/...` |\n\n资料来源：[src/content.config.ts:26-40](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 技能内容 Schema\n\n### 通用字段\n\n每个技能文档支持以下标准 frontmatter 字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `title` | string | 技能标题 |\n| `description` | string | 技能描述 |\n| `generated` | boolean | 是否为生成内容 |\n| `source` | string | 来源引用 |\n| `phase` | string | 所属阶段 |\n| `classification` | string | 分类标识 |\n| `version` | string \\| number | 技能版本 |\n| `updated` | string \\| Date | 更新时间 |\n| `tags` | string[] | 标签列表 |\n| `draft` | boolean | 是否为草稿 |\n\n资料来源：[src/content.config.ts:45-60](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 技能输出样本库\n\n### 样本分类\n\n技能库包含真实场景的技能输出样本，按三个叙事线程组织：\n\n| 线程 | 应用场景 | 产品类型 |\n|------|----------|----------|\n| **Brainshelf** | 消费者 PKM 应用 | 个人知识管理 App |\n| **Storevine** | B2B 活动分析平台 | 数据分析产品 |\n| **Workbench** | 内部平台工具团队 | 平台/DX 产品 |\n\n资料来源：[library/sub-agent-samples/README.md:85-90](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### 子代理能力\n\n技能库通过子代理扩展功能，每个子代理专注于特定任务：\n\n| 子代理 | 职能 | 输出类型 |\n|--------|------|----------|\n| `pm-critic` | 对抗性评审 | 问题分级（P0-P3） |\n| `pm-skill-auditor` | 技能审计 | 跨技能一致性检查 |\n| `pm-changelog-curator` | 变更日志整理 | 版本发布草稿 |\n\n资料来源：[library/sub-agent-samples/README.md:17-24](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 工作流集成\n\n### 工作流定义\n\n工作流是多技能的有序组合，定义产品管理常见流程：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n每个 `.md` 文件定义一个多技能工作流，指导 AI 代理完成完整的产品管理流程。\n\n资料来源：[_workflows/README.md:5-10](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 工作流与技能关系\n\n```mermaid\ngraph TD\n A[工作流定义] --> B[discover 技能]\n A --> C[define 技能]\n A --> D[develop 技能]\n A --> E[deliver 技能]\n A --> F[measure 技能]\n A --> G[iterate 技能]\n \n B --> H[pm-critic 评审]\n C --> H\n D --> H\n E --> H\n F --> H\n G --> H\n \n H --> I[pm-skill-auditor 审计]\n I --> J[pm-changelog-curator 变更整理]\n J --> K[pm-release-conductor 发布]\n```\n\n## 可视化样式\n\n### Mermaid 图表集成\n\n技能库全面支持 Mermaid 图表，通过 `astro-mermaid` 集成：\n\n```json\n{\n \"astro-mermaid\": \"~2.0.1\",\n \"overrides\": {\n \"mermaid\": \"^11.15.0\"\n }\n}\n```\n\n资料来源：[package.json:18-22](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n### 图表样式定制\n\n自定义样式提供更好的可读性：\n\n```css\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n资料来源：[src/styles/custom.css:14-25](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n\n## 文档生成与发布\n\n### 构建流程\n\n项目使用自动化构建流程：\n\n```json\n{\n \"build\": \"astro build && node scripts/post-build-strip-md-links.mjs\"\n}\n```\n\n构建后脚本移除 Markdown 链接，生成最终静态站点。\n\n资料来源：[package.json:12](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n### 节点版本要求\n\n```json\n{\n \"engines\": {\n \"node\": \">=22.12.0\"\n }\n}\n```\n\n资料来源：[package.json:8](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 快速入门\n\n1. **浏览技能**：访问 `/skills/` 目录查看所有可用技能\n2. **选择阶段**：根据产品管理流程阶段选择对应技能\n3. **查看样本**：参考 `/samples/` 目录中的实际输出样本\n4. **使用工作流**：通过 `/workflows/` 中的工作流串联多个技能\n\n## 相关资源\n\n- [子代理库样本](../library/sub-agent-samples/index.md) - 各子代理的真实输出示例\n- [工作流定义](../_workflows/index.md) - 多技能组合的工作流\n- [发布运行手册](../docs/contributing/release-runbook.md) - 发布流程指南\n\n---\n\n\n\n## 技能结构解析\n\n### 相关页面\n\n相关主题：[技能生命周期管理](#skill-lifecycle), [技能分类体系](#skill-categories)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [docs/reference/pm-skill-anatomy.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/pm-skill-anatomy.md)\n- [docs/reference/frontmatter-schema.yaml](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/frontmatter-schema.yaml)\n- [docs/templates/skill-template/SKILL.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/templates/skill-template/SKILL.md)\n- [docs/templates/skill-template/references/TEMPLATE.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/templates/skill-template/references/TEMPLATE.md)\n- [docs/templates/skill-template/references/EXAMPLE.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/templates/skill-template/references/EXAMPLE.md)\n \n\n# 技能结构解析\n\n## 概述\n\n技能（Skill）是 pm-skills 项目中 PM（产品经理）工作流程的核心执行单元。每个技能定义了一个具体的、可复用的产品管理实践或决策框架，供 AI Agent 在不同场景下调用。技能以 Markdown 文件形式存储在仓库的 `skills/` 目录下，具有标准化的结构、元数据和引用机制。\n\n技能的设计目标是使 PM 工作流程原子化、可组合、可追溯。通过统一的技能格式，AI Agent（如 Codex、Claude）能够理解并执行从需求假设定义到产品决策验证的完整链条。\n\n## 技能核心结构\n\n### 文件组成\n\n一个完整的技能包含以下文件：\n\n| 文件 | 说明 | 必需 |\n|------|------|------|\n| `SKILL.md` | 技能主定义文件，包含元数据和执行指南 | 是 |\n| `references/` | 目录，包含 `TEMPLATE.md` 和 `EXAMPLE.md` | 是 |\n\n资料来源：[docs/templates/skill-template/SKILL.md]()\n\n### 主文件元数据（Frontmatter）\n\n每个技能的主文件必须包含 YAML frontmatter，定义技能的身份信息：\n\n```yaml\n---\ntitle: 技能标题\ndescription: 技能简短描述（1-2 句话）\nversion: 1.0.0\ncreated: YYYY-MM-DD\nstatus: draft | published | deprecated\nsource: 初始来源或灵感引用\nskill_version: 当前版本号\ncontext: 适用场景标签（如 brainshelf、storevine、workbench）\n---\n```\n\n支持的扩展字段包括：\n\n| 字段名 | 类型 | 说明 |\n|--------|------|------|\n| `title` | 字符串 | 技能显示标题 |\n| `description` | 字符串 | 简短功能描述 |\n| `version` | 字符串或数字 | 语义化版本号 |\n| `created` | 字符串或日期 | 创建时间 |\n| `status` | 枚举 | 技能状态：draft、published、deprecated |\n| `source` | 字符串 | 来源引用 |\n| `skill_version` | 字符串或数字 | 技能特定版本 |\n| `context` | 字符串 | 适用场景 |\n| `generated` | 布尔值 | 是否为生成内容 |\n| `classification` | 字符串 | 技能分类 |\n| `tags` | 字符串数组 | 标签列表 |\n| `metadata` | 对象 | 自定义元数据 |\n\n资料来源：[docs/reference/frontmatter-schema.yaml]()\n资料来源：[src/content.config.ts:25-70]()\n\n### 正文结构\n\n技能主文件正文遵循标准化的文档结构：\n\n```markdown\n## 目的\n说明技能解决的问题和价值\n\n## 触发条件\n何时应该使用此技能\n\n## 使用指南\n技能的详细执行步骤\n\n## 变体与场景\n不同情境下的适配方式\n```\n\n## 引用系统\n\n### references 目录结构\n\n每个技能必须包含 `references/` 子目录，用于存放扩展文档：\n\n```\nskills/技能名称/\n├── SKILL.md\n└── references/\n ├── TEMPLATE.md # 该技能的模板文档\n └── EXAMPLE.md # 该技能的示例文档\n```\n\n资料来源：[docs/templates/skill-template/SKILL.md]()\n\n### 引用命名规范\n\n| 文件名 | 用途 | 内容特点 |\n|--------|------|----------|\n| `TEMPLATE.md` | 模板参考 | 展示如何创建该技能的变体或扩展 |\n| `EXAMPLE.md` | 实际示例 | 真实场景的应用案例 |\n\n### 跨技能引用\n\n技能之间可以相互引用，使用仓库相对路径：\n\n```markdown\n[`define-hypothesis`](../define-hypothesis/SKILL.md)\n```\n\n这种链接格式确保 AI Agent 和文档系统都能正确解析技能间关系。资料来源：[_workflows/README.md:15-17]()\n\n## 技能分类体系\n\npm-skills 项目采用多层分类体系组织技能：\n\n### 场景分类（Thread）\n\n| 场景 | 说明 | 典型用例 |\n|------|------|----------|\n| `brainshelf` | 消费者 PKM（个人知识管理）应用 | 产品重 surfaced PRD 评审 |\n| `storevine` | B2B 活动分析平台 | Q2 OKR 设置与验证 |\n| `workbench` | 内部平台工具团队 | Sprint 回顾与决策追踪 |\n\n资料来源：[library/sub-agent-samples/README.md:60-74]()\n\n### 问题优先级体系\n\n技能执行过程中使用 P0-P3 优先级标记问题：\n\n| 优先级 | 含义 | 处理要求 |\n|--------|------|----------|\n| P0 | 阻断性问题 | 必须立即修复 |\n| P1 | 重要缺陷 | 下一迭代修复 |\n| P2 | 次要问题 | 计划内修复 |\n| P3 | 建议改进 | 视情况处理 |\n\n资料来源：[library/sub-agent-samples/README.md:6-11]()\n\n## 技能执行流程\n\n技能的执行通过子代理（Sub-Agent）系统完成，不同类型的技能由相应的子代理处理：\n\n```mermaid\ngraph TD\n A[用户触发] --> B{技能类型判断}\n B -->|PRD 评审| C[pm-critic]\n B -->|技能审计| D[pm-skill-auditor]\n B -->|变更日志| E[pm-changelog-curator]\n B -->|发布流程| F[pm-release-conductor]\n C --> G[问题评级 P0-P3]\n D --> G\n E --> H[生成输出]\n F --> H\n G --> I[状态信封]\n I --> H\n```\n\n资料来源：[library/sub-agent-samples/README.md:1-45]()\n\n### 子代理职责\n\n| 子代理 | 功能 | 输出类型 |\n|--------|------|----------|\n| `pm-critic` | 对抗性评审，捕获合同完整性、可证伪性、实验设计问题 | 评审报告 |\n| `pm-skill-auditor` | 跨技能审计，检测漂移和结构问题 | 审计发现 |\n| `pm-changelog-curator` | 自动生成变更日志 | 草稿文档 |\n| `pm-release-conductor` | 执行发布门控流程 | 门控状态 |\n\n## 技能与工作流的关系\n\n### 工作流定义\n\n工作流（Workflow）是由多个技能组成的引导序列，定义在 `_workflows/` 目录中。每个工作流文件（`.md`）使用技能引用链接构建执行路径。\n\n```mermaid\ngraph LR\n subgraph 工作流示例\n W1[define-hypothesis] --> W2[design-experiment]\n W2 --> W3[analyze-results]\n W3 --> W4[decide-pivot]\n end\n```\n\n资料来源：[_workflows/README.md:1-8]()\n\n### 链接规范\n\n工作流文件中的技能链接必须使用仓库相对路径：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n此格式确保 AI Agent 和 GitHub 目录浏览器都能正确解析。\n\n## 文档生成机制\n\npm-skills 使用 Astro Starlight 构建文档站点，技能文件通过内容收集器加载：\n\n```typescript\n// src/content.config.ts\nconst collections = {\n docs: defineCollection({\n loader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n 'library/skill-output-samples/**/sample_*.md',\n // ...\n ],\n base: '.',\n }),\n schema: docsSchema({\n extend: z.object({ /* pm-skills 扩展字段 */ })\n }),\n }),\n};\n```\n\n资料来源：[src/content.config.ts:1-80]()\n\n### 内容加载规则\n\n| 规则 | 说明 |\n|------|------|\n| `docs/**` | 文档主目录 |\n| `!docs/internal/**` | 排除内部工作文件 |\n| `!docs/templates/**` | 排除模板目录 |\n| `!docs/**/README.md` | 排除目录着陆页 |\n\n## 技能模板使用\n\n创建新技能时应基于技能模板，遵循以下步骤：\n\n1. 复制 `docs/templates/skill-template/` 目录结构\n2. 修改 `SKILL.md` 的 frontmatter 元数据\n3. 填写正文各节内容\n4. 完善 `references/` 中的模板和示例\n5. 将新技能放置于 `skills/` 目录相应分类下\n\n### 模板字段说明\n\n| 字段 | 填写要求 |\n|------|----------|\n| `title` | 使用动词短语，准确描述技能行为 |\n| `description` | 限 1-2 句话，说明技能解决的问题 |\n| `version` | 遵循语义化版本 `MAJOR.MINOR.PATCH` |\n| `status` | 新技能初始为 `draft`，审核通过后改为 `published` |\n\n资料来源：[docs/templates/skill-template/references/TEMPLATE.md]()\n资料来源：[docs/templates/skill-template/references/EXAMPLE.md]()\n\n## 最佳实践\n\n### 技能编写规范\n\n- **原子性**：每个技能应专注于单一职责\n- **可组合性**：技能应能与其他技能组合形成工作流\n- **可测试性**：技能应有明确的成功/失败判定标准\n- **文档完整性**：所有字段必须填写，引用必须有效\n\n### 状态管理\n\n| 状态 | 使用场景 |\n|------|----------|\n| `draft` | 开发中或审核中的技能 |\n| `published` | 已完成审核，可正式使用的技能 |\n| `deprecated` | 已废弃，不建议新项目使用 |\n\n### 版本控制\n\n技能版本遵循语义化版本规范：\n\n- **MAJOR**：不兼容的 API 变更\n- **MINOR**：向后兼容的功能添加\n- **PATCH**：向后兼容的问题修复\n\n## 相关资源\n\n- 技能目录：`skills/`\n- 工作流目录：`_workflows/`\n- 子代理定义：`agents/`\n- 运行时组件参考：[docs/reference/runtime-components.md]()\n- 发布运行手册：[docs/contributing/release-runbook.md]()\n\n---\n\n\n\n## 技能分类体系\n\n### 相关页面\n\n相关主题：[技能库概览](#skill-library-overview), [技能结构解析](#skill-anatomy)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [docs/reference/categories.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/categories.md)\n- [docs/reference/skill-families/index.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/index.md)\n- [docs/reference/skill-families/design-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/design-sprint-skills-contract.md)\n- [docs/reference/skill-families/foundation-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/foundation-sprint-skills-contract.md)\n- [docs/reference/skill-families/meeting-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/meeting-skills-contract.md)\n \n\n# 技能分类体系\n\n## 概述\n\npm-skills 项目采用分层分类体系来组织产品管理技能（PM Skills），通过技能家族（Skill Families）和技能契约（Skills Contract）机制实现技能的结构化管理。该体系是项目架构的核心支柱，为 AI 代理提供标准化的技能调用接口和一致性的输出格式。\n\n技能分类体系的核心目标是：\n\n- 建立产品管理领域的技能分类标准\n- 为不同叙事线程（Threads）提供统一的技能调用框架\n- 通过技能契约确保子代理输出的结构一致性\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 技能家族架构\n\n### 技能家族定义\n\n技能家族是相关技能的逻辑分组，每个家族定义了特定产品管理场景下的技能集合。根据项目结构，主要的技能家族包括：\n\n| 技能家族 | 描述 | 典型场景 |\n|---------|------|---------|\n| Foundation Sprint Skills | 基础产品管理技能集 | 需求定义、假设验证、用户研究 |\n| Design Sprint Skills | 设计冲刺相关技能 | 快速原型、用户测试、设计决策 |\n| Meeting Skills | 会议与协作技能 | 会议复盘、决策追踪、团队沟通 |\n| Utility PM Roles | 跨场景工具技能 | 发布管理、变更日志、技能审计 |\n\n资料来源：[docs/reference/skill-families/index.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/index.md)\n\n### 技能契约机制\n\n技能契约（Skills Contract）是定义技能家族行为规范的核心文档，每个契约包含：\n\n```mermaid\ngraph TD\n A[技能契约] --> B[输入规范]\n A --> C[输出格式]\n A --> D[状态封装]\n A --> E[评级标准]\n \n B --> B1[工件类型]\n B --> B2[上下文要求]\n \n C --> C1[结构化输出]\n C --> C2[元数据字段]\n \n D --> D1[Status 信封]\n D --> D2[分类标签]\n \n E --> E1[P0-P3 优先级]\n E --> E2[验收标准]\n```\n\n资料来源：[docs/reference/skill-families/design-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/design-sprint-skills-contract.md)\n\n## 技能契约类型详解\n\n### Foundation Sprint 技能契约\n\nFoundation Sprint 技能家族聚焦于产品管理的基础活动，涵盖从概念到验证的完整链路。\n\n#### 核心技能\n\n| 技能名称 | 功能描述 | 触发条件 |\n|---------|---------|---------|\n| define-hypothesis | 定义可验证的产品假设 | 新功能规划、问题分析 |\n| user-research | 用户研究整合 | 需求调研、用户反馈分析 |\n| okr-review | OKR 设置审查 | 季度规划、目标对齐 |\n| prd-review | 产品需求文档审查 | 需求评审、PRD 验收 |\n\n#### 契约规范\n\nFoundation Sprint 技能契约定义了标准化的输入输出格式。输入端接受工件（Artifact）类型，包括产品需求文档、OKR 设置、用户研究数据等。输出端采用分层状态封装（Status Envelope）模式，确保子代理输出的一致性。\n\n资料来源：[docs/reference/skill-families/foundation-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/foundation-sprint-skills-contract.md)\n\n### Design Sprint 技能契约\n\nDesign Sprint 技能家族服务于快速设计和验证流程，强调短周期、高密度的迭代模式。\n\n#### 契约特点\n\n```mermaid\ngraph LR\n A[问题定义] --> B[原型设计]\n B --> C[用户测试]\n C --> D[数据分析]\n D -->|快速反馈| A\n \n E[Design Sprint 契约] --> F[时限约束]\n E --> G[原型标准]\n E --> H[测试协议]\n```\n\nDesign Sprint 契约相比 Foundation Sprint 增加了以下约束：\n\n- **时限约束**：明确规定各阶段的完成时间窗口\n- **原型标准**：定义可测试原型的最低要求\n- **测试协议**：标准化用户测试的流程和数据收集方式\n\n资料来源：[docs/reference/skill-families/design-sprint-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/design-sprint-skills-contract.md)\n\n### Meeting Skills 契约\n\nMeeting Skills 家族专注于会议相关的技能定义和输出规范。\n\n#### 契约结构\n\n| 字段 | 类型 | 说明 |\n|-----|------|-----|\n| title | string | 会议标题 |\n| decisions | array | 会议决策清单 |\n| action_items | array | 行动项列表 |\n| owner | string | 决策责任人 |\n| status | enum | 决策状态（待处理/进行中/已完成）|\n\n资料来源：[docs/reference/skill-families/meeting-skills-contract.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/skill-families/meeting-skills-contract.md)\n\n## 分类维度\n\n### 按叙事线程分类\n\npm-skills 围绕三个叙事线程组织内容，每个线程代表不同的产品管理上下文：\n\n```mermaid\ngraph TD\n P[产品管理技能] --> B[Brainshelf]\n P --> S[Storevine]\n P --> W[Workbench]\n \n B --> B1[消费者 PKM 应用]\n B --> B2[个人知识管理]\n \n S --> S1[B2B 活动分析]\n S --> S2[数据产品管理]\n \n W --> W1[内部平台工具]\n W --> W2[开发者体验]\n```\n\n- **Brainshelf**：面向消费者的个人知识管理应用场景\n- **Storevine**：B2B 活动分析平台的产品管理场景\n- **Workbench**：内部平台工具团队的开发者体验场景\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### 按子代理分类\n\n系统中的四个核心子代理分别承担不同的评审和执行职责：\n\n| 子代理 | 职责 | 输出类型 |\n|-------|------|---------|\n| pm-critic | 对抗性评审 | 问题发现与评级 |\n| pm-skill-auditor | 技能一致性审计 | 漂移检测报告 |\n| pm-changelog-curator | 变更日志整理 | 发布说明草稿 |\n| pm-release-conductor | 发布流程编排 | 门控流程执行 |\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 分类元数据\n\n### Frontmatter 字段\n\n技能文档和样本输出使用统一的 frontmatter 字段定义：\n\n| 字段 | 类型 | 说明 |\n|-----|------|-----|\n| title | string | 文档标题 |\n| version | string/number | 版本号 |\n| artifact | string | 工件类型 |\n| status | string | 状态标识 |\n| thread | string | 叙事线程 |\n| classification | string | 分类标识 |\n| created | string/Date | 创建时间 |\n\n资料来源：[src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts:58-78)\n\n### 分类标识系统\n\n项目采用分层分类标识系统，通过 classification 字段区分不同类型的技能定义：\n\n```mermaid\ngraph TD\n C[Classification] --> C1[skill]\n C --> C2[sub-agent]\n C --> C3[workflow]\n C --> C4[sample]\n \n C1 --> C1A[foundation]\n C1 --> C1B[design-sprint]\n C1 --> C1C[meeting]\n \n C2 --> C2A[critic]\n C2 --> C2B[auditor]\n C2 --> C2C[curator]\n C2 --> C2D[conductor]\n```\n\n## 分类体系的工程实现\n\n### 内容配置架构\n\n技能分类通过 Astro 内容集合（Content Collections）实现：\n\n```typescript\nexport const collections = {\n docs: defineCollection({\n loader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n 'library/skill-output-samples/**/sample_*.md',\n ],\n }),\n schema: docsSchema({\n extend: z.object({\n classification: z.string().optional(),\n thread: z.string().optional(),\n artifact: z.string().optional(),\n }),\n }),\n }),\n};\n```\n\n资料来源：[src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts:1-20)\n\n### 样式与渲染\n\n技能分类文档的渲染遵循 Starlight 主题规范，通过自定义 CSS 实现 Mermaid 图表和技能契约的可视化展示：\n\n```css\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n```\n\n资料来源：[src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css:15-27)\n\n## 使用指南\n\n### 调用技能的正确路径\n\n在技能文档中使用仓库相对路径引用相关技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n这种方式确保 AI 代理可以直接解析和调用技能定义。\n\n资料来源：[_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 样本输出的分类标记\n\n子代理样本输出按照以下规范标记分类信息：\n\n| 标记项 | 示例值 | 说明 |\n|-------|-------|------|\n| thread | brainshelf/storevine/workbench | 叙事上下文 |\n| artifact | grading/report/draft/flow | 输出工件类型 |\n| status | sample | 标识为样本输出 |\n\n## 总结\n\n技能分类体系是 pm-skills 项目的基础架构，通过技能家族、技能契约和叙事线程三个维度实现了产品管理技能的结构化组织。该体系确保了不同子代理输出的可预测性和一致性，同时为 AI 代理提供了标准化的技能调用接口。开发者应遵循既定的分类规范，通过技能契约定义新技能，并通过统一的 frontmatter 字段确保分类元数据的完整性。\n\n---\n\n\n\n## 技能生命周期管理\n\n### 相关页面\n\n相关主题：[技能结构解析](#skill-anatomy)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n \n\n# 技能生命周期管理\n\n## 概述\n\npm-skills 是一个基于 Starlight 构建的产品管理技能文档站点，通过 AI Agent 子代理（Sub-agent）系统实现对产品管理（PM）工作流程的结构化支持。技能生命周期管理涵盖了从技能定义、验证、迭代优化到最终发布评审的完整流程。\n\n当前仓库包含多类子代理，用于支持不同的 PM 工作场景：\n\n| 子代理 | 用途 | 触发场景 |\n|--------|------|----------|\n| `pm-critic` | 对抗性评审 | PRD 审查、OKR 审查、会议复盘审查 |\n| `pm-skill-auditor` | 技能审计 | 预发布审计、漂移检测、跨切面检查 |\n| `pm-changelog-curator` | 变更日志整理 | 版本发布变更记录生成 |\n| `pm-release-conductor` | 发布协调 | 发布流程编排、门控管理 |\n\n资料来源：[library/sub-agent-samples/README.md:1-30]()\n\n## 三条叙事主线\n\npm-skills 通过三条叙事主线（Thread）贯穿整个技能库和子代理示例系统，每条主线代表不同的产品管理场景上下文：\n\n| 叙事主线 | 产品类型 | PM 场景特点 |\n|----------|----------|-------------|\n| **Brainshelf** | 消费级 PKM（个人知识管理）应用 | 消费产品 PM 上下文 |\n| **Storevine** | B2B 营销分析平台 | 数据产品 / 分析 PM 上下文 |\n| **Workbench** | 内部平台工具团队 | 平台 / 开发者体验（DX）PM 上下文 |\n\n这三条主线确保同一子代理在不同场景下能产生结构一致的输出（统一的 P0/P1/P2/P3 优先级语法、D26 规范的 Status 信封结构），而场景差异仅影响被审阅产物的内容本身。\n\n资料来源：[library/sub-agent-samples/README.md:85-100]()\n\n## 技能文件结构\n\n### 技能目录组织\n\n每个 PM 技能作为独立目录存储在 `skills/` 下，包含标准化文件结构：\n\n```\nskills/\n└── /\n └── SKILL.md # 技能定义文件\n```\n\n### 技能链接规范\n\n工作流文件（`_workflows/` 目录）使用**仓库相对路径**引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n这种格式确保 AI 代理（Copilot、Cursor、Windsurf）和仓库浏览器可直接解析链接。\n\n资料来源：[_workflows/README.md:14-16]()\n\n## 内容集合架构\n\npm-skills 使用 Astro Starlight 构建文档站点，内容通过 `src/content.config.ts` 中的 collections 配置管理：\n\n```typescript\nexport const collections = {\n docs: defineCollection({\n loader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md',\n '!library/skill-output-samples/**/sample_*_legacy_*.md',\n '!library/skill-output-samples/**/sample_*_orbit_*.md',\n ],\n base: '.',\n }),\n // ...\n }),\n};\n```\n\n### 内容加载规则\n\n| 模式 | 说明 |\n|------|------|\n| `docs/**/*.{md,mdx}` | 文档主内容 |\n| `!docs/internal/**` | 排除内部文件（gitignored） |\n| `!docs/templates/**` | 排除模板文件 |\n| `!docs/**/README.md` | 排除 GitHub 目录自动渲染页 |\n| `library/skill-output-samples/**/sample_*.md` | 包含技能输出样本 |\n| `!sample_*_legacy_*.md` / `!sample_*_orbit_*.md` | 排除历史遗留样本 |\n\n资料来源：[src/content.config.ts:30-45]()\n\n### Slug 生成策略\n\n内容加载器使用自定义 `generateId` 函数处理路径前缀，确保 URL 整洁：\n\n| 源文件路径 | 生成 Slug |\n|------------|-----------|\n| `docs/foo/bar.md` | `foo/bar` |\n| `docs/skills/index.md` | `skills` |\n| `library/skill-output-samples/define-hypothesis/sample_X.md` | `samples/define-hypothesis/sample_X` |\n| `docs/README.md` | `readme`（统一小写） |\n\n资料来源：[src/content.config.ts:55-75]()\n\n## 子代理样本体系\n\n### 样本文件规范\n\n每个子代理样本文件包含标准化的 Frontmatter 元数据：\n\n```yaml\n---\ntitle: <样本标题>\ndescription: <场景描述>\nartifact: <子代理输出类型>\nversion: <版本号>\nrepo_version: <仓库版本>\ncreated: <创建日期>\nstatus: sample\nthread: \ncontext: <上下文说明>\n---\n```\n\n### 样本结构\n\n每个样本文件包含三个主要部分：\n\n1. **Scenario（场景）**：触发子代理调用的具体情况（产物、受众、触发器）\n2. **Output（输出）**：子代理的实际输出（分级、发现、草稿、门控流程）\n3. **Notes（备注）**：样本演示内容和与三线程目录的关联\n\n资料来源：[library/sub-agent-samples/README.md:47-62]()\n\n## 技能输出样本示例\n\n以下是各子代理在不同叙事主线下的典型输出场景：\n\n| 子代理 | 叙事主线 | 典型场景 | 输出特点 |\n|--------|----------|----------|----------|\n| `pm-critic` | Brainshelf | PRD 审查 | 1 P0 + 3 P1 + 2 P2 + 1 P3，覆盖契约完整性、可证伪性、实验设计 |\n| `pm-critic` | Storevine | OKR 审查 | 2 P0 拒绝协议捕获（伪造基线 + 功能交付 KR） |\n| `pm-critic` | Workbench | 会议复盘审查 | 1 P0 家族契约违反：决策无负责人 |\n| `pm-skill-auditor` | Brainshelf | 预发布审计 | 2 P1 前瞻性发现 + 3 P2 周期内预期漂移 |\n| `pm-skill-auditor` | Storevine | 漂移检测 | 1 P0 CONTEXT.md 声明与文件系统派生不匹配 |\n| `pm-skill-auditor` | Workbench | 跨切面检查 | 1 P0 孤立命令 + 1 P1 缺失配对 |\n| `pm-changelog-curator` | Brainshelf | 次要版本草稿 | 50 commits；5 Added + 2 Changed + 1 Fixed + 2 Security + 1 Known Limitations |\n| `pm-changelog-curator` | Storevine | 补丁版本草稿 | 3 commits；2 Fixed + 1 Security |\n| `pm-changelog-curator` | Workbench | 功能版本草稿 | 80 commits；多轨形态跨越子代理 + 内容 + hooks + 解析器 |\n| `pm-release-conductor` | Brainshelf | 干净运行 | 全部 6 个门控首次通过；基线形态 |\n| `pm-release-conductor` | Storevine | 门控失败恢复 | G0 聚合计数器漂移 + 维护者恢复（失败恢复循环；无绕过；G0 幂等性） |\n| `pm-release-conductor` | Workbench | 链式干跑 | 审计员在 G0 + G2.5；策展人在 G2；分层 Status 信封 |\n\n资料来源：[library/sub-agent-samples/README.md:18-35]()\n\n## 发布门控系统\n\n`pm-release-conductor` 子代理实现了多层级发布门控（Gate）系统：\n\n### 门控层级\n\n| 门控层级 | 触发时机 | 检查内容 |\n|----------|----------|----------|\n| G0 | 初始阶段 | 审计员执行基线检查 |\n| G2 | 中期阶段 | 策展人执行变更日志验证 |\n| G2.5 | 中后期 | 审计员执行补充检查 |\n| G3 | 最终阶段 | 综合评审 |\n\n### 门控状态信封\n\n每个门控结果使用统一的状态信封结构（符合 D26 规范）：\n\n```json\n{\n \"status\": \"PASS|FAIL|WARNING\",\n \"gate\": \"G0|G2|G2.5|G3\",\n \"findings\": [...],\n \"recommendations\": [...]\n}\n```\n\n资料来源：[library/sub-agent-samples/README.md:30-35]()\n\n## 技术栈与构建系统\n\npm-skills 采用以下技术栈：\n\n| 组件 | 版本 | 用途 |\n|------|------|------|\n| Astro | ^6.3.0 | 静态站点生成器 |\n| @astrojs/starlight | ~0.39.0 | 文档框架 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表集成 |\n| sharp | ^0.34.5 | 图片处理 |\n| Mermaid | ^11.15.0 | 图表渲染 |\n| Node.js | >=22.12.0 | 运行时要求 |\n\n资料来源：[package.json:1-25]()\n\n### 构建流程\n\n```bash\nnpm run build # 执行 astro build + post-build-strip-md-links 脚本\nnpm run dev # 开发服务器\nnpm run preview # 预览构建结果\n```\n\n资料来源：[package.json:10-15]()\n\n## 可视化样式配置\n\n### Mermaid 图表样式\n\n文档站点的 Mermaid 图表使用自定义样式规则：\n\n```css\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n这些样式规则适用于亮色和暗色模式，覆盖所有图表类型（流程图、序列图、甘特图等）。\n\n资料来源：[src/styles/custom.css:18-35]()\n\n## 工作流与技能协调\n\n### 多技能工作流定义\n\n`_workflows/` 目录定义了多技能工作流，作为常见 PM 流程的引导式技能序列。每个 `.md` 文件对应一个完整的工作流定义，使用仓库相对路径引用相关技能文件。\n\n### 子代理任务分配\n\n| 子代理 | 典型任务 | 协调关系 |\n|--------|----------|----------|\n| `pm-critic` | 质量把关 | 上游输入评审 |\n| `pm-skill-auditor` | 一致性检查 | 中游验证 |\n| `pm-changelog-curator` | 版本记录 | 下游文档化 |\n| `pm-release-conductor` | 流程编排 | 全局协调 |\n\n资料来源：[_workflows/README.md:1-20]()\n\n## 最佳实践\n\n### 技能文件编辑\n\n- 直接编辑 `docs/` 目录下的内容\n- **不要**直接编辑 `docs/workflows/` 目录下的文件（这些由脚本自动生成）\n- 使用 `scripts/generate-workflow-pages.py` 脚本从 `_workflows/` 目录生成工作流页面\n\n### 代理会话管理\n\nCodex 工作区使用以下策略管理会话：\n\n- **持久化文件**（由 git 追踪）：`CONTEXT.md`、`DECISIONS.md`、`WRAP-SESSION_TEMPLATE.md`、`WORKTREE-PRIMER.md`\n- **本地文件**（被 gitignore）：`PLANNING/**`、`TODO.md`\n- **会话日志**：写入共享的 `AGENTS/SESSION-LOG/` 目录\n\n资料来源：[_agent-context/codex/README.md:5-20]()\n\n## 总结\n\n技能生命周期管理在 pm-skills 项目中体现为：\n\n1. **结构化技能定义**：每个 PM 技能以标准化目录结构存储在 `skills/` 下\n2. **多场景验证**：通过三条叙事主线（Brainshelf、Storevine、Workbench）确保技能在不同上下文中的一致性\n3. **自动化质量保障**：子代理系统（pm-critic、pm-skill-auditor 等）覆盖从设计到发布的全流程\n4. **版本化文档系统**：基于 Astro Starlight 的文档站点支持技能输出样本的持续积累\n5. **发布门控机制**：多层级门控系统确保发布质量，失败恢复机制保障流程健壮性\n\n---\n\n\n\n## 子代理系统\n\n### 相关页面\n\n相关主题：[工作流系统](#workflows), [工具家族](#tool-families)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n \n\n# 子代理系统\n\n子代理系统是 pm-skills 项目中的核心模块化组件架构，旨在为产品管理流程提供专业化、可复用的 AI 辅助能力。每个子代理（Sub-agent）专注于特定的产品管理任务，通过标准化的接口与主系统集成。\n\n## 系统概述\n\npm-skills 的子代理系统包含四个核心子代理，分别对应产品管理工作流中的不同环节：\n\n| 子代理名称 | 主要职能 | 输出产物 |\n|---|---|---|\n| `pm-critic` | 对 PRDs、OKRs、会议决策等进行对抗性审查 | 分级审查报告（P0/P1/P2/P3 问题标注） |\n| `pm-skill-auditor` | 审计技能定义的完整性和一致性 | 审计报告（漂移检测、孤岛检测） |\n| `pm-changelog-curator` | 根据提交记录生成规范的变更日志 | CHANGELOG 草稿 |\n| `pm-release-conductor` | 协调发布流程中的多阶段门控验证 | 发布流程状态报告 |\n\n资料来源：[library/sub-agent-samples/README.md:1-40](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 子代理线程模型\n\n子代理系统基于三个叙事线程（Thread）来组织示例和场景，每个线程代表不同的产品管理上下文：\n\n- **Brainshelf**：消费级 PKM（个人知识管理）应用场景\n- **Storevine**：B2B 营销分析平台场景\n- **Workbench**：内部平台工具团队场景\n\n这种设计确保同一子代理在不同业务上下文中产生结构一致的输出，同时内容贴合实际场景需求。\n\n```mermaid\ngraph TD\n subgraph 叙事线程\n B[brainshelf
消费级 PKM]\n S[storevine
B2B 分析平台]\n W[workbench
平台工具团队]\n end\n \n subgraph 子代理能力\n C[pm-critic
对抗性审查]\n A[pm-skill-auditor
技能审计]\n L[pm-changelog-curator
变更日志整理]\n R[pm-release-conductor
发布协调]\n end\n \n B --> C\n S --> C\n W --> C\n \n B --> A\n S --> A\n W --> A\n \n B --> L\n S --> L\n W --> L\n \n B --> R\n S --> R\n W --> R\n```\n\n资料来源：[library/sub-agent-samples/README.md:130-145](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 子代理详细规格\n\n### pm-critic\n\n`pm-critic` 是对抗性审查子代理，负责对产品文档和决策进行严格的质量检查。\n\n**典型场景：**\n\n- PRD（产品需求文档）审查\n- OKR（目标与关键成果）设定审核\n- 会议决策回顾\n\n**问题分级标准：**\n\n| 级别 | 含义 | 示例问题类型 |\n|---|---|---|\n| P0 | 致命问题 | 契约完整性违规、基线数据伪造 |\n| P1 | 严重问题 | 可证伪性不足、实验设计缺陷 |\n| P2 | 一般问题 | 文档完整性缺失 |\n| P3 | 轻微问题 | 格式规范问题 |\n\n资料来源：[library/sub-agent-samples/README.md:30-35](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### pm-skill-auditor\n\n`pm-skill-auditor` 负责审计技能定义的健康状态，确保技能定义的完整性和文件系统的一致性。\n\n**检测类型：**\n\n- **上下文漂移检测**：CONTEXT.md 声明与文件系统实际状态不匹配\n- **孤岛检测**：存在命令但无对应技能定义，或存在技能定义但无对应命令\n- **预发布审计**：在发布周期中期进行前瞻性检查\n\n### pm-changelog-curator\n\n`pm-changelog-curator` 根据提交记录自动生成符合规范的变更日志。\n\n**输出格式遵循语义化版本规范：**\n\n- Added：新功能\n- Changed：功能变更\n- Fixed：问题修复\n- Security：安全更新\n- Known Limitations：已知限制\n\n资料来源：[library/sub-agent-samples/README.md:45-50](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### pm-release-conductor\n\n`pm-release-conductor` 协调多阶段发布流程，执行门控验证（Gate）并管理失败恢复。\n\n**门控层级：**\n\n| 门控级别 | 验证内容 | 失败策略 |\n|---|---|---|\n| G0 | 聚合计数器校验 | 失败后维护者介入恢复 |\n| G1 | 基础构建验证 | 自动重试 |\n| G2 | 变更日志完整性 | 需人工审批 |\n| G2.5 | 跨代理协同验证 | 条件性通过 |\n\n资料来源：[library/sub-agent-samples/README.md:55-60](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 示例样本规范\n\n每个子代理的示例样本（Sample）遵循统一的文档结构：\n\n```yaml\n# Frontmatter 元数据\ntitle: 样本标题\ndescription: 场景描述\nartifact: 子代理输出类型\nversion: 版本号\nrepo_version: 仓库版本\nagent_version: 代理版本\ncreated: 创建日期\nstatus: sample\nthread: 叙事线程\ncontext: 上下文信息\n```\n\n**文档结构：**\n\n1. **Scenario 部分**：描述触发子代理调用的具体场景\n2. **Output 部分**：子代理的实际输出结果\n3. **Notes 部分**：说明样本演示的内容及其在 3-线程目录中的定位\n\n资料来源：[library/sub-agent-samples/README.md:65-75](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 内容配置与集成\n\n子代理系统通过 Astro 内容配置与文档站点深度集成：\n\n```typescript\n// src/content.config.ts\nschema: docsSchema({\n extend: z.object({\n // 样本特定字段 (W7)\n artifact: z.string().optional(),\n repo_version: z.string().or(z.number()).optional(),\n skill_version: z.string().or(z.number()).optional(),\n created: z.string().or(z.date()).optional(),\n status: z.string().optional(),\n thread: z.string().optional(),\n context: z.string().optional(),\n }),\n})\n```\n\n**样本文件加载规则：**\n\n- 匹配模式：`library/skill-output-samples/**/sample_*.md`\n- 排除模式：\n - `sample_*_legacy_*.md`：历史遗留样本\n - `sample_*_orbit_*.md`：Orbit 线程样本\n\n资料来源：[src/content.config.ts:1-70](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n## 依赖关系\n\n子代理系统基于以下技术栈构建：\n\n| 依赖项 | 版本 | 用途 |\n|---|---|---|\n| Astro | ^6.3.0 | 文档框架 |\n| @astrojs/starlight | ~0.39.0 | 文档主题 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表渲染 |\n| mermaid | ^11.15.0 | 图表生成 |\n| sharp | ^0.34.5 | 图像处理 |\n\n资料来源：[package.json:1-25](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n\n## 样式定制\n\n子代理输出文档中的 Mermaid 图表使用自定义样式：\n\n```css\n/* Mermaid SVG polish */\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n资料来源：[src/styles/custom.css:1-35](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n\n## 子代理调用流程\n\n子代理通过标准化的调用模式与外部 AI 代理（Copilot、Cursor、Windsurf 等）集成：\n\n```mermaid\ngraph LR\n A[外部 AI 代理] -->|调用| B[pm-skills 子代理]\n B -->|审查/审计/生成| C[标准化输出]\n C --> D[用户文档]\n \n E[技能定义] -->|被审计| B\n F[提交记录] -->|被分析| B\n G[产品文档] -->|被审查| B\n```\n\n## 相关文档路径\n\n| 文档类型 | 路径 |\n|---|---|\n| 概念文档 | `docs/concepts/sub-agents.md` |\n| 运行时组件参考 | `docs/reference/runtime-components.md` |\n| 子代理兼容性矩阵 | `docs/reference/sub-agent-compatibility.md` |\n| 子代理定义 | `agents/` |\n| 示例样本库 | `library/sub-agent-samples/` |\n\n资料来源：[_workflows/README.md:1-20](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n---\n\n\n\n## 工作流系统\n\n### 相关页面\n\n相关主题：[子代理系统](#sub-agents), [工具家族](#tool-families)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [docs/workflows/index.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/workflows/index.md)\n- [docs/guides/using-workflows.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-workflows.md)\n- [docs/guides/workflows-guide.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/workflows-guide.md)\n- [_workflows/feature-kickoff.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/feature-kickoff.md)\n- [_workflows/sprint-planning.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/sprint-planning.md)\n- [_workflows/product-strategy.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/product-strategy.md)\n \n\n# 工作流系统\n\n## 概述\n\n工作流系统（Workflows）是 pm-skills 项目中用于定义产品管理（Product Management）流程的核心组件。它通过多技能引导序列（multi-skill workflow）为常见的产品管理流程提供结构化的指导路径。\n\n每个工作流由 `.md` 文件定义，包含一系列产品管理技能的编排，指导用户完成特定的产品管理任务。资料来源：[_workflows/README.md:1-10]()\n\n## 架构设计\n\n### 双目录结构\n\npm-skills 采用源目录与生成目录分离的架构：\n\n```mermaid\ngraph LR\n A[\"_workflows/
(源目录)\"] -->|generate-workflow-pages.py| B[\"docs/workflows/
(生成目录)\"]\n A -->|直接使用| C[\"AI Agents
(Copilot/Cursor/Windsurf)\"]\n```\n\n| 目录 | 用途 | 可编辑性 |\n|------|------|----------|\n| `_workflows/` | 工作流定义源文件 | 可直接编辑 |\n| `docs/workflows/` | 生成的文档站点 | 自动生成，不可手动编辑 |\n\n资料来源：[_workflows/README.md:13-17]()\n\n### 链接约定\n\n工作流文件使用**仓库相对路径**（repo-relative paths）来引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n这种设计使工作流文件能够被 AI 代理（Copilot、Cursor、Windsurf）和仓库浏览器直接使用。资料来源：[_workflows/README.md:7-10]()\n\n## 工作流类型\n\n### 预定义工作流\n\n| 工作流 | 描述 | 源文件 |\n|--------|------|--------|\n| Feature Kickoff | 功能启动流程 | [`_workflows/feature-kickoff.md`](_workflows/feature-kickoff.md) |\n| Sprint Planning | 冲刺规划流程 | [`_workflows/sprint-planning.md`](_workflows/sprint-planning.md) |\n| Product Strategy | 产品战略流程 | [`_workflows/product-strategy.md`](_workflows/product-strategy.md) |\n\n### 工作流结构\n\n每个工作流文件遵循统一的结构：\n\n```mermaid\ngraph TD\n A[\"工作流文件\"] --> B[\"元数据 (Frontmatter)\"]\n A --> C[\"技能序列\"]\n A --> D[\"步骤说明\"]\n B -->|title| E[\"工作流名称\"]\n B -->|description| F[\"工作流描述\"]\n C --> G[\"技能1\"]\n C --> H[\"技能2\"]\n C --> I[\"技能N\"]\n```\n\n## 生成机制\n\n### 生成脚本\n\n工作流文档从 `_workflows/` 目录生成到 `docs/workflows/` 目录，使用专用脚本：\n\n```bash\nscripts/generate-workflow-pages.py\n```\n\n**编辑规则：**\n- 直接编辑 `_workflows/` 中的工作流内容\n- **不要**直接编辑 `docs/workflows/` 中的文件\n- 这些文件由生成脚本自动更新\n\n资料来源：[_workflows/README.md:13-17]()\n\n### 生成配置\n\n在 `src/content.config.ts` 中，工作流文件被纳入 Astro 内容集合：\n\n```typescript\npattern: [\n 'docs/**/*.{md,mdx}',\n 'library/skill-output-samples/**/sample_*.md',\n // ...\n]\n```\n\n资料来源：[src/content.config.ts:7-16]()\n\n## 工作流与子代理系统\n\n### 子代理类型\n\n工作流系统与子代理（Sub-agents）系统协同工作：\n\n| 子代理 | 功能 | 与工作流的关系 |\n|--------|------|----------------|\n| `pm-critic` | 对抗性审查 | 工作流产出的评审 |\n| `pm-skill-auditor` | 技能审计 | 工作流合规性检查 |\n| `pm-changelog-curator` | 变更日志整理 | 发布流程的一部分 |\n| `pm-release-conductor` | 发布编排 | 工作流执行协调 |\n\n资料来源：[library/sub-agent-samples/README.md:1-20]()\n\n### 执行流程\n\n```mermaid\nsequenceDiagram\n participant U as 用户\n participant W as 工作流\n participant S as 子代理\n participant A as AI Agent\n \n U->>W: 选择工作流\n W->>A: 加载技能序列\n A->>S: 调用子代理\n S->>A: 返回结果\n A->>U: 展示结果\n```\n\n## 使用指南\n\n### 编辑工作流\n\n1. 打开 `_workflows/` 目录下的目标工作流文件\n2. 编辑工作流内容和技能序列\n3. 提交更改\n4. 生成脚本自动更新 `docs/workflows/` 目录\n\n### 在 AI 代理中使用\n\n工作流文件可直接被 AI 代理使用：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n引用技能时使用仓库相对路径，确保代理能够正确定位技能文件。\n\n资料来源：[docs/guides/using-workflows.md]()\n\n### 工作流最佳实践\n\n- 保持工作流文件简洁明了\n- 使用一致的技能引用格式\n- 在技能序列中包含清晰的步骤说明\n- 定期审计工作流与实际流程的匹配度\n\n## 相关资源\n\n| 资源 | 路径 | 描述 |\n|------|------|------|\n| 工作流索引 | `docs/workflows/index.md` | 所有工作流的入口页面 |\n| 使用指南 | `docs/guides/using-workflows.md` | 详细的使用说明 |\n| 工作流指南 | `docs/guides/workflows-guide.md` | 工作流系统完整指南 |\n| 技能系统 | `skills/` | 工作流引用的技能定义 |\n| 子代理库 | `library/sub-agent-samples/` | 子代理输出示例 |\n\n---\n\n\n\n## 工具家族\n\n### 相关页面\n\n相关主题：[工作流系统](#workflows), [技能分类体系](#skill-categories)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [docs/concepts/foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/foundation-sprint.md)\n- [docs/concepts/design-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/design-sprint.md)\n- [docs/guides/using-foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-foundation-sprint.md)\n- [docs/guides/using-design-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-design-sprint.md)\n- [docs/reference/workshop-method-comparison.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/workshop-method-comparison.md)\n \n\n# 工具家族\n\n工具家族（Tool Family）是 pm-skills 项目中用于组织和管理产品管理（PM）相关技能的层次化分类体系。该体系通过结构化的方法论框架，将不同的产品管理工作流、技能模板和子代理整合为统一的工具体系。\n\n## 概述\n\npm-skills 的工具家族包含多个核心工具，每个工具对应一个独立的产品管理方法论或工作流程。这些工具被设计为可组合、可扩展的模块，支持从需求发现到产品发布的完整生命周期管理。\n\n### 工具家族的核心组成\n\n| 工具名称 | 类型 | 主要用途 |\n|---------|------|---------|\n| Foundation Sprint | 概念工具 | 需求发现与问题定义 |\n| Design Sprint | 概念工具 | 快速原型与方案验证 |\n| PM 子代理 | 执行代理 | 自动化评审与审查 |\n| 工作流编排 | 流程工具 | 多工具协同作业 |\n\n资料来源：[docs/concepts/foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/foundation-sprint.md)\n\n## 核心工具详解\n\n### Foundation Sprint\n\nFoundation Sprint 是一个结构化的需求发现框架，用于在项目初期明确问题和目标。它强调从用户痛点出发，通过系统化的方法论建立产品基础。\n\n**核心阶段：**\n\n1. **问题发现** - 识别并定义核心用户问题\n2. **假设构建** - 形成可验证的产品假设\n3. **边界明确** - 界定解决方案的范围和约束\n\n资料来源：[docs/guides/using-foundation-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/using-foundation-sprint.md)\n\n### Design Sprint\n\nDesign Sprint 是一个高强度的时间boxed工作坊方法，通常在5天内完成从问题理解到可测试原型的完整流程。\n\n**标准流程：**\n\n```mermaid\ngraph TD\n A[理解问题
Day 1] --> B[发散方案
Day 2]\n B --> C[决策选择
Day 3]\n C --> D[原型制作
Day 4]\n D --> E[用户测试
Day 5]\n```\n\n资料来源：[docs/concepts/design-sprint.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/concepts/design-sprint.md)\n\n## 工具编排与工作流\n\n工具家族支持多种编排模式，允许不同工具之间协同工作以完成复杂的产品管理任务。\n\n### 工作流类型\n\npm-skills 定义了标准化的多工具工作流，通过预定义的 `.md` 文件描述引导序列。\n\n**链接约定：**\n\n工作流文件使用仓库相对路径引用技能：\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n资料来源：[_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n\n### 工作流生成机制\n\n工作流内容在 `_workflows/` 目录中编辑和维护，通过 `scripts/generate-workflow-pages.py` 脚本自动生成到 `docs/workflows/` 目录。\n\n```mermaid\ngraph LR\n A[_workflows/*.md] -->|生成脚本| B[docs/workflows/]\n B --> C[静态站点]\n```\n\n## 子代理体系\n\n工具家族包含一组专门的 PM 子代理，每个子代理负责特定的分析或执行任务。\n\n### 子代理类型\n\n| 子代理 | 功能 | 输出类型 |\n|-------|------|---------|\n| pm-critic | 对抗性评审 | 问题分级报告 |\n| pm-skill-auditor | 技能审计 | 审计发现清单 |\n| pm-changelog-curator | 变更日志整理 | 格式化的变更条目 |\n| pm-release-conductor | 发布流程控制 | 门控状态信封 |\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n### 子代理样本模式\n\n每个子代理样本包含标准化的元数据结构：\n\n- **Frontmatter 字段：** title、description、artifact、version、created、status、thread、context\n- **场景部分：** 触发子代理调用的具体情况\n- **输出部分：** 实际的子代理输出（分级、发现、草案）\n- **注释部分：** 样本演示内容和分类说明\n\n## 叙事线程架构\n\n工具家族通过三条叙事线程覆盖不同的产品管理场景上下文。\n\n### 线程定义\n\n| 线程 | 上下文领域 | 描述 |\n|-----|-----------|------|\n| Brainshelf | 消费者 PKM 应用 | 个人知识管理场景 |\n| Storevine | B2B 营销分析平台 | 数据产品分析场景 |\n| Workbench | 内部平台工具团队 | 平台/DX 产品场景 |\n\n资料来源：[library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n## 方法论对比\n\n工具家族中的不同工具适用于不同的场景和目标。选择合适的方法论对于有效的产品管理至关重要。\n\n### Workshop 方法对比\n\n| 方法 | 目标 | 时长 | 输出物 |\n|-----|------|------|--------|\n| Foundation Sprint | 问题定义与假设构建 | 1-2 周 | 需求文档、假设列表 |\n| Design Sprint | 原型验证与方案选择 | 5 天 | 可测试原型、验证结论 |\n| 敏捷冲刺 | 增量交付与迭代 | 2-4 周 | 可部署功能 |\n\n资料来源：[docs/reference/workshop-method-comparison.md](https://github.com/product-on-purpose/pm-skills/blob/main/docs/reference/workshop-method-comparison.md)\n\n## 技术架构\n\n### 文档生成架构\n\n工具家族的内容通过 Astro Starlight 框架进行管理和发布。\n\n```mermaid\ngraph TD\n A[源文件
docs/, library/] --> B[内容配置
src/content.config.ts]\n B --> C[Starlight 加载器]\n C --> D[静态站点生成]\n D --> E[用户文档站点]\n```\n\n### 内容集合配置\n\n内容集合使用 Astro 的 glob 加载器，支持以下模式：\n\n```typescript\npattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md'\n]\n```\n\n资料来源：[src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n\n### 自定义字段扩展\n\nSchema 扩展包含以下 pm-skills 特定字段：\n\n| 字段 | 类型 | 用途 |\n|-----|------|------|\n| generated | boolean | 标记自动生成内容 |\n| source | string | 原始来源引用 |\n| phase | string | 生命周期阶段 |\n| classification | string | 内容分类 |\n| version | string/number | 版本标识 |\n\n## 使用指南\n\n### 选择合适的工具\n\n1. **明确目标** - 确定当前的产品管理目标\n2. **评估场景** - 匹配目标与工具能力\n3. **组合使用** - 必要时组合多个工具\n\n### 工具集成模式\n\n工具家族支持三种主要集成模式：\n\n**独立使用：**\n单个工具独立解决特定问题，适用于局部优化。\n\n**串联工作：**\n多个工具按顺序使用，形成完整的流程链条。\n\n**并行协作：**\n多个工具同时运行，处理不同的分析维度。\n\n## 最佳实践\n\n- 优先使用结构化的工作流定义文档\n- 子代理输出遵循统一的 P0/P1/P2/P3 问题分级标准\n- 保持叙事线程的一致性，确保上下文连贯\n- 定期审计工具家族的使用效果\n\n## 扩展工具家族\n\n添加新工具到家族中需要：\n\n1. 在 `skills/` 目录创建工具定义\n2. 实现标准化的 SKILL.md 模板\n3. 添加样本输出到 `library/skill-output-samples/`\n4. 更新工作流文档以包含新工具\n\n---\n\n\n\n## 安装与平台配置\n\n### 相关页面\n\n相关主题：[项目介绍](#project-introduction), [样本输出库](#sample-outputs)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [src/styles/custom.css](https://github.com/product-on-purpose/pm-skills/blob/main/src/styles/custom.css)\n- [_workflows/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_workflows/README.md)\n- [_agent-context/codex/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/_agent-context/codex/README.md)\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n\n> **注意**：以下文件在仓库中存在但本次检索未返回实际内容，页面基于现有上下文推理：\n> - `docs/getting-started/index.md`\n> - `docs/getting-started/quickstart.md`\n> - `docs/getting-started/platforms.md`\n> - `scripts/sync-claude.md`\n> - `.claude-plugin/plugin.json`\n\n \n\n# 安装与平台配置\n\n## 概述\n\npm-skills 是一个基于 Astro Starlight 框架构建的产品管理技能文档站点，旨在为产品经理提供系统化的技能、工作流和子代理（sub-agent）指导。 资料来源：[package.json:5-8]()\n\n项目采用现代化前端技术栈，通过 Markdown 文件驱动的文档系统，支持 Mermaid 图表渲染，并集成了 AI 代理（Codex、Claude 等）的协作工作区。 资料来源：[src/content.config.ts:1-4]()\n\n## 环境要求\n\n### 系统依赖\n\n| 组件 | 最低版本 | 说明 |\n|------|----------|------|\n| Node.js | >= 22.12.0 | 必须使用 LTS 或更新版本 |\n| npm/yarn/pnpm | 最新稳定版 | 用于包管理 |\n\n> 项目 `package.json` 中明确指定了 Node.js 引擎要求，低于 22.12.0 的版本将无法正常运行构建脚本。 资料来源：[package.json:7-10]()\n\n### 核心依赖包\n\n| 包名 | 版本 | 用途 |\n|------|------|------|\n| astro | ^6.3.0 | 文档站点框架 |\n| @astrojs/starlight | ~0.39.0 | Starlight 文档主题 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表集成 |\n| sharp | ^0.34.5 | 图片处理优化 |\n\n资料来源：[package.json:13-20]()\n\n## 安装步骤\n\n### 1. 克隆仓库\n\n```bash\ngit clone https://github.com/product-on-purpose/pm-skills.git\ncd pm-skills\n```\n\n### 2. 安装依赖\n\n```bash\nnpm install\n```\n\n该命令会根据 `package.json` 中的依赖声明自动安装所有必要的包。\n\n### 3. 开发模式启动\n\n```bash\nnpm run dev\n```\n\n启动后访问 `http://localhost:4321` 查看本地文档站点。开发模式支持热重载，文档修改后页面会自动刷新。\n\n### 4. 构建生产版本\n\n```bash\nnpm run build\n```\n\n构建过程包含两个步骤：\n\n1. `astro build` - 生成静态站点\n2. `node scripts/post-build-strip-md-links.mjs` - 移除 Markdown 链接的后处理脚本\n\n资料来源：[package.json:11-15]()\n\n### 5. 预览构建结果\n\n```bash\nnpm run preview\n```\n\n## 平台配置\n\n### 文档内容配置\n\npm-skills 使用 Astro 的内容集合（Content Collections）系统管理文档。核心配置位于 `src/content.config.ts`。 资料来源：[src/content.config.ts:1-6]()\n\n#### 内容集合架构\n\n```mermaid\ngraph TD\n A[docs/ 目录] --> B[Markdown/MDX 文件]\n A --> C[library/skill-output-samples/]\n B --> D[skills/ 技能定义]\n B --> E[guides/ 使用指南]\n B --> F[workflows/ 工作流]\n B --> G[reference/ 参考文档]\n C --> H[sample_*.md 示例输出]\n D --> I[define-hypothesis/]\n D --> J[utility-pm-*/]\n```\n\n#### 内容加载规则\n\n`content.config.ts` 中定义的内容加载器使用 glob 模式匹配，支持以下文件包含和排除逻辑： 资料来源：[src/content.config.ts:35-43]()\n\n| 模式类型 | 路径模式 | 说明 |\n|----------|----------|------|\n| 包含 | `docs/**/*.{md,mdx}` | 文档目录下的所有 Markdown 文件 |\n| 排除 | `!docs/internal/**` | 内部工作文件（gitignored） |\n| 排除 | `!docs/templates/**` | 模板目录 |\n| 排除 | `!docs/**/README.md` | 目录级 README 文件 |\n| 包含 | `library/skill-output-samples/**/sample_*.md` | 技能输出示例 |\n| 排除 | `!library/skill-output-samples/**/sample_*_legacy_*.md` | 历史遗留示例 |\n| 排除 | `!library/skill-output-samples/**/sample_*_orbit_*.md` | Orbit 相关示例 |\n\n#### 自定义 Slug 生成\n\n系统采用自定义 ID 生成策略，将不同路径的前缀统一处理为干净的 slug： 资料来源：[src/content.config.ts:45-57]()\n\n| 原始路径 | 生成 Slug |\n|----------|-----------|\n| `docs/foo/bar.md` | `foo/bar` |\n| `docs/skills/index.md` | `skills` |\n| `library/skill-output-samples/define-hypothesis/sample_X.md` | `samples/define-hypothesis/sample_X` |\n| `docs/section/README.md` | `section/readme` |\n\n### 自定义字段模式\n\n内容集合扩展了 Starlight 的 `docsSchema`，支持以下 pm-skills 专用字段： 资料来源：[src/content.config.ts:63-82]()\n\n| 字段名 | 类型 | 说明 |\n|--------|------|------|\n| `generated` | boolean | 标记是否为自动生成内容 |\n| `source` | string | 原始来源路径 |\n| `phase` | string | 开发阶段 |\n| `classification` | string | 分类标签 |\n| `version` | string \\| number | 版本号（支持 semver 格式） |\n| `updated` | string \\| Date | 更新时间 |\n| `artifact` | string | 子代理输出类型 |\n| `repo_version` | string \\| number | 仓库版本 |\n| `created` | string \\| Date | 创建时间 |\n| `status` | string | 状态标记 |\n| `thread` | string | 叙事线程（brainshelf/storevine/workbench） |\n| `context` | string | 上下文描述 |\n\n### Mermaid 图表配置\n\n项目在 `src/styles/custom.css` 中为 Mermaid 图表定义了统一的视觉风格： 资料来源：[src/styles/custom.css:1-32]()\n\n#### 样式规则\n\n```css\n/* 图表容器 */\n.mermaid {\n max-width: 100%;\n}\n\n/* SVG 自适应 */\n.mermaid svg {\n max-width: 100%;\n height: auto;\n}\n\n/* 连线样式 */\n.mermaid .edgePath path,\n.mermaid .flowchart-link {\n stroke-width: 1.75px;\n}\n\n/* 节点圆角 */\n.mermaid .node rect {\n rx: 6;\n ry: 6;\n}\n\n/* 集群背景透明度 */\n.mermaid .cluster rect {\n fill-opacity: 0.4;\n}\n```\n\n这些样式在浅色和深色模式下均生效，覆盖所有图表类型（流程图、序列图、甘特图等）。\n\n## AI 代理集成\n\n### Codex 工作区策略\n\n仓库为 Codex AI 代理维护了一个专用工作区 `_agent-context/codex/`，其中包含以下策略文件： 资料来源：[_agent-context/codex/README.md:1-8]()\n\n| 文件 | 用途 |\n|------|------|\n| `CONTEXT.md` | 稳定的当前状态事实 |\n| `DECISIONS.md` | 已接受的决策及理由 |\n| `WRAP-SESSION_TEMPLATE.md` | 交接模板 |\n| `WORKTREE-PRIMER.md` | 干净分支工作流指南 |\n\n### 本地忽略文件\n\n以下文件类型被 Git 忽略，仅在本地保留： 资料来源：[_agent-context/codex/README.md:11-13]()\n\n- `PLANNING/**` - 探索性规划草稿\n- `TODO.md` - 临时任务\n- `AGENTS/SESSION-LOG/` - 会话日志目录\n\n### 会话日志规范\n\n会话交接文件按以下命名规范存储： 资料来源：[_agent-context/codex/README.md:19-21]()\n\n```\nAGENTS/SESSION-LOG/YYYY-MM-DD[_HH-MM]_codex_.md\n```\n\n文件名中包含模型名称（`_codex_`），使 Claude 和 Codex 的会话可以在同一目录下按日期共存。\n\n## 工作流与技能系统\n\n### 工作流定义\n\n工作流文件位于 `_workflows/` 目录，每个 `.md` 文件定义一个多技能工作流，指导用户完成常见的产品管理流程。 资料来源：[_workflows/README.md:1-8]()\n\n#### 链接约定\n\n工作流文件使用仓库相对路径引用技能： 资料来源：[_workflows/README.md:10-13]()\n\n```markdown\n[`define-hypothesis`](../skills/define-hypothesis/SKILL.md)\n```\n\n此约定确保 AI 代理（Copilot、Cursor、Windsurf 等）和仓库浏览器可以直接使用这些链接。\n\n#### 编辑策略\n\n- 在 `_workflows/` 目录编辑工作流内容\n- **不要**直接编辑 `docs/workflows/` 目录\n- `docs/workflows/` 文件由 `scripts/generate-workflow-pages.py` 脚本从源目录自动生成\n\n### 子代理库\n\n`library/sub-agent-samples/` 目录包含每个 pm-skills 子代理的真实输出示例： 资料来源：[library/sub-agent-samples/README.md:1-12]()\n\n| 子代理 | 功能 |\n|--------|------|\n| `pm-critic` | 对 PRD、OKR、会议纪要进行对抗性审查 |\n| `pm-skill-auditor` | 审计技能定义的完整性和一致性 |\n| `pm-changelog-curator` | 生成符合规范的变更日志草稿 |\n| `pm-release-conductor` | 编排发布流程的门控检查 |\n\n#### 叙事线程\n\n示例覆盖三个叙事场景： 资料来源：[library/sub-agent-samples/README.md:92-101]()\n\n| 线程 | 场景 | 上下文 |\n|------|------|--------|\n| **Brainshelf** | 消费者 PKM 应用 | 产品经理的消费品视角 |\n| **Storevine** | B2B 营销分析平台 | 数据产品的 PM 视角 |\n| **Workbench** | 内部平台工具团队 | 平台/DX 的 PM 视角 |\n\n## 常见问题排查\n\n### 节点版本不匹配\n\n如果遇到构建错误，首先检查 Node.js 版本：\n\n```bash\nnode --version\n```\n\n确保版本 >= 22.12.0。\n\n### 内容未出现在站点\n\n检查 `src/content.config.ts` 中的 glob 模式是否正确匹配目标文件，确保文件不在排除列表中。\n\n### Mermaid 图表不渲染\n\n确保 `astro-mermaid` 依赖已正确安装，且 Mermaid 语法符合规范。样式问题可参考 `src/styles/custom.css` 中的自定义规则。\n\n---\n\n\n\n## 样本输出库\n\n### 相关页面\n\n相关主题：[技能结构解析](#skill-anatomy), [安装与平台配置](#installation-guide)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [library/sub-agent-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/sub-agent-samples/README.md)\n- [src/content.config.ts](https://github.com/product-on-purpose/pm-skills/blob/main/src/content.config.ts)\n- [library/skill-output-samples/README.md](https://github.com/product-on-purpose/pm-skills/blob/main/library/skill-output-samples/README.md)\n- [package.json](https://github.com/product-on-purpose/pm-skills/blob/main/package.json)\n \n\n# 样本输出库\n\n样本输出库（Skill Output Samples Library）是 pm-skills 项目中用于存储、分类和展示子代理（sub-agent）实际输出的标准化示例集合。该库为项目维护者、AI 代理和人类审查者提供了可验证的参考基准，确保子代理在不同场景下的行为符合预期规范。\n\n## 设计目标与核心价值\n\n样本输出库的核心价值体现在以下几个方面：\n\n1. **行为验证**：通过真实输出样本验证子代理的批评、审计、变更日志生成和发布流程控制等能力\n2. **规范参照**：为 AI 代理（Copilot、Cursor、Windsurf）提供可学习的标准输出模式\n3. **回归测试**：在代码变更后可通过对比样本输出检测行为漂移\n4. **文档支撑**：为用户指南和贡献者文档提供具体案例\n\n资料来源：[library/sub-agent-samples/README.md:1-15]()\n\n## 目录结构\n\n样本输出库采用分层目录结构，按子代理类型和叙事线程进行双重分类：\n\n```\nlibrary/sub-agent-samples/\n├── pm-critic/\n│ ├── sample_pm-critic_brainshelf_prd-review.md\n│ ├── sample_pm-critic_storevine_okr-review.md\n│ └── sample_pm-critic_workbench_meeting-recap-review.md\n├── pm-skill-auditor/\n│ ├── sample_pm-skill-auditor_brainshelf_pre-release.md\n│ ├── sample_pm-skill-auditor_storevine_drift-detection.md\n│ └── sample_pm-skill-auditor_workbench_cross-cutting.md\n├── pm-changelog-curator/\n│ ├── sample_pm-changelog-curator_brainshelf_minor-release.md\n│ ├── sample_pm-changelog-curator_storevine_patch-release.md\n│ └── sample_pm-changelog-curator_workbench_feature-release.md\n└── pm-release-conductor/\n ├── sample_pm-release-conductor_brainshelf_clean-run.md\n ├── sample_pm-release-conductor_storevine_gate-failure.md\n └── sample_pm-release-conductor_workbench_chained-run.md\n```\n\n资料来源：[library/sub-agent-samples/README.md:18-33]()\n\n## 子代理类型\n\npm-skills 项目定义了四个核心子代理，每个子代理产生特定类型的输出样本：\n\n| 子代理名称 | 功能描述 | 输出类型 | 样本数量 |\n|---|---|---|---|\n| `pm-critic` | 对 PRD、OKR、会议决策等进行对抗性评审 | 分级评审报告（P0-P3） | 3 |\n| `pm-skill-auditor` | 审计技能定义的完整性和一致性 | 审计发现清单 | 3 |\n| `pm-changelog-curator` | 根据提交历史生成变更日志 | 结构化变更条目 | 3 |\n| `pm-release-conductor` | 控制多阶段发布门控流程 | 门控状态信封 | 3 |\n\n资料来源：[library/sub-agent-samples/README.md:34-45]()\n\n## 叙事线程体系\n\n样本输出库采用三个叙事线程（Thread）作为场景化背景，确保样本输出覆盖不同产品管理上下文：\n\n### Brainshelf - 消费级 PKM 应用\n\n个人知识管理（PKM）应用场景，捕获消费者产品管理上下文。典型问题域包括：\n- 文档完整性验证\n- 假设定义与验证\n- 竞品分析\n\n资料来源：[library/sub-agent-samples/README.md:118-120]()\n\n### Storevine - B2B 营销分析平台\n\nB2B 营销分析平台场景，捕获数据分析与数据产品管理上下文。典型问题域包括：\n- OKR 设置与评审\n- 聚合计数器管理\n- 上下文漂移检测\n\n资料来源：[library/sub-agent-samples/README.md:122-124]()\n\n### Workbench - 内部平台工具团队\n\n内部平台与开发者体验（DX）管理上下文。典型问题域包括：\n- 会议决策追踪\n- 跨切面技能审计\n- 链式发布编排\n\n资料来源：[library/sub-agent-samples/README.md:126-128]()\n\n## 样本文件结构\n\n每个样本文件采用标准化 YAML frontmatter 元数据格式：\n\n```yaml\n---\ntitle: <样本标题>\ndescription: <样本描述>\nartifact: <子代理输出类型>\nversion: <版本号>\nrepo_version: <仓库版本>\nagent_version: <代理版本>\ncreated: <创建日期>\nstatus: sample\nthread: <叙事线程>\ncontext: <场景上下文>\n---\n```\n\n关键字段说明：\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `title` | string | 样本的人类可读标题 |\n| `artifact` | string | 子代理输出类型（如 grading-report、audit-findings） |\n| `thread` | string | 叙事线程标识（brainshelf/storevine/workbench） |\n| `status` | string | 固定值 `sample`，标识文件类型 |\n| `created` | string/date | ISO 格式日期，YAML 可能解析为 Date 对象 |\n\n资料来源：[library/sub-agent-samples/README.md:54-68]()\n\n## 问题严重性分级\n\n样本输出遵循统一的 P0-P3 问题严重性分级体系：\n\n| 级别 | 名称 | 说明 | 典型示例 |\n|---|---|---|---|\n| P0 | 关键 | 必须立即修复，如合同违规、拒绝协议失效 | 伪造基线数据、关键决策缺失所有者 |\n| P1 | 重要 | 应在当前周期内修复 | 前瞻性审计发现、实验设计缺陷 |\n| P2 | 中等 | 应在合理周期内修复 | 预期漂移、可验证性不足 |\n| P3 | 低 | 建议改进 | 文档清晰度、格式一致性 |\n\n资料来源：[library/sub-agent-samples/README.md:34-50]()\n\n## 工作流程\n\n样本从创建到发布的完整工作流程如下：\n\n```mermaid\ngraph TD\n A[场景定义] --> B[子代理执行]\n B --> C[输出捕获]\n C --> D[前端元数据标注]\n D --> E[样本文件写入]\n E --> F[内容配置加载]\n F --> G[文档站点发布]\n \n H[维护者审查] --> I{命名规范检查}\n I -->|通过| E\n I -->|失败| J[重命名排除]\n \n J --> K[保留磁盘历史]\n K -.-> L[不发布到站点]\n```\n\n### 样本命名约定\n\n样本文件名遵循严格的命名模式：\n\n```\nsample___.md\n```\n\n示例：\n- `sample_pm-critic_brainshelf_prd-review.md`\n- `sample_pm-release-conductor_workbench_chained-run.md`\n\n不符合命名模式的文件将被内容配置排除，不发布到文档站点，但保留在磁盘上供历史参考。\n\n资料来源：[src/content.config.ts:25-30]()\n\n## 内容配置集成\n\n样本输出库通过 Astro 内容加载器与文档站点深度集成。配置位于 `src/content.config.ts`：\n\n```typescript\nloader: glob({\n pattern: [\n 'docs/**/*.{md,mdx}',\n '!docs/internal/**',\n '!docs/templates/**',\n '!docs/**/README.md',\n 'library/skill-output-samples/**/sample_*.md',\n '!library/skill-output-samples/**/sample_*_legacy_*.md',\n '!library/skill-output-samples/**/sample_*_orbit_*.md',\n ],\n base: '.',\n})\n```\n\n### 排除规则\n\n以下文件被排除在站点发布之外：\n\n| 排除模式 | 原因 |\n|---|---|\n| `sample_*_legacy_*.md` | 历史遗留样本（9个），保留磁盘记录 |\n| `sample_*_orbit_*.md` | Orbit 线程样本（2个），保留磁盘记录 |\n| `docs/internal/**` | 发布计划和工作笔记，不对外公开 |\n| `docs/templates/**` | 使用 `` 语法导致 YAML 解析问题 |\n\n资料来源：[src/content.config.ts:18-30]()\n\n### Slug 生成规则\n\n样本文件的 URL slug 通过 `generateId` 函数自动生成：\n\n```javascript\n// library/skill-output-samples/define-hypothesis/sample_X.md\n// → slug: 'samples/define-hypothesis/sample_X'\n```\n\n| 原始路径 | 生成 Slug |\n|---|---|\n| `docs/foo/bar.md` | `foo/bar` |\n| `docs/skills/index.md` | `skills` |\n| `library/skill-output-samples/define-hypothesis/sample_X.md` | `samples/define-hypothesis/sample_X` |\n\n资料来源：[src/content.config.ts:36-45]()\n\n## 示例场景说明\n\n### PRD 对抗性评审\n\n`pm-critic` 子代理对 Brainshelf 应用的产品需求文档进行评审，输出包含：\n- 1 个 P0 合同完整性问题\n- 3 个 P1 可证伪性设计缺陷\n- 2 个 P2 实验设计问题\n- 1 个 P3 文档清晰度建议\n\n资料来源：[library/sub-agent-samples/README.md:35-36]()\n\n### 发布门控流程\n\n`pm-release-conductor` 子代理在 Workbench 项目中执行链式干运行：\n- 审计门控 G0 和 G2.5 阶段\n- 变更日志门控 G2 阶段\n- 分层 Status 信封输出\n\n资料来源：[library/sub-agent-samples/README.md:48-49]()\n\n## 扩展前端字段\n\n样本文件支持额外的 YAML 前端字段，由 Astro schema 定义：\n\n```typescript\nschema: docsSchema({\n extend: z.object({\n generated: z.boolean().optional(),\n source: z.string().optional(),\n phase: z.string().optional(),\n classification: z.string().optional(),\n artifact: z.string().optional(),\n repo_version: z.string().or(z.number()).optional(),\n skill_version: z.string().or(z.number()).optional(),\n created: z.string().or(z.date()).optional(),\n status: z.string().optional(),\n thread: z.string().optional(),\n context: z.string().optional(),\n tags: z.array(z.string()).optional(),\n draft: z.boolean().optional(),\n }),\n})\n```\n\n这些字段支持：\n- `generated`: 标记自动生成的内容\n- `source`: 溯源引用\n- `phase`: 处理阶段\n- `tags`: 分类标签\n\n资料来源：[src/content.config.ts:56-77]()\n\n## 技术栈依赖\n\n样本输出库的展示依赖于以下技术组件：\n\n| 组件 | 版本 | 用途 |\n|---|---|---|\n| Astro | ^6.3.0 | 静态站点生成框架 |\n| @astrojs/starlight | ~0.39.0 | 文档主题系统 |\n| astro-mermaid | ~2.0.1 | Mermaid 图表渲染 |\n| mermaid | ^11.15.0 | 图表定义语言 |\n\n资料来源：[package.json:1-20]()\n\n## 维护指南\n\n### 添加新样本\n\n1. 在对应的 `library/sub-agent-samples//` 目录创建文件\n2. 使用 `sample___.md` 命名模式\n3. 填写标准化的 YAML frontmatter\n4. 在 `Scenario` 部分描述触发场景\n5. 在 `Output` 部分展示实际代理输出\n6. 在 `Notes` 部分说明样本的演示目的\n\n### 样本验证清单\n\n- [ ] 文件名符合命名约定\n- [ ] frontmatter 包含所有必需字段\n- [ ] P0-P3 分级与实际内容一致\n- [ ] 场景上下文与叙事线程匹配\n- [ ] 无敏感信息泄露\n\n## 相关资源\n\n- 子代理定义：[agents/](../../agents/)\n- 技能定义：[skills/](../../skills/)\n- 运行时组件：[docs/reference/runtime-components.md](../../docs/reference/runtime-components.md)\n- 对抗性评审指南：[docs/guides/adversarial-review.md](../../docs/guides/adversarial-review.md)\n- 发布手册：[docs/contributing/release-runbook.md](../../docs/contributing/release-runbook.md)\n\n资料来源：[library/sub-agent-samples/README.md:130-137]()\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：product-on-purpose/pm-skills\n\n摘要：发现 14 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `pm-skills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令: `npx skills`\n- 防护动作: 页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | repo=pm-skills; install=skills\n\n## 2. 安装坑 · 来源证据：[F-14] Workflow Builder (/workflow-builder)\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-14] Workflow Builder (/workflow-builder)\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_fd2240d9f58c49edbcc147428ff9b561 | https://github.com/product-on-purpose/pm-skills/issues/133 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：[F-15] Ad-Hoc Skill Chaining (/chain)\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-15] Ad-Hoc Skill Chaining (/chain)\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_151a0a8448c84b81b626bf03b88d2714 | https://github.com/product-on-purpose/pm-skills/issues/134 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：v2.11.1 - skills.sh CLI Compatibility Patch\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v2.11.1 - skills.sh CLI Compatibility Patch\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_55aa5dc614634b48a39a0310a9b5fd45 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 5. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作: 涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | host_targets=claude, claude_code\n\n## 6. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作: 假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | README/documentation is current enough for a first validation pass.\n\n## 7. 维护坑 · 来源证据：[M-21] Explore release-please Integration\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：[M-21] Explore release-please Integration\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_acdd9d4cd91c449f964bf1924ec0b6e1 | https://github.com/product-on-purpose/pm-skills/issues/136 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 8. 维护坑 · 来源证据：v2.12.0 OKR Skills Launch\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：v2.12.0 OKR Skills Launch\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_f2a160e56ca04946816b63eab92a85cd | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 9. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作: 维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | last_activity_observed missing\n\n## 10. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作: 下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作: 评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n\n## 12. 安全/权限坑 · 来源证据：v2.13.1\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.13.1\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e5dab862059242fd8f82b7814ef33eb8 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.13.1 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 13. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作: issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | issue_or_pr_quality=unknown\n\n## 14. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作: 发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | release_recency=unknown\n\n\n",
"summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
"title": "Human Manual / 人类版说明书"
},
"pitfall_log": {
"asset_id": "pitfall_log",
"filename": "PITFALL_LOG.md",
"markdown": "# Pitfall Log / 踩坑日志\n\n项目：product-on-purpose/pm-skills\n\n摘要：发现 14 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `pm-skills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令: `npx skills`\n- 防护动作: 页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | repo=pm-skills; install=skills\n\n## 2. 安装坑 · 来源证据：[F-14] Workflow Builder (/workflow-builder)\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-14] Workflow Builder (/workflow-builder)\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_fd2240d9f58c49edbcc147428ff9b561 | https://github.com/product-on-purpose/pm-skills/issues/133 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：[F-15] Ad-Hoc Skill Chaining (/chain)\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[F-15] Ad-Hoc Skill Chaining (/chain)\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_151a0a8448c84b81b626bf03b88d2714 | https://github.com/product-on-purpose/pm-skills/issues/134 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：v2.11.1 - skills.sh CLI Compatibility Patch\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v2.11.1 - skills.sh CLI Compatibility Patch\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_55aa5dc614634b48a39a0310a9b5fd45 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.11.1 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 5. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作: 涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | host_targets=claude, claude_code\n\n## 6. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作: 假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | README/documentation is current enough for a first validation pass.\n\n## 7. 维护坑 · 来源证据：[M-21] Explore release-please Integration\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：[M-21] Explore release-please Integration\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_acdd9d4cd91c449f964bf1924ec0b6e1 | https://github.com/product-on-purpose/pm-skills/issues/136 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 8. 维护坑 · 来源证据：v2.12.0 OKR Skills Launch\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：v2.12.0 OKR Skills Launch\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_f2a160e56ca04946816b63eab92a85cd | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.12.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 9. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作: 维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | last_activity_observed missing\n\n## 10. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作: 下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作: 评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | no_demo; severity=medium\n\n## 12. 安全/权限坑 · 来源证据：v2.13.1\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.13.1\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e5dab862059242fd8f82b7814ef33eb8 | https://github.com/product-on-purpose/pm-skills/releases/tag/v2.13.1 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 13. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作: issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | issue_or_pr_quality=unknown\n\n## 14. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作: 发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1130952330 | https://github.com/product-on-purpose/pm-skills | release_recency=unknown\n",
"summary": "用户实践前最可能遇到的身份、安装、配置、运行和安全坑。",
"title": "Pitfall Log / 踩坑日志"
},
"prompt_preview": {
"asset_id": "prompt_preview",
"filename": "PROMPT_PREVIEW.md",
"markdown": "# pm-skills - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 pm-skills 的“安装前体验版”。\n这不是项目介绍、不是评价报告、不是 README 总结。你的任务是让我用最小成本体验它的核心服务。\n\n我的试用任务：我想用它完成一个真实的软件开发与交付任务。\n我常用的宿主 AI：claude / Claude Code\n\n【体验目标】\n围绕我的真实任务，现场演示这个项目如何把输入转成 步骤建议, 检查清单, 专业工作流。重点是让我感受到工作方式，而不是给我项目背景。\n\n【业务流约束】\n- 你必须像一个正在提供服务的项目能力包，而不是像一个讲解员。\n- 每一轮只推进一个步骤；提出问题后必须停下来等我回答。\n- 每一步都必须让我感受到一个具体服务动作：澄清、整理、规划、检查、判断或收尾。\n- 每一步都要说明：当前目标、你需要我提供什么、我回答后你会产出什么。\n- 不要安装、不要运行命令、不要写代码、不要声称测试通过、不要声称已经修改文件。\n- 需要真实安装或宿主加载后才能验证的内容，必须明确说“这一步需要安装后验证”。\n- 如果我说“用示例继续”，你可以用虚构示例推进，但仍然不能声称真实执行。\n\n【可体验服务能力】\n- AI Skill / Agent 指令资产库: 项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 输入：用户任务, 宿主 AI 对话上下文, 项目内 Skill/Agent 文档；输出：步骤建议, 检查清单, 专业工作流。\n\n【必须安装后才可验证的能力】\n- 多宿主安装与分发: 项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 输入：宿主 AI 工具, 插件配置, 安装命令；输出：宿主内可发现的插件/技能集合。\n- 命令行启动或安装流程: 项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 输入：终端环境, 包管理器, 项目依赖；输出：安装结果, 列表/更新/运行结果。\n\n【核心服务流】\n请严格按这个顺序带我体验。不要一次性输出完整流程：\n1. project-introduction：项目介绍。围绕“项目介绍”模拟一次用户任务，不展示安装或运行结果。\n2. skill-library-overview：技能库概览。围绕“技能库概览”模拟一次用户任务，不展示安装或运行结果。\n3. skill-anatomy：技能结构解析。围绕“技能结构解析”模拟一次用户任务，不展示安装或运行结果。\n4. skill-lifecycle：技能生命周期管理。围绕“技能生命周期管理”模拟一次用户任务，不展示安装或运行结果。\n5. sub-agents：子代理系统。围绕“子代理系统”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. project-introduction\n输入：用户提供的“项目介绍”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. skill-library-overview\n输入：用户提供的“技能库概览”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. skill-anatomy\n输入：用户提供的“技能结构解析”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. skill-lifecycle\n输入：用户提供的“技能生命周期管理”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n5. sub-agents\n输入：用户提供的“子代理系统”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / project-introduction：Step 1 必须围绕“项目介绍”形成一个小中间产物，并等待用户确认。\n- Step 2 / skill-library-overview：Step 2 必须围绕“技能库概览”形成一个小中间产物，并等待用户确认。\n- Step 3 / skill-anatomy：Step 3 必须围绕“技能结构解析”形成一个小中间产物，并等待用户确认。\n- Step 4 / skill-lifecycle：Step 4 必须围绕“技能生命周期管理”形成一个小中间产物，并等待用户确认。\n- Step 5 / sub-agents：Step 5 必须围绕“子代理系统”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/product-on-purpose/pm-skills\n- https://github.com/product-on-purpose/pm-skills#readme\n- docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md\n- docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md\n- docs/templates/skill-template/SKILL.md\n- skills/define-hypothesis/SKILL.md\n- skills/define-jtbd-canvas/SKILL.md\n- skills/define-opportunity-tree/SKILL.md\n- skills/define-problem-statement/SKILL.md\n- skills/deliver-acceptance-criteria/SKILL.md\n- skills/deliver-edge-cases/SKILL.md\n- skills/deliver-launch-checklist/SKILL.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 pm-skills 的核心服务。\n2. 当前步骤：明确进入 Step 1，并说明这一步要解决什么。\n3. 你会如何服务我：说明你会先改变我完成任务的哪个动作。\n4. 只问我 3 个问题，然后停下等待回答。\n\n首次回复禁止输出：后续完整流程、证据清单、安装命令、项目评价、营销文案、已经安装或运行的说法。\n\nStep 1 / brainstorming 的二轮协议：\n- 我回答首次三问后，你仍然停留在 Step 1 / brainstorming，不要进入 Step 2。\n- 第二次回复必须产出 6 个部分：澄清后的任务定义、成功标准、边界条件、\n 2-3 个可选方案、每个方案的权衡、推荐方案。\n- 第二次回复最后必须问我是否确认推荐方案；只有我明确确认后，才能进入下一步。\n- 第二次回复禁止输出 git worktree、代码计划、测试文件、命令或真实执行结果。\n\n后续对话规则：\n- 我回答后，你先完成当前步骤的中间产物并等待确认；只有我确认后，才能进入下一步。\n- 每一步都要生成一个小的中间产物，例如澄清后的目标、计划草案、测试意图、验证清单或继续/停止判断。\n- 所有演示都写成“我会建议/我会引导/这一步会形成”，不要写成已经真实执行。\n- 不要声称已经测试通过、文件已修改、命令已运行或结果已产生。\n- 如果某个能力必须安装后验证，请直接说“这一步需要安装后验证”。\n- 如果证据不足，请明确说“证据不足”，不要补事实。\n```\n",
"summary": "不安装项目也能感受能力节奏的安全试用 Prompt。",
"title": "Prompt Preview / 安装前试用 Prompt"
},
"quick_start": {
"asset_id": "quick_start",
"filename": "QUICK_START.md",
"markdown": "# Quick Start / 官方入口\n\n项目：product-on-purpose/pm-skills\n\n## 官方安装入口\n\n### Node.js / npx · 官方安装入口\n\n```bash\nnpx skills\n```\n\n来源：https://github.com/product-on-purpose/pm-skills#readme\n\n## 来源\n\n- repo: https://github.com/product-on-purpose/pm-skills\n- docs: https://github.com/product-on-purpose/pm-skills#readme\n",
"summary": "从项目官方 README 或安装文档提取的开工入口。",
"title": "Quick Start / 官方入口"
}
},
"validation_id": "dval_cc1ee5e3a68649afb70f283d91795cd3"
}