{ "canonical_name": "coreyhaines31/marketingskills", "compilation_id": "pack_185f94eead8f40989e69b2edbf303bbd", "created_at": "2026-05-11T17:57:18.294924+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_e9a0f2ae76194510a75b82366c6ab9ce" }, "feedback_event_type": "project_pack_compilation_feedback", "learning_candidate_reasons": [], "template_gaps": [] }, "identity": { "canonical_id": "project_2516f5ef449745e98d6cab05315dd891", "canonical_name": "coreyhaines31/marketingskills", "homepage_url": null, "license": "unknown", "repo_url": "https://github.com/coreyhaines31/marketingskills", "slug": "marketingskills", "source_packet_id": "phit_4bd984dc46d64c7e993e196d193cd3d6", "source_validation_id": "dval_d436df076e8348609d8f07e74d4f2057" }, "merchandising": { "best_for": "需要内容营销与增长能力，并使用 claude的用户", "github_forks": 4549, "github_stars": 28210, "one_liner_en": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.", "one_liner_zh": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.", "primary_category": { "category_id": "content-growth", "confidence": "high", "name_en": "Content & Growth", "name_zh": "内容营销与增长", "reason": "matched_keywords:marketing, growth, seo" }, "target_user": "使用 claude, claude_code 等宿主 AI 的用户", "title_en": "marketingskills", "title_zh": "marketingskills 能力包", "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": "Structured Data Extraction", "label_zh": "结构化数据提取", "source": "repo_evidence_project_characteristics", "tag_id": "core_capability-structured-data-extraction", "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": "Open Source Tool", "label_zh": "开源工具", "source": "repo_evidence_project_characteristics", "tag_id": "selection_signal-open-source-tool", "type": "selection_signal" } ] }, "packet_id": "phit_4bd984dc46d64c7e993e196d193cd3d6", "page_model": { "artifacts": { "artifact_slug": "marketingskills", "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/coreyhaines31/marketingskills#readme", "verified": true } ], "display_tags": [ "MCP 工具", "知识库问答", "结构化数据提取", "节点式流程编排", "开源工具" ], "eyebrow": "内容营销与增长", "glance": [ { "body": "判断自己是不是目标用户。", "label": "最适合谁", "value": "需要内容营销与增长能力，并使用 claude的用户" }, { "body": "先理解能力边界，再决定是否继续。", "label": "核心价值", "value": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering." }, { "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": "仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。", "category": "身份坑", "evidence": [ "identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills" ], "severity": "medium", "suggested_check": "在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。", "title": "仓库名和安装名不一致", "user_impact": "用户照着仓库名搜索包或照着包名找仓库时容易走错入口。" }, { "body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support", "category": "安装坑", "evidence": [ "community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。", "title": "来源证据：Add OpenAI Codex plugin support", "user_impact": "可能增加新用户试用和生产接入成本。" }, { "body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace", "category": "安装坑", "evidence": [ "community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：Create official marketing skills plugin for Claude Code plugin marketplace", "user_impact": "可能增加新用户试用和生产接入成本。" }, { "body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills", "category": "安装坑", "evidence": [ "community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。", "title": "来源证据：Feature Request: Add Prefix to skills", "user_impact": "可能增加新用户试用和生产接入成本。" }, { "body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand", "category": "安装坑", "evidence": [ "community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand", "user_impact": "可能影响升级、迁移或版本选择。" }, { "body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix", "category": "安装坑", "evidence": [ "community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：v1.9.0 — image skill, video skill, plugin fix", "user_impact": "可能增加新用户试用和生产接入成本。" }, { "body": "项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。", "category": "配置坑", "evidence": [ "capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | 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:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass." ], "severity": "medium", "suggested_check": "将假设转成下游验证清单。", "title": "能力判断依赖假设", "user_impact": "假设不成立时，用户拿不到承诺的能力。" }, { "body": "未记录 last_activity_observed。", "category": "维护坑", "evidence": [ "evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | 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:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium" ], "severity": "medium", "suggested_check": "进入安全/权限治理复核队列。", "title": "下游验证发现风险项", "user_impact": "下游已经要求复核，不能在页面中弱化。" }, { "body": "No sandbox install has been executed yet; downstream must verify before user use.", "category": "安全/权限坑", "evidence": [ "risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use." ], "severity": "medium", "suggested_check": "转成明确权限清单和安全审查提示。", "title": "存在安全注意事项", "user_impact": "用户安装前需要知道权限边界和敏感操作。" }, { "body": "no_demo", "category": "安全/权限坑", "evidence": [ "risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium" ], "severity": "medium", "suggested_check": "把风险写入边界卡，并确认是否需要人工复核。", "title": "存在评分风险", "user_impact": "风险会影响是否适合普通用户安装。" }, { "body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More", "category": "安全/权限坑", "evidence": [ "community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More", "user_impact": "可能影响授权、密钥配置或安全边界。" }, { "body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools", "category": "安全/权限坑", "evidence": [ "community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools", "user_impact": "可能影响授权、密钥配置或安全边界。" }, { "body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw", "category": "安全/权限坑", "evidence": [ "community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw", "user_impact": "可能影响授权、密钥配置或安全边界。" }, { "body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK", "category": "安全/权限坑", "evidence": [ "community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。" ], "severity": "medium", "suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。", "title": "来源证据：v1.7.0 — ASO audit skill, Zapier SDK", "user_impact": "可能影响授权、密钥配置或安全边界。" } ], "source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals", "summary": "发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。", "title": "踩坑日志" }, "snapshot": { "contributors": 16, "forks": 4549, "license": "unknown", "note": "GitHub API 快照，非实时质量证明；用于开工前背景判断。", "stars": 28210, "open_issues": 24, "pushed_at": null }, "source_url": "https://github.com/coreyhaines31/marketingskills", "steps": [ { "body": "不安装项目，先体验能力节奏。", "code": "preview", "title": "先试 Prompt" }, { "body": "理解输入、输出、失败模式和边界。", "code": "manual", "title": "读说明书" }, { "body": "把上下文交给宿主 AI 继续工作。", "code": "context", "title": "带给 AI" }, { "body": "进入主力环境前先完成安装入口与风险边界验证。", "code": "verify", "title": "沙箱验证" } ], "subtitle": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.", "title": "marketingskills 能力包", "trial_prompt": "# marketingskills - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 marketingskills 的“安装前体验版”。\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-overview：项目概述。围绕“项目概述”模拟一次用户任务，不展示安装或运行结果。\n2. quick-start：快速开始。围绕“快速开始”模拟一次用户任务，不展示安装或运行结果。\n3. installation-guide：安装指南。围绕“安装指南”模拟一次用户任务，不展示安装或运行结果。\n4. skills-overview：技能系统概览。围绕“技能系统概览”模拟一次用户任务，不展示安装或运行结果。\n5. skill-categories：技能分类总览。围绕“技能分类总览”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. project-overview\n输入：用户提供的“项目概述”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. quick-start\n输入：用户提供的“快速开始”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. installation-guide\n输入：用户提供的“安装指南”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. skills-overview\n输入：用户提供的“技能系统概览”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n5. skill-categories\n输入：用户提供的“技能分类总览”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / project-overview：Step 1 必须围绕“项目概述”形成一个小中间产物，并等待用户确认。\n- Step 2 / quick-start：Step 2 必须围绕“快速开始”形成一个小中间产物，并等待用户确认。\n- Step 3 / installation-guide：Step 3 必须围绕“安装指南”形成一个小中间产物，并等待用户确认。\n- Step 4 / skills-overview：Step 4 必须围绕“技能系统概览”形成一个小中间产物，并等待用户确认。\n- Step 5 / skill-categories：Step 5 必须围绕“技能分类总览”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/coreyhaines31/marketingskills\n- https://github.com/coreyhaines31/marketingskills#readme\n- skills/ab-test-setup/SKILL.md\n- skills/ad-creative/SKILL.md\n- skills/ai-seo/SKILL.md\n- skills/analytics-tracking/SKILL.md\n- skills/aso-audit/SKILL.md\n- skills/churn-prevention/SKILL.md\n- skills/co-marketing/SKILL.md\n- skills/cold-email/SKILL.md\n- skills/community-marketing/SKILL.md\n- skills/competitor-alternatives/SKILL.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 marketingskills 的核心服务。\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: Add OpenAI Codex plugin support（https://github.com/coreyhaines31/marketingskills/issues/295）；github/github_issue: Create official marketing skills plugin for Claude Code plugin marketpla（https://github.com/coreyhaines31/marketingskills/issues/229）；github/github_issue: Feature Request: Add Prefix to skills（https://github.com/coreyhaines31/marketingskills/issues/279）；github/github_release: v1.9.0 — image skill, video skill, plugin fix（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0）；github/github_release: v1.8.0 — 2 new skills, security hardening, plugin fix（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0）；github/github_release: v1.7.0 — ASO audit skill, Zapier SDK（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0）；github/github_release: v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0）；github/github_release: v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0）；github/github_release: v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0）；github/github_release: v1.1.0 — Tools Registry, Progressive Disclosure & More（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0）。这些是项目级外部声音，不作为单独质量证明。", "items": [ { "kind": "github_issue", "source": "github", "title": "Add OpenAI Codex plugin support", "url": "https://github.com/coreyhaines31/marketingskills/issues/295" }, { "kind": "github_issue", "source": "github", "title": "Create official marketing skills plugin for Claude Code plugin marketpla", "url": "https://github.com/coreyhaines31/marketingskills/issues/229" }, { "kind": "github_issue", "source": "github", "title": "Feature Request: Add Prefix to skills", "url": "https://github.com/coreyhaines31/marketingskills/issues/279" }, { "kind": "github_release", "source": "github", "title": "v1.9.0 — image skill, video skill, plugin fix", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0" }, { "kind": "github_release", "source": "github", "title": "v1.8.0 — 2 new skills, security hardening, plugin fix", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0" }, { "kind": "github_release", "source": "github", "title": "v1.7.0 — ASO audit skill, Zapier SDK", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0" }, { "kind": "github_release", "source": "github", "title": "v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0" }, { "kind": "github_release", "source": "github", "title": "v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0" }, { "kind": "github_release", "source": "github", "title": "v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0" }, { "kind": "github_release", "source": "github", "title": "v1.1.0 — Tools Registry, Progressive Disclosure & More", "url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0" } ], "status": "已收录 10 条来源", "title": "社区讨论" } ] }, "homepage_card": { "category": "内容营销与增长", "desc": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.", "effort": "安装已验证", "forks": 4473, "icon": "megaphone", "name": "marketingskills 能力包", "risk": "可发布", "slug": "marketingskills", "stars": 27852, "tags": [ "MCP 工具", "知识库问答", "结构化数据提取", "节点式流程编排", "开源工具" ], "thumb": "coral", "type": "Skill Pack" }, "manual": { "markdown": "# https://github.com/coreyhaines31/marketingskills 项目说明书\n\n生成时间：2026-05-11 17:55:30 UTC\n\n## 目录\n\n- [项目概述](#project-overview)\n- [快速开始](#quick-start)\n- [安装指南](#installation-guide)\n- [技能系统概览](#skills-overview)\n- [技能分类总览](#skill-categories)\n- [转化率优化技能组](#cro-skills)\n- [内容与文案技能组](#content-skills)\n- [SEO与发现技能组](#seo-skills)\n- [增长与收入技能组](#growth-skills)\n- [CLI工具集](#cli-tools)\n\n\n\n## 项目概述\n\n### 相关页面\n\n相关主题：[快速开始](#quick-start), [技能系统概览](#skills-overview), [安装指南](#installation-guide)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/schema-markup/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/references/schema-examples.md)\n
\n\n# 项目概述\n\n## 项目简介\n\nMarketing Skills 是一个面向 AI 代理（Agent）的营销技能集合库，旨在为自动化营销任务提供标准化的技能定义和操作指南。该项目通过结构化的技能模块，帮助 AI 代理执行各类营销工作，包括内容策略、SEO 优化、付费广告、网站架构设计等。\n\n资料来源：[CONTRIBUTING.md:1-5]()\n\n## 核心设计理念\n\n### 技能模块化\n\n项目采用模块化设计，每个营销技能独立存放在 `skills/` 目录下的子目录中。每个技能包含完整的指令、参考资料、脚本和资源文件，可被不同的 AI 代理平台调用。\n\n### 跨代理兼容性\n\n技能设计遵循跨平台兼容原则，确保同一套技能可以在多种 AI 代理环境中运行，包括 Codex、Cursor、Windsurf 等主流平台。\n\n资料来源：[CLAUDE.md:1-5]()\n\n## 项目架构\n\n### 整体架构图\n\n```mermaid\ngraph TD\n subgraph \"项目根目录\"\n CLAUDE[\"CLAUDE.md\"]\n AGENTS[\"AGENTS.md\"]\n CONTRIBUTING[\"CONTRIBUTING.md\"]\n end\n \n subgraph \"skills/ 技能目录\"\n SKILL1[\"content-strategy/\"]\n SKILL2[\"paid-ads/\"]\n SKILL3[\"site-architecture/\"]\n SKILL4[\"schema-markup/\"]\n SKILL5[\"image/\"]\n end\n \n subgraph \"tools/ 工具集成\"\n CLI[\"clis/\"]\n INTEGRATIONS[\"integrations/\"]\n end\n \n CLAUDE --> SKILL1\n CLAUDE --> SKILL2\n AGENTS --> SKILL1\n CONTRIBUTING --> SKILL1\n \n SKILL1 --> REF1[\"references/\"]\n SKILL2 --> REF2[\"references/\"]\n SKILL3 --> REF3[\"references/\"]\n```\n\n### 目录结构规范\n\n```\nmarketingskills/\n├── skills/ # 技能模块目录\n│ ├── [skill-name]/ # 单个技能目录\n│ │ ├── SKILL.md # 必需 - 主指令文件\n│ │ ├── references/ # 可选 - 附加文档\n│ │ │ └── guide.md\n│ │ ├── scripts/ # 可选 - 可执行代码\n│ │ │ └── helper.py\n│ │ └── assets/ # 可选 - 模板、图片、数据\n│ │ └── template.json\n├── tools/ # 工具集成\n│ ├── clis/ # CLI 工具\n│ │ └── optimizely.js\n│ └── integrations/ # 第三方集成\n│ ├── postmark.md\n│ ├── sanity.md\n│ ├── wordpress.md\n│ └── ahrefs.md\n├── CLAUDE.md # Claude Code 配置\n├── AGENTS.md # 代理配置说明\n└── CONTRIBUTING.md # 贡献指南\n```\n\n资料来源：[CONTRIBUTING.md:25-40]()\n\n## 技能系统详解\n\n### SKILL.md 文件规范\n\n每个技能的核心是 `SKILL.md` 文件，必须包含 YAML frontmatter 元数据：\n\n```yaml\n---\nname: your-skill-name\ndescription: 技能使用场景描述，包含触发短语和关键词，帮助代理识别相关任务\n---\n```\n\n**可选字段：**\n\n| 字段 | 说明 | 默认值 |\n|------|------|--------|\n| `license` | 许可证类型 | MIT |\n| `metadata` | 元数据（作者、版本等） | 无 |\n\n**命名规范：**\n\n- 目录名：小写，仅使用连字符（例：`email-sequence`）\n- name 字段：必须与目录名完全一致\n- description：1-1024 字符，包含触发短语\n\n资料来源：[CONTRIBUTING.md:10-25]()\n\n### 技能文件结构\n\n```mermaid\ngraph LR\n A[\"SKILL.md
必需\"] --> B[\"references/
可选\"]\n A --> C[\"scripts/
可选\"]\n A --> D[\"assets/
可选\"]\n \n B --> B1[\"guide.md\"]\n B --> B2[\"mermaid-templates.md\"]\n C --> C1[\"helper.py\"]\n C --> C2[\"optimizely.js\"]\n D --> D1[\"template.json\"]\n D --> D2[\"schema-examples.md\"]\n```\n\n## 代理集成机制\n\n### 动态内容注入\n\nClaude Code 支持在 SKILL.md 中嵌入 shell 命令，使用 `` !`command` `` 语法。当技能被调用时，系统执行命令并将结果内联注入。\n\n**常用应用场景：**\n\n```markdown\n# 自动注入产品营销上下文文件\nProduct context: !`cat .agents/product-marketing-context.md 2>/dev/null || echo \"No product context file found\"`\n\n# 注入当前日期\nToday's date: !`date +%Y-%m-%d`\n\n# 注入当前 git 分支\nCurrent branch: !`git branch --show-current 2>/dev/null`\n```\n\n### 产品上下文自动加载\n\n在技能文件顶部放置以下内容，使上下文在技能执行时自动可用：\n\n```markdown\nProduct context: !`cat .agents/product-marketing-context.md 2>/dev/null || echo \"No product context file found — ask the user about their product before proceeding.\"`\n```\n\n资料来源：[CLAUDE.md:10-35]()\n\n### 代理兼容性说明\n\n| 代理平台 | 支持状态 | 特殊说明 |\n|---------|---------|---------|\n| Claude Code | 完全支持 | 支持 `!`command`` 动态注入 |\n| Codex | 基础支持 | 仅读取标准 SKILL.md |\n| Cursor | 基础支持 | 仅读取标准 SKILL.md |\n| Windsurf | 基础支持 | 仅读取标准 SKILL.md |\n\n**重要限制：** 动态内容注入功能仅限于 Claude Code。其他代理会看到字面量的 `` !`command` `` 字符串而非执行结果。\n\n资料来源：[CLAUDE.md:35-45]()\n\n## 工具集成\n\n### CLI 工具\n\n项目在 `tools/clis/` 目录下提供了多种 CLI 工具脚本：\n\n| 工具 | 文件 | 功能 |\n|------|------|------|\n| Optimizely | `optimizely.js` | 项目和页面管理 |\n| Livestorm | `livestorm.js` | 活动、会话、人员管理 |\n\n### 第三方集成\n\n`tools/integrations/` 目录包含与主流营销工具的集成文档：\n\n| 集成服务 | 文件 | API 端点示例 |\n|---------|------|-------------|\n| Postmark | `postmark.md` | `/templates`, `/messages/outbound` |\n| Sanity | `sanity.md` | `/export`, `/dataset` |\n| WordPress | `wordpress.md` | `/wp-json/wp/v2/posts` |\n| Ahrefs | `ahrefs.md` | `/v3/site-explorer/` |\n| Hyperframes | `hyperframes.md` | 视频帧生成 |\n\n资料来源：[tools/integrations/postmark.md:1-30]()\n资料来源：[tools/integrations/sanity.md:1-25]()\n\n## 技能模块概览\n\n### 内容策略技能\n\n**目录：** `skills/content-strategy/`\n\n包含内容规划、编辑工作流、SEO 字段规范等参考资料。\n\n### 付费广告技能\n\n**目录：** `skills/paid-ads/`\n\n涵盖转化追踪、广告平台集成等。\n\n### 网站架构技能\n\n**目录：** `skills/site-architecture/`\n\n提供导航模式、面包屑规范、移动端导航等设计模板，包含 Mermaid 图表模板。\n\n### Schema 标记技能\n\n**目录：** `skills/schema-markup/`\n\n提供 JSON-LD 结构化数据示例，覆盖 Article、Product、WebSite 等类型。\n\n### 图片技能\n\n**目录：** `skills/image/`\n\n包含 AI 图片生成提示词指南，支持多种用例场景。\n\n## 贡献指南\n\n### 添加新技能流程\n\n```mermaid\ngraph TD\n A[\"创建技能目录
mkdir skills/your-skill-name\"] --> B[\"创建 SKILL.md 文件\"]\n B --> C[\"添加 YAML frontmatter\"]\n C --> D[\"编写技能指令\"]\n D --> E[\"添加可选资源
references/scripts/assets\"]\n E --> F[\"遵循命名规范\"]\n F --> G[\"提交 Pull Request\"]\n```\n\n### 技能请求\n\n用户可通过 [GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 提交新技能请求。\n\n资料来源：[CONTRIBUTING.md:5-10]()\n\n## 工作原理\n\n```mermaid\nsequenceDiagram\n participant User as 用户\n participant Agent as AI 代理\n participant Skill as SKILL.md\n participant Ref as References\n participant Tool as Tools\n\n User->>Agent: 调用技能\n Agent->>Skill: 读取技能指令\n Skill-->>Agent: 返回指令内容\n Agent->>Ref: 访问参考资料（如需要）\n Ref-->>Agent: 返回文档内容\n Agent->>Tool: 执行脚本或集成\n Tool-->>Agent: 返回结果\n Agent-->>User: 完成营销任务\n```\n\n## 关键特性总结\n\n| 特性 | 说明 |\n|------|------|\n| 模块化设计 | 每个技能独立，可单独使用 |\n| 跨平台兼容 | 支持多种 AI 代理环境 |\n| 丰富的参考资料 | 内置模板、图表、示例代码 |\n| 工具集成 | 预置主流营销工具集成文档 |\n| 动态内容 | 支持 shell 命令注入 |\n| 标准化格式 | 统一的 SKILL.md 规范 |\n\n---\n\n**维护者：** Corey Haines\n\n**许可证：** MIT\n\n---\n\n\n\n## 快速开始\n\n### 相关页面\n\n相关主题：[项目概述](#project-overview), [安装指南](#installation-guide), [技能系统概览](#skills-overview)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/product-marketing-context/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/product-marketing-context/SKILL.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/image/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/image/SKILL.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n
\n\n# 快速开始\n\n本页面为用户提供如何在 marketingskills 项目中快速上手的完整指南，包括项目安装、技能添加和工作流程。\n\n## 项目概述\n\nMarketing Skills 是一个 AI 代理营销技能集合，为 AI 代理提供专业的营销知识和 workflows。当用户将这些技能添加到项目中时，代理能够识别营销任务并应用正确的框架和最佳实践。\n\n## 核心概念\n\n### 什么是技能（Skills）\n\n技能是 Markdown 文件，为 AI 代理提供特定任务的专门知识和 workflows。每个技能包含：\n- 触发短语和关键词\n- 详细的使用说明\n- 可选的参考资料、脚本和模板\n\n### 技能层级结构\n\n```mermaid\ngraph TD\n PMC[\"product-marketing-context
(产品营销上下文)\"]\n \n SEO[\"SEO 与内容\"]\n CRO[\"转化率优化\"]\n CONTENT[\"内容与文案\"]\n PAID[\"付费与分发\"]\n GROWTH[\"增长与留存\"]\n SALES[\"销售与GTM\"]\n STRATEGY[\"策略\"]\n \n PMC --> SEO\n PMC --> CRO\n PMC --> CONTENT\n PMC --> PAID\n PMC --> GROWTH\n PMC --> SALES\n PMC --> STRATEGY\n \n style PMC fill:#f9f,stroke:#333,stroke-width:2px\n```\n\n`product-marketing-context` 技能是整个系统的基础，所有其他技能在执行任务前都会先读取它以了解产品、受众和定位。\n\n## 添加新技能\n\n### 目录结构\n\n每个技能需要遵循标准的目录结构：\n\n```\nskills/your-skill-name/\n├── SKILL.md # 必需 - 主指令文件\n├── references/ # 可选 - 附加文档\n│ └── guide.md\n├── scripts/ # 可选 - 可执行代码\n│ └── helper.py\n└── assets/ # 可选 - 模板、图片、数据\n └── template.json\n```\n\n### 创建 SKILL.md 文件\n\n每个技能必须有包含 YAML 前置数据的 `SKILL.md` 文件：\n\n```yaml\n---\nname: your-skill-name\ndescription: 何时使用此技能。包含帮助代理识别相关任务的触发短语和关键词。\n---\n\n# 你的技能名称\n\n代理指令在此处...\n```\n\n前置数据字段说明：\n\n| 字段 | 必填 | 说明 | 默认值 |\n|------|:----:|------|:------:|\n| name | 是 | 技能名称，必须与目录名完全匹配 | - |\n| description | 是 | 描述，包含触发短语 | - |\n| license | 否 | 许可证类型 | MIT |\n| metadata | 否 | 元数据（作者、版本等） | - |\n\n### 命名规范\n\n- **目录名**：小写，仅使用连字符（如 `email-sequence`）\n- **Name 字段**：必须与目录名完全一致\n- **Description**：1-1024 字符，包含触发短语\n\n## 技能工作流程\n\n### 代理识别流程\n\n```mermaid\ngraph TD\n A[\"用户请求\"] --> B[\"代理分析请求\"]\n B --> C{\"匹配触发短语?\"}\n C -->|是| D[\"加载对应技能\"]\n C -->|否| E[\"使用通用知识\"]\n D --> F[\"读取 product-marketing-context\"]\n F --> G[\"执行技能指令\"]\n G --> H[\"应用最佳实践\"]\n \n style D fill:#90EE90\n style F fill:#FFD700\n```\n\n### 技能间的协作\n\n技能相互引用并建立在共享上下文之上。当代理执行任务时：\n\n1. **初始化**：代理识别相关技能\n2. **上下文加载**：读取 `product-marketing-context` 获取项目背景\n3. **技能执行**：按照技能指令执行具体任务\n4. **参考资料**：如有需要，引用 `references/` 目录中的附加文档\n\n## 可用技能分类\n\n### 获客与增长\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `seo-content` | SEO 与内容策略 | 博客文章、落地页 |\n| `programmatic-seo` | 规模化页面生成 | 大量长尾页面 |\n| `site-architecture` | 页面层级与导航 | 网站结构优化 |\n| `schema-markup` | 结构化数据 | 搜索引擎优化 |\n\n### 付费与分发\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `paid-ads` | Google、Meta、LinkedIn 广告 | 付费推广活动 |\n| `ad-creative` | 广告创意生成 | 批量广告制作 |\n| `social-content` | 社交媒体策略 | 内容排期管理 |\n\n### 测量与测试\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `analytics-tracking` | 事件追踪设置 | 数据收集配置 |\n| `ab-test-setup` | 实验设计 | A/B 测试规划 |\n\n### 留存与增长工程\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `churn-prevention` | 流失预防 | 取消流程、拯救优惠 |\n| `co-marketing` | 联合营销 | 合作伙伴识别 |\n| `free-tool-strategy` | 免费工具策略 | 营销工具与计算器 |\n| `referral-program` | 推荐与联盟 | 裂变营销 |\n\n### 策略与变现\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `marketing-ideas` | 140+ SaaS 营销创意 | 营销灵感 |\n| `marketing-psychology` | 心理模型 | 用户行为洞察 |\n| `launch-strategy` | 产品发布 | 新功能推广 |\n| `pricing-strategy` | 定价策略 | 套餐设计 |\n\n### 销售与运营\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `revops` | 生命周期与评分 | 线索路由 |\n| `sales-enablement` | 销售赋能 | 演示脚本、异议处理 |\n\n## 典型使用流程\n\n### 创建竞品分析\n\n以 `competitor-profiling` 技能为例，展示典型工作流程：\n\n```mermaid\ngraph TD\n A[\"确定竞品 URL\"] --> B[\"Firecrawl Map 站点映射\"]\n B --> C[\"识别关键页面\"]\n C --> D[\"Firecrawl Scrape 抓取页面\"]\n D --> E[\"保存原始数据\"]\n E --> F[\"提取定位和定价\"]\n F --> G[\"生成竞品报告\"]\n \n style B fill:#87CEEB\n style D fill:#87CEEB\n```\n\n具体步骤：\n\n1. **映射站点**：`firecrawl_map` 发现竞品站点结构\n2. **识别页面类型**：首页、定价、功能、关于、博客\n3. **抓取关键页**：`firecrawl_scrape` 逐页抓取\n4. **保存数据**：`competitor-profiles/raw/<竞品 slug>/<日期>/scrapes/`\n5. **合成报告**：生成 `<竞品 slug>.md` 文件\n\n### 事件追踪配置\n\n使用 `analytics-tracking` 技能配置追踪：\n\n#### 核心事件结构\n\n```javascript\n{\n event: \"event_name\",\n properties: {\n // 必需\n plan: \"starter\" | \"pro\" | \"enterprise\",\n // 可选\n product_id: \"SKU123\",\n category: \"Category\",\n price: 99.99\n }\n}\n```\n\n#### 典型漏斗事件序列\n\n| 漏斗类型 | 事件序列 |\n|----------|----------|\n| 注册漏斗 | signup_started → signup_step_completed → signup_completed → onboarding_started |\n| 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed |\n| 电商漏斗 | product_viewed → product_added_to_cart → cart_viewed → checkout_started → purchase_completed |\n\n## 贡献指南\n\n### 建议新技能\n\n通过 [打开技能请求 issue](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 建议新技能。\n\n### 提交 PR\n\n1. Fork 仓库\n2. 创建技能目录和文件\n3. 遵循命名规范和目录结构\n4. 编写清晰的 SKILL.md 说明\n5. 提交 Pull Request\n\n详细贡献规范请参阅 [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)。\n\n## 快速操作清单\n\n- [ ] Fork 并克隆仓库\n- [ ] 阅读 `product-marketing-context/SKILL.md` 了解上下文机制\n- [ ] 创建一个示例技能目录\n- [ ] 编写 SKILL.md 文件，包含 YAML 前置数据\n- [ ] 添加 references/ 目录和示例文档\n- [ ] 提交 PR 并等待审核\n\n## 后续步骤\n\n完成快速开始后，建议深入了解：\n\n1. **[产品营销上下文](skills/product-marketing-context/SKILL.md)** - 所有技能的基础\n2. **[贡献指南](CONTRIBUTING.md)** - 完整的贡献规范\n3. **[竞品分析技能](skills/competitor-profiling/SKILL.md)** - 学习技能如何协同工作\n4. **[分析追踪](skills/analytics-tracking/references/event-library.md)** - 事件追踪最佳实践\n\n---\n\n\n\n## 安装指南\n\n### 相关页面\n\n相关主题：[快速开始](#quick-start), [项目概述](#project-overview)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)\n- [tools/integrations/wordpress.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/wordpress.md)\n- [tools/integrations/hubspot.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hubspot.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [.claude-plugin/plugin.json](https://github.com/coreyhaines31/marketingskills/blob/main/.claude-plugin/plugin.json)\n
\n\n# 安装指南\n\n本指南旨在帮助开发者和技术团队快速上手并正确配置 marketingskills 项目。marketingskills 是一个营销技能集合仓库，提供了涵盖内容策略、SEO优化、付费广告、社交媒体、分析追踪、A/B测试等营销全链路所需的技能、模板和参考文档。\n\n## 环境要求\n\n### 硬件与操作系统要求\n\n| 组件 | 最低要求 | 推荐配置 |\n|------|---------|---------|\n| 处理器 | 双核 1.5 GHz | 四核 2.5 GHz 或更高 |\n| 内存 | 4 GB RAM | 8 GB RAM |\n| 磁盘空间 | 500 MB | 1 GB 以上 |\n| 操作系统 | macOS 10.14+ / Ubuntu 18.04+ / Windows 10 | macOS 12+ / Ubuntu 20.04+ |\n\n### 软件依赖\n\n- **Node.js**: 版本 18.0.0 或更高\n- **npm**: 版本 8.0.0 或更高（随 Node.js 一起安装）\n- **Git**: 版本 2.30.0 或更高\n\n## 快速安装\n\n### 步骤一：克隆仓库\n\n打开终端并执行以下命令：\n\n```bash\ngit clone https://github.com/coreyhaines31/marketingskills.git\ncd marketingskills\n```\n\n### 步骤二：安装依赖\n\n项目使用 npm 管理依赖，执行安装命令：\n\n```bash\nnpm install\n```\n\n此命令将读取 `package.json` 并安装所有必要的依赖包。\n\n### 步骤三：验证安装\n\n运行以下命令验证环境配置正确：\n\n```bash\nnpm --version\nnode --version\n```\n\n确保 Node.js 版本符合要求。\n\n## 项目结构概览\n\n```\nmarketingskills/\n├── skills/ # 营销技能集合\n│ ├── content-strategy/ # 内容策略相关技能\n│ ├── seo/ # SEO优化技能\n│ ├── paid-ads/ # 付费广告技能\n│ ├── social-content/ # 社交媒体内容技能\n│ ├── analytics-tracking/ # 分析追踪技能\n│ ├── ab-test-setup/ # A/B测试设置技能\n│ ├── churn-prevention/ # 客户流失预防技能\n│ ├── marketing-ideas/ # 营销创意技能\n│ └── sales-enablement/ # 销售赋能技能\n├── tools/ # 工具集\n│ ├── clis/ # 命令行工具\n│ │ ├── optimizely.js # Optimizely CLI\n│ │ ├── livestorm.js # Livestorm CLI\n│ │ ├── wistia.js # Wistia CLI\n│ │ └── intercom.js # Intercom CLI\n│ └── integrations/ # 第三方集成文档\n│ ├── sanity.md # Sanity CMS 集成\n│ ├── wordpress.md # WordPress 集成\n│ ├── hubspot.md # HubSpot 集成\n│ ├── postmark.md # Postmark 邮件服务\n│ └── hyperframes.md # Hyperframes 视频工具\n├── .claude-plugin/ # Claude 插件配置\n│ ├── plugin.json # 插件元数据\n│ └── marketplace.json # 市场列表配置\n├── README.md # 项目主文档\n├── CONTRIBUTING.md # 贡献指南\n└── LICENSE # MIT 许可证\n```\n\n## 技能模块详解\n\n### 内容策略模块\n\n内容策略模块位于 `skills/content-strategy/` 目录下，包含以下核心技能：\n\n| 技能名称 | 功能描述 |\n|---------|---------|\n| headless-cms | 无头 CMS 集成与工作流 |\n| editorial-workflows | 编辑工作流程管理 |\n| content-calendar | 内容日历规划 |\n\n**配置 headless-cms 集成：**\n\n参考 `skills/content-strategy/references/headless-cms.md` 中的配置指南，定义内容模型包括：\n\n```json\n{\n \"contentType\": \"blogPost\",\n \"fields\": {\n \"title\": \"string (required)\",\n \"slug\": \"slug (required)\",\n \"body\": \"richText\",\n \"publishDate\": \"datetime\",\n \"author\": \"reference (author)\",\n \"category\": \"reference (category)\"\n }\n}\n```\n\n### 站点架构模块\n\n站点架构技能位于 `skills/site-architecture/`，提供页面层级、导航模式和 URL 结构的设计参考：\n\n- **页面层级设计**：定义页面优先级和导航位置\n- **导航模式**：包括顶部导航、页脚导航、面包屑导航\n- **URL 结构**：标准化 URL 命名约定\n\n详细模板参考 `skills/site-architecture/references/site-type-templates.md`。\n\n### SEO 模块\n\nSEO 技能目录包含：\n\n| 模块 | 功能 |\n|-----|------|\n| gsc-api | Google Search Console API 集成 |\n| programmatic-seo | 大规模页面生成 |\n| schema-markup | 结构化数据标记 |\n\nSchema markup 参考 `skills/schema-markup/references/schema-examples.md`，支持以下类型：\n\n- Organization\n- WebSite\n- Article/BlogPosting\n- Product\n\n### 付费广告模块\n\n位于 `skills/paid-ads/` 和 `skills/ad-creative/`，支持以下平台：\n\n- **Google Ads**：搜索广告、展示广告\n- **Meta Ads**：Facebook/Instagram 广告\n- **LinkedIn Ads**：B2B 广告投放\n\n## CLI 工具安装\n\n### Optimizely CLI\n\n参考 `tools/clis/optimizely.js`：\n\n```bash\n# 安装（如果需要全局安装）\nnpm install -g optimizely-cli\n\n# 基本用法\nnode tools/clis/optimizely.js events list --project-id <项目ID>\nnode tools/clis/optimizely.js pages list --project-id <项目ID>\n```\n\n### Livestorm CLI\n\n参考 `tools/clis/livestorm.js`：\n\n```bash\n# 活动管理\nnode tools/clis/livestorm.js events list\nnode tools/clis/livestorm.js sessions list --event-id <活动ID>\n\n# 与会人员管理\nnode tools/clis/livestorm.js people list --email <邮箱>\n```\n\n### Wistia CLI\n\n参考 `tools/clis/wistia.js`：\n\n```bash\n# 媒体管理\nnode tools/clis/wistia.js media list\nnode tools/clis/wistia.js media stats --id <媒体ID>\n\n# 观众分析\nnode tools/clis/wistia.js stats visitors\nnode tools/clis/wistia.js stats engagement --id <媒体ID>\n```\n\n### Intercom CLI\n\n参考 `tools/clis/intercom.js`：\n\n```bash\n# 用户管理\nnode tools/clis/intercom.js users list\nnode tools/clis/intercom.js users get --id <用户ID>\n\n# 工单管理\nnode tools/clis/intercom.js tickets list\nnode tools/clis/intercom.js conversations list --user-id <用户ID>\n```\n\n## 第三方服务集成\n\n### Sanity CMS\n\n详细配置参考 `tools/integrations/sanity.md`。\n\n```bash\n# 初始化 Sanity 项目\nsanity init\n\n# 本地开发\nsanity dev\n\n# 部署 Studio\nsanity deploy\n\n# 导出数据集\nsanity dataset export production ./backup.tar.gz\n```\n\n**GROQ 查询示例：**\n\n```javascript\n// 获取最近10篇文章\nconst query = '*[_type == \"post\"][0..9]{title, slug}';\n\n// 获取特定文章\nconst singlePost = '*[_type == \"post\" && slug.current == $slug][0]';\n```\n\n### WordPress REST API\n\n参考 `tools/integrations/wordpress.md`。\n\n```bash\n# 获取文章列表\ncurl -X GET \"https://example.com/wp-json/wp/v2/posts?per_page=20\" \\\n -H \"Authorization: Basic {base64(username:app_password)}\"\n\n# 创建文章\ncurl -X POST \"https://example.com/wp-json/wp/v2/posts\" \\\n -H \"Authorization: Basic {base64(username:app_password)}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"title\": \"标题\", \"content\": \"内容\", \"status\": \"publish\"}'\n```\n\n**WP-CLI 命令：**\n\n```bash\n# 列出文章\nwp post list --post_type=post --post_status=publish\n\n# 创建文章\nwp post create --post_title=\"标题\" --post_content=\"内容\" --post_status=publish\n\n# 数据库操作\nwp db export backup.sql\nwp search-replace 'old-domain.com' 'new-domain.com'\n```\n\n### HubSpot\n\n参考 `tools/integrations/hubspot.md`。\n\n```bash\n# HubSpot CLI 安装\nnpm install -g @hubspot/cli\n\n# 初始化项目\nhs init\n\n# 上传文件\nhs upload src dest\n\n# 监听变化\nhs watch src dest\n```\n\n**关键对象：**\n\n| 对象类型 | 说明 |\n|---------|------|\n| Contacts | CRM 中的联系人 |\n| Companies | 公司组织 |\n| Deals | 销售机会 |\n| Tickets | 支持工单 |\n| Products | 销售产品 |\n| Line Items | 交易行项目 |\n\n### Postmark 邮件服务\n\n参考 `tools/integrations/postmark.md`。\n\n```bash\n# 创建模板\ncurl -X POST https://api.postmarkapp.com/templates \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Postmark-Account-Token: {account_token}\" \\\n -d '{\n \"Name\": \"Welcome Email\",\n \"Alias\": \"welcome\",\n \"Subject\": \"Welcome {{name}}!\",\n \"HtmlBody\": \"

Hello {{name}}

\"\n }'\n```\n\n**统计分析接口：**\n\n```bash\n# 投递统计\nGET https://api.postmarkapp.com/deliverystats\n\n# 跳出率查询\nGET https://api.postmarkapp.com/bounces?count=50&offset=0&type=HardBounce\n\n# 打开统计\nGET https://api.postmarkapp.com/stats/outbound/opens\n```\n\n### Hyperframes 视频工具\n\n参考 `tools/integrations/hyperframes.md`。\n\n```javascript\n// 创建视频场景\nconst hyperframes = require('hyperframes');\n\nconst video = await hyperframes.createVideo({\n frames: [\n {\n html: `\n
\n

Welcome to Acme

\n
\n `,\n duration: 3,\n },\n {\n html: `\n
\n

Ship faster with AI

\n
\n `,\n duration: 3,\n },\n ],\n output: \"intro.mp4\",\n width: 1080,\n height: 1920,\n fps: 30,\n});\n```\n\n## Claude 插件配置\n\n项目包含 Claude 插件配置，位于 `.claude-plugin/` 目录。\n\n### plugin.json 结构\n\n```json\n{\n \"name\": \"marketingskills\",\n \"description\": \"营销技能集合：内容策略、SEO、付费广告、社交媒体、分析追踪等\",\n \"version\": \"1.0.0\",\n \"skills\": [\n \"content-strategy\",\n \"seo\",\n \"paid-ads\",\n \"social-content\",\n \"analytics-tracking\"\n ],\n \"tools\": {\n \"clis\": [\n \"optimizely\",\n \"livestorm\",\n \"wistia\",\n \"intercom\"\n ],\n \"integrations\": [\n \"sanity\",\n \"wordpress\",\n \"hubspot\",\n \"postmark\"\n ]\n }\n}\n```\n\n## 环境变量配置\n\n### 必需的环境变量\n\n创建 `.env` 文件并配置以下变量：\n\n```bash\n# Sanity\nSANITY_PROJECT_ID=your_project_id\nSANITY_DATASET=production\nSANITY_TOKEN=your_token\n\n# WordPress\nWP_API_URL=https://your-site.com/wp-json/wp/v2\nWP_USERNAME=your_username\nWP_APP_PASSWORD=your_app_password\n\n# HubSpot\nHUBSPOT_ACCESS_TOKEN=your_access_token\n\n# Postmark\nPOSTMARK_ACCOUNT_TOKEN=your_account_token\nPOSTMARK_SERVER_TOKEN=your_server_token\n\n# Optimizely\nOPTIMIZELY_API_TOKEN=your_api_token\n\n# Livestorm\nLIVESTORM_API_KEY=your_api_key\n\n# Wistia\nWISTIA_API_TOKEN=your_api_token\n\n# Intercom\nINTERCOM_ACCESS_TOKEN=your_access_token\n```\n\n## 常见问题排查\n\n### npm install 失败\n\n```bash\n# 清除缓存后重试\nnpm cache clean --force\nrm -rf node_modules\nnpm install\n```\n\n### CLI 工具无法执行\n\n确保 Node.js 版本正确，并检查文件执行权限：\n\n```bash\nchmod +x tools/clis/*.js\n```\n\n### 环境变量未生效\n\n确保 `.env` 文件位于项目根目录，或在执行命令前手动导出变量：\n\n```bash\nexport $(cat .env | xargs)\n```\n\n## 相关资源\n\n- **贡献指南**：[CONTRIBUTING.md](CONTRIBUTING.md)\n- **许可证**：[MIT License](LICENSE)\n- **问题反馈**：[GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues)\n\n## 贡献代码\n\n欢迎提交 Pull Request 和 Issue。贡献前请阅读 `CONTRIBUTING.md` 了解：\n\n1. 如何添加新的技能模块\n2. 如何改进现有文档\n3. 代码风格规范\n4. 提交信息的格式要求\n\n---\n\n\n\n## 技能系统概览\n\n### 相关页面\n\n相关主题：[技能分类总览](#skill-categories), [转化率优化技能组](#cro-skills), [内容与文案技能组](#content-skills), [SEO与发现技能组](#seo-skills), [增长与收入技能组](#growth-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)\n
\n\n# 技能系统概览\n\n## 概述\n\n技能系统（Agent Skills）是 Marketing Skills 项目中用于定义和封装营销自动化任务的核心组件。该系统基于 [Agent Skills 规范](https://agentskills.io/specification.md)，为 AI 代理提供标准化的技能描述和执行指南。\n\n技能系统的设计目标是将复杂的营销任务（如竞争对手分析、SEO 优化、广告投放管理等）封装为可复用、可组合的模块，使 AI 代理能够根据用户需求自动调用相应的技能完成任务。\n\n## 核心架构\n\n### 技能目录结构\n\n每个技能存放在独立的目录中，采用统一的目录结构组织各类资源：\n\n```\nskills//\n├── SKILL.md # 必需 - 技能主指令文件\n├── references/ # 可选 - 参考文档和指南\n│ └── *.md\n├── scripts/ # 可选 - 可执行脚本\n│ └── *.py\n└── assets/ # 可选 - 模板、数据文件\n └── *.json\n```\n\n### 技能定义规范\n\n技能使用 YAML frontmatter 定义元数据，格式如下：\n\n```yaml\n---\nname: skill-name\ndescription: 技能用途描述，包含触发短语和关键词\n---\n\n# 技能标题\n\n技能详细指令内容...\n```\n\n### Frontmatter 字段约束\n\n| 字段 | 必需 | 约束条件 |\n|------|------|----------|\n| `name` | 是 | 1-64 字符，小写字母、数字、连字符，必须与目录名完全一致 |\n| `description` | 是 | 1-1024 字符，描述技能用途和触发场景 |\n| `license` | 否 | 许可证名称（默认：MIT） |\n| `metadata` | 否 | 键值对（作者、版本等） |\n\n资料来源：[AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n\n## 技能分类\n\n### 按功能领域分类\n\n| 类别 | 示例技能 | 用途 |\n|------|----------|------|\n| 内容营销 | `ai-seo` | AI 驱动的 SEO 内容优化 |\n| 网站架构 | `site-architecture` | 网站结构规划和导航设计 |\n| 数据分析 | `analytics-tracking` | 事件跟踪和漏斗分析 |\n| 广告投放 | `paid-ads` | 付费广告管理和转化追踪 |\n| 竞争情报 | `competitor-profiling` | 竞争对手数据收集和分析 |\n\n### 按文件类型分类\n\n| 类型 | 说明 |\n|------|------|\n| 核心技能 | 包含完整 SKILL.md 和 references/ 目录 |\n| 简单技能 | 仅包含 SKILL.md 的轻量级技能 |\n| 工具技能 | 配合 CLI 工具使用的技能 |\n\n## 工作流程\n\n### 技能创建流程\n\n```mermaid\ngraph TD\n A[创建技能目录] --> B[编写 SKILL.md]\n B --> C[添加 YAML frontmatter]\n C --> D{是否需要参考资料?}\n D -->|是| E[创建 references/ 目录]\n D -->|否| F{需要脚本支持?}\n E --> F\n F -->|是| G[创建 scripts/ 目录]\n F -->|否| H{需要资源文件?}\n G --> H\n H -->|是| I[创建 assets/ 目录]\n H -->|否| J[验证 frontmatter 有效性]\n I --> J\n J --> K[提交 PR]\n```\n\n### 技能执行流程\n\n```mermaid\ngraph TD\n A[用户请求] --> B[解析触发短语]\n B --> C{匹配技能}\n C -->|找到| D[加载 SKILL.md]\n C -->|未找到| E[返回错误]\n D --> F{存在 references?}\n F -->|是| G[加载参考文档]\n F -->|否| H{存在 scripts?}\n G --> H\n H -->|是| I[准备脚本环境]\n H -->|否| J[执行技能指令]\n I --> J\n J --> K[返回结果]\n```\n\n## 命名规范\n\n### 目录命名\n\n- 使用小写字母\n- 仅使用连字符 `-` 分隔单词\n- 示例：`email-sequence`、`competitor-profiling`\n\n### 字段命名\n\n- `name` 字段必须与目录名完全一致\n- 描述中应包含触发短语，帮助代理识别相关任务\n\n## 验证与测试\n\n### 手动验证清单\n\n技能开发完成后需手动验证以下内容：\n\n| 检查项 | 命令/方法 |\n|--------|----------|\n| YAML 语法 | 检查 frontmatter 格式正确 |\n| 字段一致性 | `name` 字段与目录名匹配 |\n| 字段长度 | `name` 1-64 字符，`description` 1-1024 字符 |\n| 命名规范 | 仅允许小写字母、数字、连字符 |\n\n### CLI 工具验证\n\n对于需要 CLI 工具配合的技能：\n\n```bash\n# 语法检查\nnode --check tools/clis/.js\n\n# 显示用法\nnode tools/clis/.js\n\n# 预览请求（不发送）\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n\n## 技能示例结构\n\n### 竞争对手分析技能\n\n`competitor-profiling` 技能展示了完整的技能结构：\n\n```\ncompetitor-profiles/\n├── raw/\n│ └── /\n│ └── /\n│ ├── scrapes/ # 页面抓取结果\n│ ├── seo/ # SEO 数据\n│ └── reviews/ # 评论数据\n├── .md # 合成的竞品档案\n└── _summary.md # 跨竞品汇总\n```\n\n研究流程分为三个阶段：\n\n1. **站点抓取（Firecrawl）** - 提取定位、特性、定价和消息\n2. **SEO 数据收集（DataForSEO）** - 收集排名关键词、反向链接等\n3. **评论数据采集** - 从 G2、Capterra 等平台收集用户评价\n\n资料来源：[skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n\n### 分析跟踪技能\n\n`analytics-tracking` 技能定义了标准的事件模型：\n\n**用户上下文：**\n```json\n{\n \"user_id\": \"user_123\",\n \"plan\": \"pro\"\n}\n```\n\n**会话上下文：**\n```json\n{\n \"session_id\": \"sess_abc\",\n \"session_number\": 5,\n \"page\": \"/pricing\"\n}\n```\n\n**漏斗事件序列示例：**\n\n| 漏斗类型 | 事件序列 |\n|----------|----------|\n| 注册漏斗 | signup_started → step_completed → completed → onboarding_started |\n| 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed |\n| 电商漏斗 | product_viewed → added_to_cart → cart_viewed → checkout_started → purchase_completed |\n\n资料来源：[skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n\n## 工具集成\n\n### 集成 API 文档\n\n项目在 `tools/integrations/` 目录下维护了多种营销工具的 API 集成文档：\n\n| 工具 | 功能 | 关键端点 |\n|------|------|----------|\n| Postmark | 邮件发送与追踪 | 模板管理、退订统计 |\n| Livestorm | 网络研讨会管理 | 活动、会话、人员管理 |\n| ZoomInfo | B2B 数据 enrichment | 联系人、公司、意向数据 |\n| Intercom | 客户沟通 | 文章、事件追踪 |\n| WordPress | CMS 内容管理 | 文章、页面、媒体管理 |\n| Sanity | 结构化内容管理 | 文档查询、GROQ |\n\n### CLI 工具\n\n`tools/clis/` 目录包含 Node.js 编写的命令行工具，采用零依赖设计：\n\n| 工具 | 支持命令 |\n|------|----------|\n| livestorm.js | events、sessions、people、webhooks、organization |\n| optimizely.js | campaigns、pages |\n\n## 扩展技能系统\n\n### 添加新技能\n\n1. 创建技能目录：`mkdir -p skills/your-skill-name`\n2. 编写 SKILL.md 文件，包含有效的 YAML frontmatter\n3. 按需添加 references/、scripts/、assets/ 目录\n4. 验证文件结构和命名规范\n\n### 技能请求\n\n如需新技能，可通过 [GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 提交技能请求。\n\n资料来源：[CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n\n## 最佳实践\n\n### 技能设计原则\n\n1. **单一职责** - 每个技能专注于特定领域\n2. **清晰描述** - description 应包含触发短语和关键词\n3. **模块化结构** - 使用 references/ 目录组织相关文档\n4. **可验证性** - 提供清晰的执行路径和预期结果\n\n### 文档编写规范\n\n- 使用中文标题和说明（保留英文技术术语）\n- 包含代码示例和命令片段\n- 使用表格整理结构化数据\n- 使用 Mermaid 图展示流程和架构\n\n---\n\n\n\n## 技能分类总览\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [转化率优化技能组](#cro-skills), [内容与文案技能组](#content-skills), [SEO与发现技能组](#seo-skills), [增长与收入技能组](#growth-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n- [skills/ai-seo/references/content-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/content-patterns.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)\n- [tools/clis/livestorm.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/livestorm.js)\n
\n\n# 技能分类总览\n\n## 项目概述\n\nMarketing Skills 是一个开源的营销技能库，旨在为营销专业人员提供可复用的技能模板、参考文档和工具集成。该项目采用模块化架构，将营销技能分为多个类别，每个类别包含主技能说明文件（SKILL.md）和可选的参考文档、脚本和资源文件。资料来源：[CONTRIBUTING.md:1-10]()\n\n## 技能架构\n\n项目采用标准化目录结构管理各类营销技能，所有技能遵循统一的命名规范和元数据格式。资料来源：[CONTRIBUTING.md:18-35]()\n\n```mermaid\ngraph TD\n ROOT[\"marketingskills/\"]\n ROOT --> SKILLS[\"skills/\"]\n ROOT --> TOOLS[\"tools/\"]\n \n SKILLS --> CAT1[\"竞争对手分析
(competitor-profiling)\"]\n SKILLS --> CAT2[\"付费广告
(paid-ads)\"]\n SKILLS --> CAT3[\"站点架构
(site-architecture)\"]\n SKILLS --> CAT4[\"AI SEO
(ai-seo)\"]\n SKILLS --> CAT5[\"分析追踪
(analytics-tracking)\"]\n \n CAT1 --> SM1[\"SKILL.md\"]\n CAT1 --> REF1[\"references/\"]\n CAT1 --> SCR1[\"scripts/\"]\n \n TOOLS --> INT[\"integrations/\"]\n INT --> POSTMARK[\"postmark.md\"]\n INT --> SANITY[\"sanity.md\"]\n INT --> LIVESTORM[\"livestorm.md\"]\n INT --> WP[\"wordpress.md\"]\n INT --> ZOOMINFO[\"zoominfo.md\"]\n INT --> OUTREACH[\"outreach.md\"]\n INT --> INTERCOM[\"intercom.md\"]\n INT --> TOLT[\"tolt.md\"]\n INT --> SAVVYCAL[\"savvycal.md\"]\n \n TOOLS --> CLI[\"clis/\"]\n CLI --> LIVESTORM_JS[\"livestorm.js\"]\n CLI --> OPTIMIZELY_JS[\"optimizely.js\"]\n```\n\n## 技能类别详解\n\n### 竞争对手分析（competitor-profiling）\n\n竞争对手分析技能提供系统化的竞品研究方法论，支持营销团队深入了解市场格局。资料来源：[skills/competitor-profiling/SKILL.md:1-20]()\n\n该技能的数据采集结构如下：\n\n| 数据类型 | 存储位置 | 格式 |\n|---------|---------|------|\n| 页面抓取 | `raw/<竞品slug>/<日期>/scrapes/` | Markdown |\n| SEO数据 | `raw/<竞品slug>/<日期>/seo/` | JSON |\n| 评价数据 | `raw/<竞品-slug>/<日期>/reviews/` | Markdown/JSON |\n\n技能执行流程采用 Firecrawl 进行页面抓取，DataForSEO 进行 SEO 数据采集，并支持 G2、Capterra 等评价平台的数据整合。资料来源：[skills/competitor-profiling/SKILL.md:25-40]()\n\n### 付费广告（paid-ads）\n\n付费广告技能聚焦于转化追踪最佳实践，提供多平台的广告追踪集成方案。资料来源：[skills/paid-ads/references/conversion-tracking.md:1-15]()\n\n该技能包含主流广告平台的追踪脚本模板，包括 TikTok 广告分析等集成方案，帮助团队建立完整的广告效果归因体系。\n\n### 站点架构（site-architecture）\n\n站点架构技能指导营销人员设计合理的网站结构，涵盖导航模式、信息架构和内部链接策略。资料来源：[skills/site-architecture/references/navigation-patterns.md:1-30]()\n\n核心导航组件包括：\n\n| 组件类型 | 用途 | Schema标记 |\n|---------|------|------------|\n| 标准导航 | 主菜单导航 | nav 元素 |\n| 面包屑 | 路径导航 | BreadcrumbList |\n| 页脚导航 | 辅助链接 | footer 元素 |\n| 侧边导航 | 内容分类 | nav 元素 |\n\n技能提供了 Hub-and-Spoke 内容模型，帮助建立中心主题页面与相关子主题页面的层级关系，优化内部链接结构和 SEO 效果。资料来源：[skills/site-architecture/references/mermaid-templates.md:1-30]()\n\n### AI SEO（ai-seo）\n\nAI SEO 技能针对生成式搜索引擎优化场景，提供内容创作指南和 E-E-A-T（经验、专业性、权威性、可信度）优化策略。资料来源：[skills/ai-seo/references/content-patterns.md:1-25]()\n\n核心内容模式包括：\n\n- **自包含答案块**：可被 AI 直接提取的独立声明\n- **证据三明治结构**：主张、数据证据、结论的标准化呈现\n- **领域特定权威信号**：技术内容强调精确性，医疗内容引用同行评审研究\n\n### 分析追踪（analytics-tracking）\n\n分析追踪技能提供标准化的用户行为事件库，支持跨平台的分析数据收集。资料来源：[skills/analytics-tracking/references/event-library.md:1-50]()\n\n标准事件序列定义：\n\n| 漏斗类型 | 事件序列 |\n|---------|---------|\n| 注册漏斗 | signup_started → signup_step_completed → signup_completed → onboarding_started |\n| 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed |\n| 电商漏斗 | product_viewed → product_added_to_cart → cart_viewed → checkout_started → purchase_completed |\n\n事件上下文包含会话信息、用户属性、时间戳等标准字段，确保数据一致性和可比性。\n\n## 工具集成\n\n### 邮件服务集成\n\n**Postmark** 提供.Transactional 邮件 API 集成，支持模板管理、投递统计、退信管理和开点击追踪。资料来源：[tools/integrations/postmark.md:1-25]()\n\n| 功能 | 端点 |\n|------|------|\n| 创建模板 | POST /templates |\n| 获取投递统计 | GET /deliverystats |\n| 列表退信 | GET /bounces |\n| 搜索出站消息 | GET /messages/outbound |\n\n### 内容管理系统集成\n\n**Sanity** 作为结构化内容管理平台，支持博客、营销网站等多渠道内容交付。该集成提供文档查询（GROQ）、数据导入导出和实时协作编辑能力。资料来源：[tools/integrations/sanity.md:1-35]()\n\n关键对象类型：\n\n| 对象类型 | 说明 |\n|---------|------|\n| Document | 顶级内容项，包含 `_id`、`_type`、`_rev` |\n| Asset | CDN 存储的图片和文件 |\n| Reference | 文档间引用链接 |\n| Portable Text | 结构化富文本块 |\n| Dataset | 隔离的内容数据库 |\n\n### 网络研讨会集成\n\n**Livestorm** 支持产品演示和网络研讨会的自动化管理，提供活动创建、注册管理、会话追踪和录制获取等功能。资料来源：[tools/integrations/livestorm.md:1-30]()\n\nCLI 工具 livestorm.js 提供命令行接口，支持活动的完整生命周期管理。资料来源：[tools/clis/livestorm.js:1-25]()\n\n```bash\n# CLI 命令示例\nnode livestorm.js events list\nnode livestorm.js sessions create --event-id \nnode livestorm.js people register --id --email \n```\n\n### 其他平台集成\n\n| 平台 | 用途 | 关键功能 |\n|------|------|---------|\n| WordPress | CMS 管理 | 文章/页面 CRUD、媒体上传、用户管理 |\n| ZoomInfo | B2B 数据 | 联系人搜索、公司数据、意向信号 |\n| Outreach | 销售外联 | 潜在客户管理、序列自动化 |\n| Intercom | 客户沟通 | 文章管理、会话追踪、事件提交 |\n| Tolt | 联盟营销 | 佣金追踪、联盟管理、支付自动化 |\n| SavvyCal | 日程安排 | 预约链接管理、活动检索、网页钩子 |\n\n## CLI 工具\n\n项目提供零依赖的 Node.js CLI 工具（Node 18+），位于 `tools/clis/` 目录。资料来源：[CLAUDE.md:12-18]()\n\n| 工具 | 功能 |\n|------|------|\n| livestorm.js | Livestorm 活动、会话、人员管理 |\n| optimizely.js | Optimizely 项目和页面管理 |\n\n验证方式：\n\n```bash\n# 语法检查\nnode --check tools/clis/.js\n\n# 显示帮助\nnode tools/clis/.js\n\n# 预览请求（不发送）\nnode tools/clis/.js --dry-run\n```\n\n## 技能贡献指南\n\n### 目录命名规范\n\n| 规范项 | 要求 |\n|-------|------|\n| 目录名 | 小写，仅使用连字符分隔（如 `email-sequence`） |\n| name 字段 | 必须与目录名完全一致 |\n| 字符限制 | 1-64 个字符 |\n\n### 元数据格式\n\n```yaml\n---\nname: skill-name\ndescription: 技能描述，1-1024字符，包含触发短语\nlicense: MIT # 可选，默认 MIT\nmetadata: # 可选\n author: 作者名\n version: 1.0.0\n---\n```\n\n### 标准目录结构\n\n```\nskills/your-skill-name/\n├── SKILL.md # 必需 - 主指令文件\n├── references/ # 可选 - 附加文档\n│ └── guide.md\n├── scripts/ # 可选 - 可执行代码\n│ └── helper.py\n└── assets/ # 可选 - 模板、图片、数据\n └── template.json\n```\n\n## 技能选择流程\n\n```mermaid\ngraph TD\n START[\"营销需求识别\"] --> Q1{\"需要竞品研究?\"}\n Q1 -->|是| COMPETITOR[\"竞争对手分析\"]\n Q1 -->|否| Q2\n \n Q2{\"需要广告追踪?\"}\n Q2 -->|是| PAID[\"付费广告\"]\n Q2 -->|否| Q3\n \n Q3{\"需要网站结构设计?\"}\n Q3 -->|是| SITE[\"站点架构\"]\n Q3 -->|否| Q4\n \n Q4{\"需要 AI 搜索优化?\"}\n Q4 -->|是| AISE[\"AI SEO\"]\n Q4 -->|否| Q5\n \n Q5{\"需要用户行为分析?\"}\n Q5 -->|是| ANALYTICS[\"分析追踪\"]\n Q5 -->|否| END[\"查看工具集成\"]\n \n COMPETITOR --> TOOL1[\"数据采集 + Sanity\"]\n PAID --> TOOL2[\"TikTok + Postmark\"]\n SITE --> TOOL3[\"WordPress\"]\n AISE --> TOOL4[\"内容模式库\"]\n ANALYTICS --> TOOL5[\"事件库 + 集成\"]\n```\n\n## 总结\n\nMarketing Skills 项目通过标准化的技能分类体系，为营销团队提供从竞品研究、内容创作到效果追踪的完整工具链。每个技能类别均包含结构化的参考文档和可选的脚本工具，支持灵活组合以满足不同营销场景需求。\n\n---\n\n\n\n## 转化率优化技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [内容与文案技能组](#content-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n
\n\n# 转化率优化技能组\n\n## 概述\n\n转化率优化（CRO, Conversion Rate Optimization）技能组是 marketingskills 项目中的核心技能分类之一，专门用于指导 AI 代理执行各类转化率优化任务。该技能组通过结构化的指令模板，帮助自动化系统分析和改进用户旅程中的关键转化节点。\n\n根据项目文档，转化率优化技能组包含六大核心技能，覆盖从落地页到付费升级的完整用户生命周期。\n\n资料来源：[README.md:1-30]()\n\n## 技能分类体系\n\n转化率优化技能组按照用户旅程的不同阶段划分为以下六个专门技能：\n\n| 技能标识 | 适用场景 | 主要职责 |\n|---------|---------|---------|\n| `page-cro` | 营销落地页 | 分析和优化营销页面的转化效率 |\n| `signup-flow-cro` | 注册流程 | 改进用户注册/报名流程的转化率 |\n| `onboarding-cro` | 激活引导 | 优化用户注册后的激活和上手体验 |\n| `form-cro` | 线索捕获表单 | 提升表单填写率和线索收集效果 |\n| `popup-cro` | 弹窗和遮罩层 | 优化模态窗口和弹窗的转化表现 |\n| `paywall-upgrade-cro` | 付费墙升级 | 改进应用内付费升级时刻的转化 |\n\n资料来源：[README.md:18-26]()\n\n## 技能结构规范\n\n每个转化率优化技能遵循统一的项目结构规范：\n\n```\nskills/{skill-name}/\n├── SKILL.md # 必需 - 主指令文件\n├── references/ # 可选 - 补充文档\n├── scripts/ # 可选 - 可执行代码\n└── assets/ # 可选 - 模板和数据文件\n```\n\n### SKILL.md 文件规范\n\n主指令文件必须包含 YAML 前置元数据：\n\n```yaml\n---\nname: skill-name\ndescription: 何时使用此技能的描述，包含触发短语和关键词\n---\n```\n\n**必填字段规则：**\n\n| 字段 | 必填 | 规则 |\n|-----|-----|------|\n| `name` | 是 | 小写字母、数字、连字符，与目录名完全一致 |\n| `description` | 是 | 1-1024 字符，包含触发短语 |\n| `license` | 否 | 许可证名称（默认：MIT）|\n| `metadata` | 否 | 键值对（作者、版本等）|\n\n**Name 字段命名规则：**\n- 只能使用小写字母、数字和连字符\n- 不能以连字符开头或结尾\n- 不能有连续连字符（`--`）\n- 必须与父目录名称完全匹配\n\n有效示例：`page-cro`、`email-sequence`、`ab-test-setup`\n无效示例：`Page-CRO`、`-page`、`page--cro`\n\n资料来源：[CONTRIBUTING.md:1-50]()\n\n### 技能目录结构\n\n```\nskills/skill-name/\n├── SKILL.md # 必需 - 主指令（<500 行）\n├── references/ # 可选 - 按需加载的详细文档\n├── scripts/ # 可选 - 可执行代码\n└── assets/ # 可选 - 模板、数据文件\n```\n\n资料来源：[CLAUDE.md:1-30]()\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 G --> H[监控效果]\n H --> I{达成目标?}\n I -->|否| D\n I -->|是| J[持续优化]\n```\n\n### 转化漏斗序列\n\n根据事件追踪库规范，典型的转化漏斗包含以下事件序列：\n\n**注册漏斗：**\n1. `signup_started` - 注册开始\n2. `signup_step_completed` (email) - 邮箱步骤完成\n3. `signup_step_completed` (password) - 密码步骤完成\n4. `signup_completed` - 注册完成\n5. `onboarding_started` - 激活开始\n\n**购买漏斗：**\n1. `pricing_viewed` - 价格页浏览\n2. `plan_selected` - 方案选择\n3. `checkout_started` - 结账开始\n4. `payment_info_entered` - 支付信息填写\n5. `purchase_completed` - 购买完成\n\n资料来源：[skills/analytics-tracking/references/event-library.md:1-50]()\n\n## 事件追踪规范\n\n转化率优化需要依赖精确的事件追踪系统。事件追踪应包含以下关键上下文信息：\n\n### 用户上下文\n```\nuser_id: \"usr_123\"\nanonymous_id: \"anon_456\"\nemail: \"user@example.com\"\nplan: \"starter\" | \"pro\" | \"enterprise\"\n```\n\n### 会话上下文\n```\nsession_id: \"sess_abc\"\nsession_number: 5\npage: \"/pricing\"\nreferrer: \"https://google.com\"\n```\n\n### 活动上下文\n```\nsource: \"google\"\nmedium: \"cpc\"\ncampaign: \"spring_sale\"\ncontent: \"hero_cta\"\n```\n\n### 产品上下文（电商场景）\n```\nproduct_id: \"SKU123\"\nproduct_name: \"Product Name\"\ncategory: \"Category\"\nprice: 99.99\nquantity: 1\ncurrency: \"USD\"\n```\n\n### 时间上下文\n```\ntimestamp: \"2024-01-15T10:30:00Z\"\ntime_on_page: 45\nsession_duration: 300\n```\n\n资料来源：[skills/analytics-tracking/references/event-library.md:50-80]()\n\n## 导航与面包屑优化\n\n转化率优化与网站架构密切相关。良好的导航设计直接影响用户转化路径的流畅性。\n\n### 标准面包屑格式\n\n```\nHome > Features > Analytics\nHome > Blog > SEO Category > How to Do Keyword Research\nHome > Docs > API Reference > Authentication\n```\n\n**规则：**\n- 分隔符：使用 `>` 或 `/`，保持一致\n- 除当前页面外，每个段落都是链接\n- 当前页面为纯文本（不链接）\n- 如果 H1 中已显示标题，则不包含当前页面\n\n### 带 Schema 标记的面包屑\n\n```html\n\n```\n\n资料来源：[skills/site-architecture/references/navigation-patterns.md:1-50]()\n\n## 技能质量检查清单\n\n在提交或更新转化率优化技能时，必须满足以下质量标准：\n\n- [ ] `name` 字段与目录名完全匹配\n- [ ] `name` 遵循命名规则（小写、连字符、无 `--`）\n- [ ] `description` 包含 1-1024 字符的触发短语\n- [ ] `SKILL.md` 行数控制在 500 行以内\n- [ ] 不包含敏感数据或凭证信息\n- [ ] 遵循项目中现有技能的规范模式\n\n资料来源：[CONTRIBUTING.md:50-70]()\n\n## 提交工作流程\n\n### 分支命名规范\n\n| 变更类型 | 分支前缀 | 示例 |\n|---------|---------|------|\n| 新技能 | `feature/` | `feature/page-cro` |\n| 改进 | `fix/` | `fix/page-cro-clarity` |\n| 文档 | `docs/` | `docs/cro-guide` |\n\n### 提交信息规范\n\n遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范：\n\n- `feat: add page-cro skill` - 新增技能\n- `fix: improve clarity in signup-flow-cro` - 修复改进\n- `docs: update CRO guide` - 文档更新\n\n### Pull Request 模板\n\n项目提供三种 PR 模板：\n- 新技能（New Skill）\n- 技能更新（Skill Update）\n- 文档（Documentation）\n\n资料来源：[AGENTS.md:1-50]()\n\n## 技能使用示例\n\n在 Claude Code 等 AI 代理环境中，可以通过以下方式调用转化率优化技能：\n\n### 直接调用技能\n\n```\n/page-cro\n/email-sequence\n/seo-audit\n```\n\n### 通过描述触发\n\n用户可以描述任务，AI 代理会根据描述自动选择合适的技能：\n\n```\n\"优化我们的落地页以提高注册转化率\"\n→ 使用 page-cro 技能\n\n\"设置 Google Analytics 4 追踪注册事件\"\n→ 使用 analytics-tracking 技能\n```\n\n资料来源：[README.md:1-15]()\n\n## 与其他技能组的协作\n\n转化率优化技能组并非独立运作，而是与项目中的其他技能组紧密协作：\n\n```mermaid\ngraph LR\n CRO[转化率优化技能组] --> COPY[内容与文案技能组]\n CRO --> SEO[SEO与发现技能组]\n CRO --> PAID[付费与分发技能组]\n CRO --> ANALYTICS[分析与追踪技能组]\n \n COPY -->|文案优化| CRO\n SEO -->|流量提升| CRO\n PAID -->|广告优化| CRO\n ANALYTICS -->|数据支撑| CRO\n```\n\n### 协作技能列表\n\n**内容与文案：**\n- `copywriting` - 营销页面文案\n- `copy-editing` - 文案编辑润色\n- `email-sequence` - 自动化邮件序列\n\n**SEO 与发现：**\n- `seo-audit` - 技术性和页面 SEO\n- `ai-seo` - AI 搜索优化\n- `programmatic-seo` - 大规模页面生成\n\n**付费与分发：**\n- `paid-ads` - Google、Meta、LinkedIn 广告\n- `ad-creative` - 批量广告创意\n\n**分析与追踪：**\n- `analytics-tracking` - 事件追踪配置\n\n资料来源：[README.md:26-40]()\n\n## 扩展阅读\n\n如需深入了解相关主题，建议参考以下资源：\n\n- **站点架构**：`skills/site-architecture/references/` 目录下的导航模式和站点类型模板\n- **事件追踪**：`skills/analytics-tracking/references/event-library.md` 完整的事件库定义\n- **Schema 标记**：`skills/schema-markup/references/schema-examples.md` 结构化数据示例\n- **贡献指南**：`CONTRIBUTING.md` 完整的技能开发流程\n\n---\n\n\n\n## 内容与文案技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [转化率优化技能组](#cro-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/copywriting/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/SKILL.md)\n- [skills/cold-email/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/SKILL.md)\n- [skills/email-sequence/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/email-sequence/SKILL.md)\n- [skills/social-content/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social-content/SKILL.md)\n- [skills/image/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/image/SKILL.md)\n- [skills/video/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/video/SKILL.md)\n
\n\n# 内容与文案技能组\n\n## 概述\n\n内容与文案技能组是 Marketing Skills 项目中专注于营销内容创作的核心模块，涵盖从文案撰写到视觉内容生成的完整内容营销工作流程。该技能组为营销团队提供了一套标准化的内容创作指南和最佳实践，帮助生成高质量的营销文案、邮件内容、社交媒体帖子以及图像和视频素材。\n\n根据项目架构，内容与文案技能组主要包含以下核心技能：\n\n| 技能名称 | 功能描述 | 典型应用场景 |\n|---------|---------|-------------|\n| copywriting | 营销页面文案撰写 | 首页、落地页、产品页 |\n| copy-editing | 文案编辑与润色 | 现有内容的优化提升 |\n| cold-email | B2B 冷启动外联邮件 | 销售线索开发 |\n| email-sequence | 自动化邮件序列 | 欢迎序列、客户培育 |\n| social-content | 社交媒体内容 | LinkedIn、Twitter、Instagram |\n| image | AI 图像生成与设计 | 营销素材、社交图片 |\n| video | 视频内容创作 | 产品演示、教程视频 |\n\n资料来源：[README.md](README.md)\n\n## 技能组架构\n\n内容与文案技能组采用模块化设计，各技能既可独立使用，也可组合形成完整的内容营销流程。技能之间存在明确的数据流向和依赖关系：\n\n```mermaid\ngraph TD\n A[内容策略规划] --> B[copywriting 文案撰写]\n B --> C[copy-editing 文案润色]\n C --> D[多渠道分发]\n \n D --> E[cold-email 冷启动邮件]\n D --> F[email-sequence 自动化序列]\n D --> G[social-content 社交内容]\n \n G --> H[image 图像创作]\n G --> I[video 视频制作]\n \n H --> J[视觉素材输出]\n I --> J\n \n E --> K[邮件营销输出]\n F --> K\n \n style A fill:#f9f,stroke:#333\n style J fill:#9f9,stroke:#333\n style K fill:#9f9,stroke:#333\n```\n\n## 核心技能详解\n\n### 文案撰写（Copywriting）\n\n文案撰写技能是整个内容与文案技能组的基础，负责生成各类营销页面的核心文案内容。该技能专注于创建能够有效传达产品价值主张并推动用户行动的营销文案。\n\n**触发关键词与场景：**\n\n- 落地页文案（homepage copy for my SaaS）\n- 产品特性描述\n- 价值主张提炼\n- 行动号召按钮文案\n- 客户成功案例文案\n\n资料来源：[skills/copywriting/SKILL.md](skills/copywriting/SKILL.md)\n\n### 文案编辑（Copy-editing）\n\n文案编辑技能专注于对现有文案进行优化和润色，确保文案达到专业水准。该技能不从头创作内容，而是在既有文案基础上进行改进，提升可读性、说服力和品牌一致性。\n\n**适用场景：**\n\n- 现有营销页面的A/B测试变体创建\n- 品牌语言规范化调整\n- 语法和格式修正\n- 语气和调性统一\n\n### 冷启动邮件（cold-email）\n\n冷启动邮件技能专为 B2B 销售场景设计，帮助营销人员快速生成有效的冷启动外联邮件。该技能涵盖单封邮件撰写和多步骤邮件序列编排。\n\n**核心功能：**\n\n```mermaid\ngraph TD\n A[目标受众分析] --> B[邮件个性化策略]\n B --> C[开场白设计]\n C --> D[价值主张传递]\n D --> E[行动号召设置]\n E --> F[邮件序列编排]\n \n C --> G[单封冷启动邮件]\n D --> G\n E --> G\n \n F --> H[序列1: 首次接触]\n F --> I[序列2: 跟进邮件]\n F --> J[序列3: 最终唤起]\n```\n\n**API 集成支持：**\n该技能支持与多种邮件发送平台集成，包括 Postmark、ConvertKit、Mailchimp 等主流服务。\n\n资料来源：[skills/cold-email/SKILL.md](skills/cold-email/SKILL.md)\n\n### 自动化邮件序列（email-sequence）\n\n自动化邮件序列技能帮助营销团队设计和创建多步骤的自动化邮件流程，用于客户培育、欢迎序列、购物车挽回等多种场景。\n\n**邮件序列类型：**\n\n| 序列类型 | 典型邮件数量 | 发送周期 | 主要目的 |\n|---------|------------|---------|---------|\n| 欢迎序列 | 3-5 封 | 3-7 天 | 新用户激活 |\n| 培育序列 | 5-10 封 | 2-4 周 | 潜在客户培养 |\n| 挽回序列 | 2-3 封 | 1-3 天 | 购物车挽回 |\n| 再激活序列 | 3-5 封 | 1-2 周 | 沉睡用户唤醒 |\n\n**邮件内容结构：**\n每封邮件应包含清晰的标题、个性化问候、价值内容、行动号召按钮和退订链接。邮件长度应控制在合理范围内，确保移动端阅读体验。\n\n资料来源：[skills/email-sequence/SKILL.md](skills/email-sequence/SKILL.md)\n\n### 社交内容（social-content）\n\n社交内容技能专注于生成适合不同社交媒体平台的短格式内容，包括 LinkedIn、Twitter、Instagram 等主流平台的帖子和更新。\n\n**平台适配策略：**\n\n| 平台 | 内容风格 | 推荐长度 | 视觉要求 |\n|-----|---------|---------|---------|\n| LinkedIn | 专业洞察、行业发展 | 150-300 字符 | 高质量配图 |\n| Twitter/X | 简洁有力、话题标签 | 280 字符以内 | 可选配图/GIF |\n| Instagram | 视觉驱动、故事化 | 短文案 + 话题 | 必须配图 |\n| Facebook | 社区互动、轻松对话 | 100-250 字符 | 吸引眼球配图 |\n\n**内容创作原则：**\n\n- 保持品牌声音一致性\n- 使用强开场白吸引注意力\n- 包含明确的互动号召\n- 合理使用话题标签和 emoji\n\n资料来源：[skills/social-content/SKILL.md](skills/social-content/SKILL.md)\n\n### 图像创作（image）\n\n图像创作技能提供 AI 驱动的图像生成和设计能力，帮助营销团队快速创建各类视觉素材。该技能支持从提示词生成图像、图像编辑优化以及多尺寸适配输出。\n\n**核心功能模块：**\n\n```mermaid\ngraph TD\n A[图像创作需求] --> B[创作类型选择]\n \n B --> C[AI 生成图像]\n B --> D[图像编辑优化]\n B --> E[尺寸适配输出]\n \n C --> F[营销素材图]\n C --> G[社交媒体配图]\n C --> H[产品展示图]\n \n D --> I[背景移除]\n D --> J[风格转换]\n D --> K[图像增强]\n \n E --> L[社交媒体尺寸]\n E --> M[广告素材尺寸]\n E --> N[网站图片优化]\n```\n\n资料来源：[skills/image/SKILL.md](skills/image/SKILL.md)\n\n### 视频内容（video）\n\n视频内容技能专注于产品演示、教程和营销视频的脚本创作与内容规划。该技能帮助团队高效规划视频结构、撰写吸引人的脚本，并确保视频内容与整体营销策略保持一致。\n\n**视频类型支持：**\n\n- 产品功能演示\n- 操作教程和指南\n- 客户成功案例\n- 品牌故事和理念传达\n- 社交媒体短视频\n\n资料来源：[skills/video/SKILL.md](skills/video/SKILL.md)\n\n## 工作流程集成\n\n内容与文案技能组支持与项目的分析和跟踪工具集成，实现内容效果的数据闭环：\n\n```mermaid\ngraph LR\n A[内容创作] --> B[GA4 分析跟踪]\n A --> C[邮件发送统计]\n A --> D[转化归因]\n \n B --> E[效果优化建议]\n C --> E\n D --> E\n \n E --> A\n```\n\n**典型使用场景：**\n\n1. **落地页优化流程**：使用 copywriting 创建页面文案 → 通过 GA4 设置转化跟踪 → 分析用户行为数据 → 使用 copy-editing 优化文案\n\n2. **邮件营销流程**：使用 cold-email 创建外联邮件 → 使用 email-sequence 设计培育序列 → 通过邮件平台发送 → 跟踪打开率和点击率\n\n3. **社交媒体运营**：使用 social-content 创建帖子 → 使用 image 生成配图 → 发布到各平台 → 分析互动数据优化内容策略\n\n资料来源：[README.md](README.md)\n\n## 工具集成\n\n内容与文案技能组与项目中的多种工具实现集成，提供了完整的营销技术栈支持：\n\n| 工具类别 | 集成工具 | 功能支持 |\n|---------|---------|---------|\n| 邮件发送 | Postmark, Mailchimp, ConvertKit | 邮件发送、模板管理、退订处理 |\n| 分析跟踪 | GA4 | 页面访问、事件跟踪、转化归因 |\n| 设计协作 | Figma | 设计稿同步、评论反馈 |\n| 社交管理 | Buffer, Hootsuite | 定时发布、内容日历 |\n| CRM 集成 | HubSpot, Salesforce | 线索管理、邮件序列触发 |\n\n资料来源：[tools/REGISTRY.md](tools/REGISTRY.md)\n\n## 最佳实践\n\n### 内容质量标准\n\n- 所有文案应经过至少一轮审查和修改\n- 保持品牌声音和语调的一致性\n- 确保内容的准确性和可验证性\n- 针对不同渠道进行内容适配\n\n### 版本控制与迭代\n\n```mermaid\ngraph TD\n A[初稿创作] --> B[内部审查]\n B --> C{通过审核?}\n C -->|否| D[修改润色]\n D --> B\n C -->|是| E[A/B 测试变体]\n E --> F[数据分析]\n F --> G{效果达标?}\n G -->|否| D\n G -->|是| H[正式发布]\n```\n\n### 性能指标监控\n\n内容效果应通过以下关键指标进行监控：\n\n- **落地页**：转化率、跳出率、停留时间\n- **邮件**：打开率、点击率、退订率\n- **社交**：互动率、分享数、关注增长\n\n## 总结\n\n内容与文案技能组为营销团队提供了从策略规划到执行落地的完整内容创作解决方案。通过模块化的技能设计和灵活的组合方式，团队可以根据具体需求选择合适的技能组合，快速生成高质量的营销内容。技能的标准化和最佳实践的固化，确保了内容产出的一致性和可扩展性。\n\n---\n\n\n\n## SEO与发现技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [CLI工具集](#cli-tools)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/seo-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/SKILL.md)\n- [skills/ai-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/SKILL.md)\n- [skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)\n- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)\n- [skills/competitor-alternatives/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-alternatives/SKILL.md)\n- [skills/schema-markup/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/SKILL.md)\n- [skills/aso-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/aso-audit/SKILL.md)\n
\n\n# SEO与发现技能组\n\n## 概述\n\nSEO与发现技能组是Marketing Skills仓库中专注于提升内容可发现性和搜索引擎排名的技能集合。该技能组包含七个核心技能模块，涵盖了从技术SEO审计到AI驱动的内容优化、从程序化页面生成到结构化数据标记的完整SEO工作流程。\n\n这些技能协同工作，帮助营销团队系统性地优化网站的搜索可见性，同时支持程序化SEO策略以实现规模化内容生产。技能组的设计遵循模块化原则，每个技能可以独立使用，也可以组合形成完整的SEO优化方案。\n\n资料来源：[README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n\n## 技能组架构\n\n```mermaid\ngraph TD\n subgraph \"SEO与发现技能组\"\n A[seo-audit
SEO审计]\n B[ai-seo
AI驱动SEO]\n C[programmatic-seo
程序化SEO]\n D[site-architecture
网站架构]\n E[competitor-alternatives
竞品替代]\n F[schema-markup
结构化数据]\n G[aso-audit
ASO审计]\n end\n \n A --> D\n A --> F\n B --> F\n C --> D\n E --> A\n G --> A\n```\n\n## 核心技能详解\n\n### 1. SEO审计 (seo-audit)\n\nSEO审计技能负责对网站进行全面的技术健康检查，识别影响搜索排名的技术问题。\n\n#### 主要功能\n\n| 功能类别 | 描述 |\n|---------|------|\n| 索引状态分析 | 检查页面是否被搜索引擎正确索引 |\n| 元数据审查 | 验证标题标签、描述标签的优化情况 |\n| 链接健康检查 | 识别断链、重定向问题和内部链接结构 |\n| 页面速度评估 | 测量Core Web Vitals指标 |\n| 移动友好性测试 | 确保移动端用户体验符合标准 |\n\n#### 集成工具\n\n该技能依赖以下集成工具进行数据收集和分析：\n\n- **Google Search Console** - 搜索表现数据、索引状态监控\n- **Ahrefs** - 域名评级、反向链接分析、关键词排名\n- **Screaming Frog** - 网站爬取和技术问题识别\n\n资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n\n### 2. AI驱动SEO (ai-seo)\n\nAI驱动SEO技能专注于优化内容以获得AI助手的引用和推荐，这代表了搜索优化的新方向。\n\n#### 生成引擎优化模式\n\n```mermaid\ngraph LR\n A[高质量内容创作] --> B[统计引用块]\n A --> C[E-E-A-T信号]\n A --> D[自包含答案块]\n B --> E[AI引用机会增加]\n C --> E\n D --> E\n```\n\n#### 内容优化策略\n\n该技能采用多种GEO（生成引擎优化）模式来提升内容被AI引用的概率：\n\n**E-E-A-T信号块**\n\n强调经验、专业性、权威性和可信度，特别适用于YMYL（Your Money Your Life）主题的内容。Google搜索质量评估指南确认，信任是最关键因素，可信度低的页面即使看起来专业权威也会被评为低E-E-A-T。\n\n**自包含答案块**\n\n创建可直接引用、独立成立的完整答案块，包含具体细节、数字或示例，便于AI助手直接提取使用。\n\n**证据三明治结构**\n\n将声明与支撑证据配对，包括数据点列表和将证据与可操作洞察联系起来的结论性陈述。\n\n资料来源：[skills/ai-seo/references/content-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/content-patterns.md)\n\n### 3. 程序化SEO (programmatic-seo)\n\n程序化SEO技能用于大规模页面生成，通过模板和数据驱动的方式批量创建针对特定关键词的优化页面。\n\n#### 适用场景\n\n| 场景 | 描述 |\n|------|------|\n| 地理位置页面 | 为每个城市/地区生成独立页面 |\n| FAQ页面群 | 按主题批量生成问答内容 |\n| 产品比较页面 | 基于产品属性自动生成对比表 |\n| 行业术语词典 | 批量创建词条定义页面 |\n\n#### 内容模型\n\n程序化SEO依赖结构化的内容类型定义，包括页面元数据和可编程字段。内容模型需要定义动态字段以支持程序化内容生成，同时包含标准SEO字段如metaTitle、metaDescription和slug。\n\n资料来源：[skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)\n\n### 4. 网站架构 (site-architecture)\n\n网站架构技能定义了页面的层级结构、导航系统和URL规范，确保搜索引擎能够有效抓取和理解网站内容。\n\n#### 导航模式\n\n**简单导航头**\n\n适用于小型企业、简单SaaS或作品集网站，遵循以下规则：\n\n- Logo始终链接到首页\n- CTA按钮位于最右侧，视觉上突出\n- 按优先级排序（访问量最高的优先）\n- 当前页面获得视觉指示器（下划线、加粗或颜色变化）\n\n**大型菜单导航**\n\n适用于功能丰富的SaaS、电子商务或有大量内容分类的网站：\n\n- 2-4列布局\n- 按功能区域、用例或受众逻辑分组\n- 底部包含\"查看全部\"链接\n- 大型菜单内不嵌套下拉菜单\n\n#### 内容模型\n\n网站架构技能定义了核心内容类型及其字段：\n\n| 内容类型 | 核心字段 | 用途 |\n|---------|---------|------|\n| Landing Page | title, headline, body, ctaText, ctaUrl | 转化导向页面 |\n| Blog Post | title, slug, author, publishDate, body, category | 博客文章 |\n| Documentation | title, slug, body, category | 帮助文档 |\n| Author | name, bio, avatar, socialLinks | 博客作者信息 |\n| CTA Block | heading, body, buttonText, buttonUrl, variant | 可复用CTA |\n\n#### SEO字段清单\n\n每个页面级内容类型都需要配置以下字段：\n\n| 字段 | 描述 | 建议长度 |\n|------|------|---------|\n| metaTitle | 元标题 | 50-60字符 |\n| metaDescription | 元描述 | 150-160字符 |\n| ogImage | 社交分享图 | 1200x630像素 |\n| slug | URL路径段 | 简短有意义 |\n| canonicalUrl | 规范链接 | 可选覆盖 |\n| noIndex | 索引排除 | 布尔值 |\n| structuredData | 结构化数据 | 可选JSON-LD |\n\n资料来源：[skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n\n### 5. 竞品替代页面 (competitor-alternatives)\n\n竞品替代技能用于创建针对竞争对手的比较页面，帮助用户发现和评估替代产品。\n\n#### 研究流程\n\n```mermaid\ngraph TD\n A[竞品URL] --> B[Firecrawl Map
发现站点结构]\n B --> C[识别关键页面]\n C --> D[Firecrawl Scrape
抓取页面内容]\n D --> E[提取定位和功能信息]\n E --> F[生成竞品档案]\n F --> G[创建替代对比页面]\n```\n\n#### 优先抓取页面类型\n\n| 页面类型 | 提取内容 |\n|---------|---------|\n| 首页 | 标题、副标题、价值主张、主要CTA、社会证明 |\n| 定价页 | 定价层级、功能对比、计费选项、免费试用 |\n| 功能页 | 功能分类、主要功能、功能描述 |\n| 关于页 | 公司信息、团队背景、发展历程 |\n\n#### 数据工具\n\n- **Firecrawl Map** - 发现站点结构，识别关键页面\n- **Firecrawl Scrape** - 批量抓取页面内容\n- **Firecrawl Extract** - 使用schema提取结构化数据\n\n资料来源：[skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n\n### 6. 结构化数据 (schema-markup)\n\n结构化数据技能为网页添加Schema.org标记，帮助搜索引擎理解页面内容并生成丰富搜索结果。\n\n#### 支持的Schema类型\n\n**Organization**\n\n用于品牌和组织信息，声明站点名称、标志和社交资料。\n\n**WebSite**\n\n用于整个网站，包含站点名称和搜索框配置，支持Sitelink搜索框。\n\n**Article/BlogPosting**\n\n用于博客文章和新闻，包含标题、图片、发布日期、作者和发布者信息。\n\n**Product**\n\n用于电商或SaaS产品页面，包含名称、图片、描述、价格和库存状态。\n\n#### JSON-LD格式示例\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Article\",\n \"headline\": \"文章标题\",\n \"image\": \"https://example.com/image.jpg\",\n \"datePublished\": \"2024-01-15T08:00:00+00:00\",\n \"author\": {\n \"@type\": \"Person\",\n \"name\": \"作者名称\"\n },\n \"publisher\": {\n \"@type\": \"Organization\",\n \"name\": \"公司名称\",\n \"logo\": {\n \"@type\": \"ImageObject\",\n \"url\": \"https://example.com/logo.png\"\n }\n }\n}\n```\n\n资料来源：[skills/schema-markup/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/references/schema-examples.md)\n\n### 7. ASO审计 (aso-audit)\n\nASO（应用商店优化）审计技能专注于提升移动应用在应用商店中的可见性，包括App Store和Google Play。\n\n#### 审计维度\n\n| 维度 | 描述 |\n|------|------|\n| 应用标题 | 关键词优化、品牌识别 |\n| 应用描述 | 关键词密度、价值主张 |\n| 截图和视频 | 视觉吸引力、功能展示 |\n| 评分和评论 | 用户反馈、问题识别 |\n| 关键词覆盖 | 搜索词排名监控 |\n\n资料来源：[skills/aso-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/aso-audit/SKILL.md)\n\n## 工作流程整合\n\n### 完整SEO优化流程\n\n```mermaid\ngraph TD\n subgraph \"阶段一：技术基础\"\n A1[网站架构规划] --> A2[URL结构设计]\n A2 --> A3[导航系统搭建]\n A3 --> A4[面包屑实现]\n end\n \n subgraph \"阶段二：内容创建\"\n B1[内容策略制定] --> B2[程序化页面生成]\n B2 --> B3[竞品替代页面]\n B3 --> B4[AI驱动内容优化]\n end\n \n subgraph \"阶段三：技术优化\"\n C1[结构化数据添加] --> C2[SEO审计执行]\n C2 --> C3[问题修复跟踪]\n C3 --> C4[持续监控]\n end\n \n A4 --> B1\n B4 --> C1\n C4 --> A1\n```\n\n### 技能间依赖关系\n\n| 源技能 | 目标技能 | 依赖说明 |\n|-------|---------|---------|\n| site-architecture | seo-audit | 提供URL结构和导航基础 |\n| site-architecture | programmatic-seo | 定义内容模型和模板 |\n| seo-audit | schema-markup | 基于审计结果添加标记 |\n| ai-seo | schema-markup | E-E-A-T内容支持结构化数据 |\n| competitor-alternatives | seo-audit | 提供竞品分析输入 |\n\n## 工具集成总览\n\n| 工具类别 | 工具名称 | 用途 |\n|---------|---------|------|\n| 分析平台 | Google Search Console | 搜索表现、索引状态 |\n| SEO工具 | Ahrefs | 域名评级、关键词、外链 |\n| 内容管理 | Sanity | 无头CMS，内容建模 |\n| 数据源 | ZoomInfo | 公司和联系人数据 |\n| 链接管理 | Dub.co | 短链接、UTM追踪 |\n| 网站发布 | WordPress | 内容发布和媒体管理 |\n| 客户数据 | Optimizely | 实验和个性化 |\n\n资料来源：[tools/integrations/ahrefs.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/ahrefs.md)\n\n## 最佳实践\n\n### 内容创作标准\n\n1. **E-E-A-T优先** - 在所有内容中强调经验、专业性、权威性和可信度\n2. **自包含答案** - 创建能被AI直接引用的独立答案块\n3. **统计引用** - 使用具体数据支撑声明，统计内容可提升15-30%的AI引用率\n4. **自然语言** - 使用自然的疑问句式，匹配用户实际搜索意图\n\n### 技术实现要点\n\n1. **SEO字段完整** - 每个页面必须包含metaTitle、metaDescription、slug\n2. **结构化数据验证** - 使用Google Rich Results Test验证Schema标记\n3. **导航一致性** - 保持全站导航模式统一，面包屑清晰准确\n4. **性能优先** - 优化Core Web Vitals指标，特别是LCP和CLS\n\n### 程序化SEO注意事项\n\n1. **避免重复内容** - 确保程序化页面有足够的独特价值\n2. **内部链接策略** - Hub-and-Spoke模型建立主题集群\n3. **规范化处理** - 使用canonical标签防止内部重复\n4. **分层架构** - 高权重页面支撑长尾页面\n\n## 总结\n\nSEO与发现技能组提供了从技术审计到AI优化的完整SEO解决方案。通过整合这七个核心技能，营销团队可以系统性地提升网站在传统搜索引擎和AI助手中的可见性，实现可持续的有机流量增长。技能组的模块化设计允许团队根据具体需求选择使用单个技能或组合多个技能，形成定制化的SEO工作流程。\n\n---\n\n\n\n## 增长与收入技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [CLI工具集](#cli-tools)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)\n- [skills/content-strategy/references/headless-cms.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/content-strategy/references/headless-cms.md)\n- [skills/competitor-alternatives/references/templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-alternatives/references/templates.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [tools/integrations/zoominfo.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/zoominfo.md)\n
\n\n# 增长与收入技能组\n\n## 概述\n\n增长与收入技能组是 marketingskills 项目中专注于业务扩张、变现策略和销售运营的技能集合。该技能组涵盖从获客增长到客户保留的完整业务增长周期，旨在帮助 SaaS 企业实现可持续的收入增长。\n\n根据项目结构，该技能组包含以下核心领域：\n\n| 技能分类 | 技能名称 | 用途说明 |\n|---------|---------|---------|\n| 增长工程 | `co-marketing` | 合作伙伴识别与联合营销活动 |\n| 增长工程 | `free-tool-strategy` | 营销工具与计算器策略 |\n| 增长工程 | `referral-program` | 推荐与联盟项目 |\n| 策略与变现 | `marketing-ideas` | 140个 SaaS 营销创意 |\n| 策略与变现 | `marketing-psychology` | 心理模型与用户心理 |\n| 策略与变现 | `launch-strategy` | 产品发布与公告 |\n| 策略与变现 | `pricing-strategy` | 定价、包装与商业化 |\n| 销售与运营 | `revops` | 潜在客户生命周期、评分、路由与管道管理 |\n| 销售与运营 | `sales-enablement` | 销售演示、单页资料、异议处理文档与演示脚本 |\n| 转化优化 | `page-cro` | 营销页面优化 |\n| 转化优化 | `signup-flow-cro` | 注册流程优化 |\n| 转化优化 | `onboarding-cro` | 激活流程优化 |\n| 转化优化 | `churn-prevention` | 流失防止、取消流程、挽留优惠与付款恢复 |\n| 付费分发 | `paid-ads` | Google、Meta、LinkedIn 广告活动 |\n| 付费分发 | `ad-creative` | 批量广告创意生成与迭代 |\n\n资料来源：[README.md]()\n\n## 架构总览\n\n增长与收入技能组采用分层架构，涵盖从获客到留存的全链路。\n\n```mermaid\ngraph TD\n subgraph \"获客层\"\n PA[paid-ads
付费广告]\n CC[co-marketing
联合营销]\n FT[free-tool-strategy
免费工具策略]\n RP[referral-program
推荐计划]\n end\n\n subgraph \"转化层\"\n PC[page-cro
页面优化]\n SF[signup-flow-cro
注册流程]\n OB[onboarding-cro
激活流程]\n end\n\n subgraph \"变现层\"\n PS[pricing-strategy
定价策略]\n LS[launch-strategy
发布策略]\n SE[sales-enablement
销售赋能]\n end\n\n subgraph \"留存层\"\n CP[churn-prevention
流失防止]\n RV[revops
收入运营]\n end\n\n subgraph \"策略层\"\n MI[marketing-ideas
营销创意]\n MP[marketing-psychology
营销心理学]\n end\n\n PA --> PC\n CC --> PC\n FT --> PC\n RP --> PC\n PC --> SF\n SF --> OB\n OB --> PS\n PS --> SE\n SE --> RV\n OB --> CP\n CP --> RV\n LS --> PA\n MI --> CC\n MP --> FT\n\n style PA fill:#e1f5ff\n style PS fill:#fff3e0\n style CP fill:#f3e5f5\n style RV fill:#e8f5e9\n```\n\n## 核心技能详解\n\n### 1. 增长工程技能\n\n增长工程技能组专注于通过创新策略和合作伙伴关系实现用户增长。\n\n#### 1.1 联合营销 (co-marketing)\n\n联合营销技能帮助识别潜在合作伙伴并策划联合营销活动。该技能涵盖：\n\n- **合作伙伴识别**：根据目标受众重叠度、品牌定位匹配度评估合作伙伴\n- **活动策划**：设计联合网络研讨会、内容合作、联合推广等活动\n- **ROI 追踪**：建立双方认可的效果衡量指标\n\n#### 1.2 免费工具策略 (free-tool-strategy)\n\n免费工具策略技能用于设计营销导向的工具和计算器：\n\n- **工具类型**：ROI 计算器、ROI 预测工具、行业基准工具\n- **获客机制**：通过工具使用引导用户留下联系方式\n- **数据收集**：在用户使用工具过程中收集行为数据\n\n```mermaid\ngraph LR\n A[用户访问
免费工具] --> B[使用工具
获得价值]\n B --> C[查看结果
需要邮箱]\n C --> D[获取报告
留下联系方式]\n D --> E[触发线索
培育流程]\n \n style A fill:#e3f2fd\n style E fill:#c8e6c9\n```\n\n#### 1.3 推荐计划 (referral-program)\n\n推荐计划技能涵盖推荐人和被推荐人的激励机制设计：\n\n- **双面奖励**：为推荐人和被推荐人提供双向奖励\n- **分级机制**：根据推荐数量设置阶梯奖励\n- **防刷机制**：识别虚假推荐和激励滥用\n\n### 2. 策略与变现技能\n\n#### 2.1 营销创意 (marketing-ideas)\n\n该技能提供 140 个 SaaS 营销创意，涵盖：\n\n- 内容营销策略\n- 社交媒体增长策略\n- 社区建设策略\n- 合作伙伴策略\n\n#### 2.2 营销心理学 (marketing-psychology)\n\n运用心理模型优化营销效果：\n\n- **承诺与一致性**：通过小请求引导大承诺\n- **社会认同**：展示用户评价和使用数据\n- **稀缺性**：限时优惠和限量供应\n- **锚定效应**：设置高价选项引导选择\n\n#### 2.3 发布策略 (launch-strategy)\n\n产品发布技能包含完整的发布流程：\n\n```mermaid\ngraph TD\n P1[预热期
建立期待] --> P2[预告期
功能揭秘]\n P2 --> P3[发布日
全面上线]\n P3 --> P4[跟进期
用户反馈]\n P4 --> P5[优化期
迭代改进]\n \n style P1 fill:#fff3e0\n style P3 fill:#ffcdd2\n style P5 fill:#c8e6c9\n```\n\n#### 2.4 定价策略 (pricing-strategy)\n\n定价策略技能覆盖定价、包装和商业化的各个方面：\n\n| 定价模式 | 适用场景 | 关键考量 |\n|---------|---------|---------|\n| 按用户数定价 | B2B SaaS | 团队规模与使用量匹配 |\n| 按功能分层 | 功能差异化物 | 功能分层与价值感知 |\n| 用量计费 | API 产品 | 成本结构与扩展性 |\n| 混合定价 | 复杂产品 | 基础订阅 + 额外用量 |\n\n**定价心理学要素：**\n\n- 锚定价格设置\n- 视觉层次引导\n- 价值对比框架\n- 套餐捆绑策略\n\n### 3. 销售赋能技能\n\n#### 3.1 收入运营 (revops)\n\n收入运营技能覆盖销售运营的完整生命周期：\n\n```mermaid\ngraph TD\n LE[线索生成
Lead Generation] --> LEQ[线索资质认定
Lead Qualification]\n LEQ --> LH[线索分配
Lead Handoff]\n LH --> SQ[销售线索
Sales Qualified]\n SQ --> OP[商机管道
Opportunity]\n OP --> CN[谈判
Negotiation]\n CN --> CW[成交
Closed Won]\n CW --> IR[初始收入
Initial Revenue]\n \n style LE fill:#e3f2fd\n style SQ fill:#fff3e0\n style CW fill:#c8e6c9\n```\n\n**核心指标追踪：**\n\n- 线索转化率 (Lead Conversion Rate)\n- 销售周期 (Sales Cycle Length)\n- 管道覆盖率 (Pipeline Coverage)\n- 成交率 (Win Rate)\n\n#### 3.2 销售赋能 (sales-enablement)\n\n销售赋能技能提供标准化的销售辅助材料：\n\n| 材料类型 | 用途 | 关键要素 |\n|---------|-----|---------|\n| 销售演示 | 客户会议 | 痛点共鸣、解决方案、案例证明 |\n| 单页资料 | 快速传递价值 | 单页概述、关键指标、CTA |\n| 异议处理 | 应对客户疑虑 | 常见反对意见及标准答复 |\n| 演示脚本 | 产品演示 | 关键功能点、价值语言 |\n\n### 4. 转化优化技能\n\n#### 4.1 页面转化优化 (page-cro)\n\n营销页面优化涵盖以下关键元素：\n\n**首屏优化要素：**\n\n- 价值主张清晰表达\n- 社会认同元素展示\n- 主要 CTA 突出显示\n\n**信任信号布局：**\n\n- 客户 logo 展示\n- 评价和推荐\n- 安全认证标识\n\n#### 4.2 注册流程优化 (signup-flow-cro)\n\n注册流程优化关注转化漏斗的每一步：\n\n```mermaid\ngraph LR\n A[开始注册] --> B{邮箱输入}\n B -->|成功| C{密码设置}\n B -->|失败| B\n C -->|成功| D{邮箱验证}\n C -->|失败| C\n D -->|成功| E[注册完成]\n D -->|失败| D\n \n style E fill:#c8e6c9\n```\n\n**优化要点：**\n\n- 减少必填字段数量\n- 实时表单验证\n- 渐进式表单设计\n- 社会化登录选项\n\n#### 4.3 激活流程优化 (onboarding-cro)\n\n新用户激活流程确保用户快速发现产品价值：\n\n- 引导式入职流程\n- 个性化激活路径\n- 关键里程碑设置\n- 早期成功指标追踪\n\n### 5. 留存与流失防止\n\n#### 5.1 流失防止 (churn-prevention)\n\n流失防止技能覆盖整个客户生命周期：\n\n```mermaid\ngraph TD\n subgraph \"客户成功管理\"\n ON[新用户激活] --> UU[正常使用]\n UU --> HR[健康度监控]\n HR --> RI[风险识别]\n RI --> IR[干预措施]\n IR --> RS[问题解决]\n RS --> RU[恢复使用]\n end\n\n subgraph \"风险信号\"\n RI --> RS1[低活跃度]\n RI --> RS2[低功能使用]\n RI --> RS3[支持工单增加]\n RI --> RS4[支付问题]\n end\n\n style ON fill:#e3f2fd\n style RI fill:#ffcdd2\n style RS fill:#c8e6c9\n```\n\n**流失防止策略：**\n\n| 策略类型 | 触发条件 | 干预措施 |\n|---------|---------|---------|\n| 挽留优惠 | 检测到流失意向 | 折扣、增值功能 |\n| 主动关怀 | 使用频率下降 | 1v1 沟通、引导使用 |\n| Dunning | 支付失败 | 付款提醒、多方式重试 |\n| 取消流程 | 用户申请取消 | 取消原因收集、最终优惠 |\n\n### 6. 付费分发技能\n\n#### 6.1 付费广告 (paid-ads)\n\n付费广告技能覆盖主流广告平台的投放策略：\n\n| 平台 | 适用目标 | 核心指标 |\n|-----|---------|---------|\n| Google Ads | 搜索意图明确 | CPC、转化率、质量得分 |\n| Meta Ads | 品牌认知、漏斗中层 | CPM、CPC、ROAS |\n| LinkedIn Ads | B2B 决策者触达 | CPM、CPC、线索成本 |\n\n**广告活动结构：**\n\n- 活动层级：Campaign → Ad Set → Ad\n- 受众分层：人口统计 + 兴趣 + 行为\n- 出价策略：手动出价 vs 目标 ROAS\n\n#### 6.2 广告创意 (ad-creative)\n\n广告创意技能支持批量生成和迭代优化：\n\n- 多变体 A/B 测试\n- 素材规格适配（图片、视频、轮播）\n- 文案模板库\n- 效果追踪与分析\n\n## 工具集成\n\n增长与收入技能组支持与多种营销工具集成：\n\n### 客户数据与情报\n\n| 工具 | 功能 | 集成方式 |\n|-----|-----|---------|\n| ZoomInfo | B2B 联系人数据 | API 批量查询 |\n\n**ZoomInfo 关键接口：**\n\n```json\n// 联系人搜索\nPOST https://api.zoominfo.com/search/contact\n{\n \"firstName\": [\"Jane\"],\n \"lastName\": [\"Doe\"],\n \"jobTitle\": [\"VP Marketing\"],\n \"companyName\": [\"Acme Corp\"],\n \"rpp\": 25,\n \"page\": 1\n}\n\n// 联系人富化\nPOST https://api.zoominfo.com/enrich/contact\n{\n \"matchEmail\": [\"jane@acme.com\"]\n}\n```\n\n资料来源：[tools/integrations/zoominfo.md]()\n\n### 邮件营销\n\n| 工具 | 功能 | 集成方式 |\n|-----|-----|---------|\n| Postmark | 交易邮件、模板管理 | REST API |\n\n**Postmark 核心功能：**\n\n- 邮件模板创建与管理\n- 批量发送与统计\n- 退信处理与激活\n- 打开和点击追踪\n\n资料来源：[tools/integrations/postmark.md]()\n\n### 内容管理\n\n| 工具 | 功能 | 适用场景 |\n|-----|-----|---------|\n| Sanity | 无头 CMS | 结构化内容管理 |\n\n**Sanity 内容类型设计：**\n\n| 内容类型 | 核心字段 | 用途 |\n|---------|---------|-----|\n| Page | title, slug, content, seo | 营销页面 |\n| BlogPost | title, body, author, category | 博客内容 |\n| Author | name, bio, avatar, socialLinks | 作者信息 |\n| CTA Block | heading, body, buttonText, buttonUrl | 可复用 CTA |\n\n资料来源：[skills/content-strategy/references/headless-cms.md]()\n\n## 最佳实践\n\n### 增长策略框架\n\n1. **测量优先**：建立完整的数据追踪体系\n2. **快速迭代**：小步快跑，持续优化\n3. **用户洞察**：深入理解用户旅程和痛点\n4. **跨职能协作**：增长、产品、销售协同\n\n### 收入运营流程\n\n```mermaid\ngraph LR\n A[数据收集] --> B[分析洞察]\n B --> C[策略制定]\n C --> D[执行实施]\n D --> E[效果验证]\n E --> A\n\n style A fill:#e3f2fd\n style B fill:#fff3e0\n style C fill:#f3e5f5\n style D fill:#e8f5e9\n style E fill:#ffecb3\n```\n\n### 流失防止机制\n\n- **预警系统**：建立客户健康度评分模型\n- **自动化干预**：基于触发的自动关怀流程\n- **人工介入**：高价值客户的专属关怀\n\n## 相关资源\n\n- **贡献指南**：[CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - 学习如何添加新技能\n- **项目架构**：[CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md) - 项目结构说明\n- **站点架构**：[skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md) - 页面层次结构设计\n\n## 总结\n\n增长与收入技能组构成了 marketingskills 项目中实现业务增长的核心能力矩阵。该技能组从获客增长（付费广告、联合营销、推荐计划）到转化优化（页面优化、注册流程、入职激活），再到变现策略（定价策略、销售赋能）和客户留存（收入运营、流失防止），覆盖了 SaaS 企业增长的全生命周期。\n\n通过灵活组合这些技能，营销团队可以构建完整的增长引擎，实现可持续的收入增长目标。\n\n---\n\n\n\n## CLI工具集\n\n### 相关页面\n\n相关主题：[SEO与发现技能组](#seo-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [tools/REGISTRY.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/REGISTRY.md)\n- [tools/clis/README.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/README.md)\n- [tools/clis/google-ads.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/google-ads.js)\n- [tools/clis/meta-ads.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/meta-ads.js)\n- [tools/clis/ga4.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/ga4.js)\n- [tools/clis/hubspot.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/hubspot.js)\n- [tools/integrations/ahrefs.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/ahrefs.md)\n- [tools/integrations/zoominfo.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/zoominfo.md)\n
\n\n# CLI工具集\n\n## 概述\n\nCLI工具集是marketingskills项目中的命令行接口模块，位于`tools/clis/`目录下。该模块为市场营销专业人员提供了一套统一的命令行工具，用于管理与Google Ads、Meta Ads、Google Analytics 4、HubSpot等主流营销平台的交互。\n\nCLI工具集的主要目标是简化营销自动化工作流程，使营销人员能够在终端环境中直接执行广告管理、分析查询和CRM操作等任务。通过统一的命令行界面，用户可以快速集成到现有的开发或自动化流程中。\n\n## 架构设计\n\n```mermaid\ngraph TD\n subgraph \"CLI工具集架构\"\n CLI[\"CLI入口
node cli-name.js\"]\n REGISTRY[\"工具注册表
REGISTRY.md\"]\n GOOGLE[\"google-ads.js\"]\n META[\"meta-ads.js\"]\n GA4[\"ga4.js\"]\n HUBSPOT[\"hubspot.js\"]\n OPTIMIZELY[\"optimizely.js\"]\n LIVESTORM[\"livestorm.js\"]\n end\n \n CLI --> REGISTRY\n REGISTRY --> GOOGLE\n REGISTRY --> META\n REGISTRY --> GA4\n REGISTRY --> HUBSPOT\n REGISTRY --> OPTIMIZELY\n REGISTRY --> LIVESTORM\n \n GOOGLE --> GOOGLE_API[\"Google Ads API\"]\n META --> META_API[\"Meta Marketing API\"]\n GA4 --> GA4_API[\"GA4 Data API\"]\n HUBSPOT --> HS_API[\"HubSpot API\"]\n```\n\n## 核心组件\n\n### 工具注册表\n\n工具注册表（`tools/REGISTRY.md`）是CLI工具集的核心配置文件，定义了所有可用工具的元数据。每个工具条目包含以下字段：\n\n| 字段 | 必填 | 说明 |\n|------|------|------|\n| `name` | 是 | 工具名称（小写字母、数字、连字符） |\n| `description` | 是 | 工具功能描述（1-1024字符） |\n| `license` | 否 | 许可证类型（默认MIT） |\n| `metadata` | 否 | 键值对元数据（作者、版本等） |\n\n**名称字段规则：**\n\n- 仅使用小写字母、数字和连字符\n- 不能以连字符开头或结尾\n- 禁止连续连字符\n- 必须与父目录名称完全匹配\n\n### Google Ads CLI\n\nGoogle Ads命令行工具（`tools/clis/google-ads.js`）提供与Google Ads平台的交互能力。该工具支持广告系列管理、关键词查询和效果报告等核心功能。\n\n**主要功能模块：**\n\n- 广告系列（Campaigns）管理\n- 广告组（Ad Groups）操作\n- 关键词（Keywords）查询\n- 转化追踪配置\n\n### Meta Ads CLI\n\nMeta Ads命令行工具（`tools/clis/meta-ads.js`）用于管理Facebook和Instagram广告。该工具封装了Meta Marketing API的核心功能。\n\n**支持的API端点类型：**\n\n- 账户层级操作\n- 广告系列管理\n- 受众定向\n- 广告创意管理\n\n### Google Analytics 4 CLI\n\nGA4命令行工具（`tools/clis/ga4.js`）提供对Google Analytics 4 Data API的访问。该工具允许用户查询网站和应用的分析数据。\n\n**关键指标类型：**\n\n| 类别 | 指标示例 |\n|------|----------|\n| 用户指标 | activeUsers, newUsers, totalUsers |\n| 会话指标 | sessions, bounces, sessionDuration |\n| 转化指标 | conversions, totalRevenue |\n| 事件指标 | eventCount, userEngagementDuration |\n\n### HubSpot CLI\n\nHubSpot命令行工具（`tools/clis/hubspot.js`）集成HubSpot CRM API，支持联系人、公司和交易管理。\n\n**核心功能：**\n\n- 联系人CRUD操作\n- 公司数据管理\n- 交易管道追踪\n- 营销自动化工作流触发\n\n### Optimizely CLI\n\nOptimizely命令行工具（`tools/clis/optimizely.js`）提供实验平台的管理能力。\n\n**命令结构：**\n\n```bash\noptimizely [options]\n\n可用命令：\n campaigns campaigns list --project-id \n experiments experiments list --project-id \n pages pages list --project-id \n \n选项参数：\n --page 页码\n --per-page 每页数量\n --status 状态过滤（not_started|running|paused|archived）\n```\n\n### Livestorm CLI\n\nLivestorm命令行工具（`tools/clis/livestorm.js`）管理虚拟活动和在线研讨会。\n\n**命令体系：**\n\n| 命令 | 功能 | 子命令示例 |\n|------|------|------------|\n| `events` | 活动管理 | list, get, create, update, delete |\n| `sessions` | 场次管理 | list, create, delete, register |\n| `people` | 参与者 | list, get |\n| `webhooks` | Webhook | list, create, delete |\n| `organization` | 组织信息 | organization |\n\n## 数据模型\n\n### 通用CLI输出格式\n\n所有CLI工具采用统一的JSON输出格式，便于后续处理和集成。\n\n```javascript\n// 成功响应\n{\n \"data\": [...],\n \"metadata\": {\n \"page\": 1,\n \"perPage\": 20,\n \"total\": 100\n }\n}\n\n// 错误响应\n{\n \"error\": \"错误消息\",\n \"code\": \"ERROR_CODE\"\n}\n```\n\n### 状态流转\n\n```mermaid\nstateDiagram-v2\n [*] --> 初始化: CLI启动\n 初始化 --> 认证: 加载配置\n 认证 --> 就绪: Token验证\n 就绪 --> 执行: 接收命令\n 执行 --> 处理: 解析参数\n 处理 --> API调用: 构建请求\n API调用 --> 响应解析: 获取结果\n 响应解析 --> 输出: 格式化JSON\n 输出 --> [*]: 完成\n 认证 --> 错误: 认证失败\n 执行 --> 错误: 参数错误\n 错误 --> [*]: 退出\n```\n\n## 工具使用工作流\n\n```mermaid\ngraph LR\n A[\"用户输入命令\"] --> B[\"CLI解析器\"]\n B --> C{\"命令有效性\"}\n C -->|有效| D[\"读取配置\"]\n C -->|无效| E[\"显示帮助信息\"]\n D --> F[\"调用工具模块\"]\n F --> G[\"API认证\"]\n G --> H[\"发送请求\"]\n H --> I{\"响应状态\"}\n I -->|成功| J[\"解析响应数据\"]\n I -->|失败| K[\"输出错误信息\"]\n J --> L[\"格式化输出\"]\n L --> M[\"终端显示\"]\n```\n\n## 与集成工具的关系\n\nCLI工具集与`tools/integrations/`目录下的其他集成工具协同工作，形成完整的营销技术栈：\n\n| CLI工具 | 对应集成 | 主要用途 |\n|---------|----------|----------|\n| google-ads.js | - | 广告投放管理 |\n| meta-ads.js | - | 社交广告管理 |\n| ga4.js | - | 数据分析 |\n| hubspot.js | ahrefs.md, zoominfo.md | CRM与数据丰富 |\n| optimizely.js | - | A/B测试与实验 |\n| livestorm.js | - | 活动管理 |\n\n## 安全与认证\n\n### 环境变量配置\n\nCLI工具通过环境变量管理敏感凭证：\n\n```bash\n# Google Ads\nexport GOOGLE_ADS_DEVELOPER_TOKEN=\"your-token\"\nexport GOOGLE_ADS_CLIENT_ID=\"your-client-id\"\nexport GOOGLE_ADS_CLIENT_SECRET=\"your-secret\"\n\n# Meta Ads\nexport META_ACCESS_TOKEN=\"your-token\"\n\n# GA4\nexport GOOGLE_APPLICATION_CREDENTIALS=\"/path/to/service-account.json\"\n\n# HubSpot\nexport HUBSPOT_ACCESS_TOKEN=\"your-token\"\n```\n\n### 最佳实践\n\n- 凭证不应硬编码在源码中\n- 使用`.env`文件管理本地开发环境\n- 生产环境使用密钥管理服务\n- 定期轮换API访问令牌\n\n## 扩展指南\n\n### 新增CLI工具\n\n在`tools/clis/`目录下创建新的CLI工具文件：\n\n```\ntools/clis/\n├── new-tool.js\n└── ...\n```\n\n工具文件应遵循以下结构：\n\n```javascript\n#!/usr/bin/env node\n\nfunction main() {\n // 主逻辑\n const result = {\n command: 'new-tool',\n options: { /* 参数定义 */ },\n description: '工具功能描述'\n };\n \n console.log(JSON.stringify(result, null, 2));\n}\n\nmain().catch(err => {\n console.error(JSON.stringify({ error: err.message }));\n process.exit(1);\n});\n```\n\n### 注册新工具\n\n在`tools/REGISTRY.md`中添加新工具条目，确保：\n\n- `name`字段与文件名匹配\n- 提供清晰的`description`\n- 包含完整的`metadata`信息\n\n## 相关资源\n\n- 集成工具文档：[tools/integrations/](../integrations/)\n- 工具注册表配置：[tools/REGISTRY.md](./REGISTRY.md)\n- 源码示例：[tools/clis/](./)\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：coreyhaines31/marketingskills\n\n摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令：`npx skills`\n- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n\n## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 7. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n\n## 8. 能力坑 · 能力判断依赖假设\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:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\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:1135212071 | https://github.com/coreyhaines31/marketingskills | 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:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.\n\n## 12. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。\n\n## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。\n\n## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。\n\n## 18. 维护坑 · 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:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown\n\n## 19. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown\n\n\n", "markdown_key": "marketingskills", "pages": "draft", "source_refs": [ { "evidence_id": "github_repo:1135212071", "kind": "repo", "supports_claim_ids": [ "claim_identity", "claim_distribution", "claim_capability" ], "url": "https://github.com/coreyhaines31/marketingskills" }, { "evidence_id": "art_d9af7090892945088ff3f7c4a813376e", "kind": "docs", "supports_claim_ids": [ "claim_identity", "claim_distribution", "claim_capability" ], "url": "https://github.com/coreyhaines31/marketingskills#readme" } ], "summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。", "title": "marketingskills 说明书", "toc": [ "https://github.com/coreyhaines31/marketingskills 项目说明书", "目录", "项目概述", "项目简介", "核心设计理念", "项目架构", "技能系统详解", "代理集成机制", "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": "906c2fb28e471c5b1d149d4159ec5ddb40b7c364", "repo_inspection_error": null, "repo_inspection_files": [ "README.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": "# marketingskills - Doramagic AI Context Pack\n\n> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。\n\n## 充分原则\n\n- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。\n- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。\n\n## 给宿主 AI 的使用方式\n\n你正在读取 Doramagic 为 marketingskills 编译的 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 文档。 证据：`skills/ab-test-setup/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ai-seo/SKILL.md`, `skills/analytics-tracking/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n\n## 它能做什么\n\n- **AI Skill / Agent 指令资产库**（可做安装前预览）：项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 证据：`skills/ab-test-setup/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ai-seo/SKILL.md`, `skills/analytics-tracking/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**（需要安装后验证）：项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n## 怎么开始\n\n- `npx skills add coreyhaines31/marketingskills` 证据：`README.md` Claim：`clm_0006` supported 0.86, `clm_0007` supported 0.86, `clm_0008` supported 0.86\n- `npx skills add coreyhaines31/marketingskills --skill page-cro copywriting` 证据：`README.md` Claim：`clm_0007` supported 0.86\n- `npx skills add coreyhaines31/marketingskills --list` 证据：`README.md` Claim：`clm_0008` supported 0.86\n- `/plugin marketplace add coreyhaines31/marketingskills` 证据：`README.md` Claim：`clm_0009` supported 0.86\n- `/plugin install marketing-skills` 证据：`README.md` Claim：`clm_0010` supported 0.86\n- `git clone https://github.com/coreyhaines31/marketingskills.git` 证据：`README.md` Claim：`clm_0011` supported 0.86\n- `npx skillkit install coreyhaines31/marketingskills` 证据：`README.md` Claim：`clm_0012` supported 0.86, `clm_0013` supported 0.86, `clm_0014` supported 0.86\n- `npx skillkit install coreyhaines31/marketingskills --skill page-cro copywriting` 证据：`README.md` Claim：`clm_0013` supported 0.86\n- `npx skillkit install coreyhaines31/marketingskills --list` 证据：`README.md` Claim：`clm_0014` 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 或项目证据支撑，但仍不等于真实安装效果。 证据：`skills/ab-test-setup/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ai-seo/SKILL.md`, `skills/analytics-tracking/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n- **能力存在：AI Skill / Agent 指令资产库**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`skills/ab-test-setup/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ai-seo/SKILL.md`, `skills/analytics-tracking/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **能力存在：多宿主安装与分发**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0002` 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, `clm_0007` supported 0.86, `clm_0008` 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`, `skills/ab-test-setup/SKILL.md` 等\n- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。\n- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.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`, `skills/ab-test-setup/SKILL.md` 等\n- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `README.md`\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_0015` inferred 0.45\n- **宿主 AI 插件或 Skill 规则冲突**：新规则可能改变用户现有宿主 AI 的工作方式。 处理方式：安装前先检查插件 manifest 和 Skill 文件，必要时隔离测试。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0016` supported 0.86\n- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`README.md` Claim：`clm_0017` supported 0.86\n- **源文档冲突：skill_count**：项目文档中存在数量表述不一致，AI Context Pack 必须提示用户不要把单一数字当作已验证事实。 处理方式：在 Human Manual 和 AI Context Pack 中共同标记为待核实，而不是强行选择一个数字。 证据：`VERSIONS.md`, `VERSIONS.md` Claim：`clm_0018` supported 0.86, `clm_0019` contradicted 0.20\n- **源文件冲突 skill_count**：发现多个值 `32, 33`，应在真实使用前核实。\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 体验。 证据：`skills/ab-test-setup/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ai-seo/SKILL.md`, `skills/analytics-tracking/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n### 上下文规模\n\n- 文件总数：312\n- 重要文件覆盖：40/312\n- 证据索引条目：80\n- 角色 / Skill 条目：41\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请基于 marketingskills 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。\n```\n\n### 安装前体验\n\n- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。\n- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。\n\n```text\n请把 marketingskills 当作安装前体验资产，而不是已安装工具或真实运行环境。\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请基于 marketingskills 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。\n```\n\n\n## 角色 / Skill 索引\n\n- 共索引 41 个角色 / Skill / 项目文档条目。\n\n- **ab-test-setup**（skill）：When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions \"A/B test,\" \"split test,\" \"experiment,\" \"test this change,\" \"variant copy,\" \"multivariate test,\" \"hypothesis,\" \"should I test this,\" \"which version is better,\" \"test two versions,\" \"statistical significance,\" \"how long should I run this test,\" \"growth experiments,\" \"… 激活提示：当用户任务与“ab-test-setup”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ab-test-setup/SKILL.md`\n- **ad-creative**（skill）：When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'ad performance optimization,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,'… 激活提示：当用户任务与“ad-creative”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ad-creative/SKILL.md`\n- **ai-seo**（skill）：When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,'… 激活提示：当用户任务与“ai-seo”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ai-seo/SKILL.md`\n- **analytics-tracking**（skill）：When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions \"set up tracking,\" \"GA4,\" \"Google Analytics,\" \"conversion tracking,\" \"event tracking,\" \"UTM parameters,\" \"tag manager,\" \"GTM,\" \"analytics implementation,\" \"tracking plan,\" \"how do I measure this,\" \"track conversions,\" \"attribution,\" \"Mixpanel,\" \"Segment,\" \"are my events firing,\" or \"analytics isn't wo… 激活提示：当用户任务与“analytics-tracking”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/analytics-tracking/SKILL.md`\n- **aso-audit**（skill）：When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store o… 激活提示：当用户任务与“aso-audit”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/aso-audit/SKILL.md`\n- **churn-prevention**（skill）：When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep user… 激活提示：当用户任务与“churn-prevention”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/churn-prevention/SKILL.md`\n- **co-marketing**（skill）：When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says 'co-marketing,' 'partner marketing,' 'joint campaign,' 'who should we partner with,' 'integration marketing,' 'cross-promotion,' 'collaborate with another company,' 'partnership ideas,' or 'co-brand.' For customer referral programs, see referral-program. For launch-specific partner… 激活提示：当用户任务与“co-marketing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/co-marketing/SKILL.md`\n- **cold-email**（skill）：Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions \"cold outreach,\" \"prospecting email,\" \"outbound email,\" \"email to leads,\" \"reach out to prospects,\" \"sales email,\" \"follow-up email sequence,\" \"nobody's replying to my emails,\" or \"how… 激活提示：当用户任务与“cold-email”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/cold-email/SKILL.md`\n- **community-marketing**（skill）：Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \\\"build a community,\\\" \\\"community strategy,\\\" \\\"Discord communi… 激活提示：当用户任务与“community-marketing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/community-marketing/SKILL.md`\n- **competitor-alternatives**（skill）：When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' ' Product vs Product ,' ' Product alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against comp… 激活提示：当用户任务与“competitor-alternatives”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/competitor-alternatives/SKILL.md`\n- **competitor-profiling**（skill）：When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions 'competitor profile,' 'competitor research,' 'competitor analysis,' 'profile this competitor,' 'analyze competitor,' 'competitive intelligence,' 'competitor deep dive,' 'who are my competitors,' 'competitor landscape,' 'competitor dossier,' 'competitive audit,' or 'research these competitors.' Input is a… 激活提示：当用户任务与“competitor-profiling”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/competitor-profiling/SKILL.md`\n- **content-strategy**（skill）：When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions \"content strategy,\" \"what should I write about,\" \"content ideas,\" \"blog strategy,\" \"topic clusters,\" \"content planning,\" \"editorial calendar,\" \"content marketing,\" \"content roadmap,\" \"what content should I create,\" \"blog topics,\" \"content pillars,\" or \"I don't know what t… 激活提示：当用户任务与“content-strategy”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/content-strategy/SKILL.md`\n- **copy-editing**（skill）：When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdat… 激活提示：当用户任务与“copy-editing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/copy-editing/SKILL.md`\n- **copywriting**（skill）：When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says \"write copy for,\" \"improve this copy,\" \"rewrite this page,\" \"marketing copy,\" \"headline help,\" \"CTA copy,\" \"value proposition,\" \"tagline,\" \"subheadline,\" \"hero section copy,\" \"above the fold,\" \"this copy is weak,\" \"… 激活提示：当用户任务与“copywriting”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/copywriting/SKILL.md`\n- **customer-research**（skill）：When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions \"customer research,\" \"ICP research,\" \"talk to customers,\" \"analyze transcripts,\" \"customer interviews,\" \"survey analysis,\" \"support ticket analysis,\" \"voice of customer,\" \"VOC,\" \"build personas,\" \"customer personas,\" \"jobs to be done,\" \"JTBD,\" \"what do customers say,\" \"what are customers struggling with,\" \"Reddit min… 激活提示：当用户任务与“customer-research”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/customer-research/SKILL.md`\n- **directory-submissions**（skill）：When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for backlinks, domain rating, and discovery. Also use when the user mentions \"directory submissions,\" \"submit to directories,\" \"backlinks from directories,\" \"list my product,\" \"submit to Product Hunt,\" \"BetaList,\" \"TAAFT,\" \"Futurepedia,\" \"G2 listing,\" \"Capterra listing,\" \"AlternativeTo,\" \"SaaSHub,\" \"AI direct… 激活提示：当用户任务与“directory-submissions”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/directory-submissions/SKILL.md`\n- **email-sequence**（skill）：When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions \"email sequence,\" \"drip campaign,\" \"nurture sequence,\" \"onboarding emails,\" \"welcome sequence,\" \"re-engagement emails,\" \"email automation,\" \"lifecycle emails,\" \"trigger-based emails,\" \"email funnel,\" \"email workflow,\" \"what emails should I send,\" \"welcome serie… 激活提示：当用户任务与“email-sequence”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/email-sequence/SKILL.md`\n- **form-cro**（skill）：When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions \"form optimization,\" \"lead form conversions,\" \"form friction,\" \"form fields,\" \"form completion rate,\" \"contact form,\" \"nobody fills out our form,\" \"form abandonment,\" \"too many fields,\" \"demo req… 激活提示：当用户任务与“form-cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/form-cro/SKILL.md`\n- **free-tool-strategy**（skill）：When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions \"engineering as marketing,\" \"free tool,\" \"marketing tool,\" \"calculator,\" \"generator,\" \"interactive tool,\" \"lead gen tool,\" \"build a tool for leads,\" \"free resource,\" \"ROI calculator,\" \"grader tool,\" \"audit tool,\" \"should I build a free tool,\" or \"tools f… 激活提示：当用户任务与“free-tool-strategy”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/free-tool-strategy/SKILL.md`\n- **image**（skill）：When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product mockups, profile banners, listing visuals, or brand assets. Also use when the user mentions 'AI image generation,' 'generate an image,' 'create a graphic,' 'product mockup,' 'hero image,' 'social media graphic,' 'banner image,' 'cover photo,' 'profile banner,' 'listing screenshot,' 'Flux,' 'Midjour… 激活提示：当用户任务与“image”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/image/SKILL.md`\n- **launch-strategy**（skill）：When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongo… 激活提示：当用户任务与“launch-strategy”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/launch-strategy/SKILL.md`\n- **lead-magnets**（skill）：When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions \"lead magnet,\" \"gated content,\" \"content upgrade,\" \"downloadable,\" \"ebook,\" \"cheat sheet,\" \"checklist,\" \"template download,\" \"opt-in,\" \"freebie,\" \"PDF download,\" \"resource library,\" \"content offer,\" \"email capture content,\" \"Notion template,\" \"spreadsheet template,\" or \"what should I g… 激活提示：当用户任务与“lead-magnets”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/lead-magnets/SKILL.md`\n- **marketing-ideas**（skill）：When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever s… 激活提示：当用户任务与“marketing-ideas”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/marketing-ideas/SKILL.md`\n- **marketing-psychology**（skill）：When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' 'consumer behavior,' 'anchoring,' 'social proof,' 'scarcity,' 'loss aversion,' 'framing,' or 'nudge.' Use this whenever someone wants to understand or leverage… 激活提示：当用户任务与“marketing-psychology”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/marketing-psychology/SKILL.md`\n- **onboarding-cro**（skill）：When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also use when the user mentions \"onboarding flow,\" \"activation rate,\" \"user activation,\" \"first-run experience,\" \"empty states,\" \"onboarding checklist,\" \"aha moment,\" \"new user experience,\" \"users aren't activating,\" \"nobody completes setup,\" \"low activation rate,\" \"users sign up but don't use the product… 激活提示：当用户任务与“onboarding-cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/onboarding-cro/SKILL.md`\n- **page-cro**（skill）：When the user wants to optimize, improve, or increase conversions on any marketing page — including homepage, landing pages, pricing pages, feature pages, or blog posts. Also use when the user says \"CRO,\" \"conversion rate optimization,\" \"this page isn't converting,\" \"improve conversions,\" \"why isn't this page working,\" \"my landing page sucks,\" \"nobody's converting,\" \"low conversion rate,\" \"bounce rate is too high,\"… 激活提示：当用户任务与“page-cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/page-cro/SKILL.md`\n- **paid-ads**（skill）：When the user wants help with paid advertising campaigns on Google Ads, Meta Facebook/Instagram , LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,' 'LinkedIn ads,' 'ad budget,' 'cost per click,' 'ad spend,' or 'should I run ads.' Use this for campaign strategy, audience targ… 激活提示：当用户任务与“paid-ads”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/paid-ads/SKILL.md`\n- **paywall-upgrade-cro**（skill）：When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions \"paywall,\" \"upgrade screen,\" \"upgrade modal,\" \"upsell,\" \"feature gate,\" \"convert free to paid,\" \"freemium conversion,\" \"trial expiration screen,\" \"limit reached screen,\" \"plan upgrade prompt,\" \"in-app pricing,\" \"free users won't upgrade,\" \"trial to paid conversion,\" or \"how do… 激活提示：当用户任务与“paywall-upgrade-cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/paywall-upgrade-cro/SKILL.md`\n- **popup-cro**（skill）：When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions \"exit intent,\" \"popup conversions,\" \"modal optimization,\" \"lead capture popup,\" \"email popup,\" \"announcement banner,\" \"overlay,\" \"collect emails with a popup,\" \"exit popup,\" \"scroll trigger,\" \"sticky bar,\" or \"notification bar.\" Use this for any overlay or interrupt-style… 激活提示：当用户任务与“popup-cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/popup-cro/SKILL.md`\n- **pricing-strategy**（skill）：When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' or 'should I offer a free plan.' Use… 激活提示：当用户任务与“pricing-strategy”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/pricing-strategy/SKILL.md`\n- **product-marketing-context**（skill）：When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile,' or wants to avoid repeating foundational information across marketing tasks. Use this at the start of any new project before using other marketing… 激活提示：当用户任务与“product-marketing-context”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/product-marketing-context/SKILL.md`\n- **programmatic-seo**（skill）：When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions \"programmatic SEO,\" \"template pages,\" \"pages at scale,\" \"directory pages,\" \"location pages,\" \" keyword + city pages,\" \"comparison pages,\" \"integration pages,\" \"building many pages for SEO,\" \"pSEO,\" \"generate 100 pages,\" \"data-driven pages,\" or \"templated landing pages.\" Use this whenever someone wants to… 激活提示：当用户任务与“programmatic-seo”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/programmatic-seo/SKILL.md`\n- **referral-program**（skill）：When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' or 'affiliate payout.' Use this whenever someone wants existing users or partners t… 激活提示：当用户任务与“referral-program”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/referral-program/SKILL.md`\n- **revops**（skill）：When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should m… 激活提示：当用户任务与“revops”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/revops/SKILL.md`\n- **sales-enablement**（skill）：When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also use when the user mentions 'sales deck,' 'pitch deck,' 'one-pager,' 'leave-behind,' 'objection handling,' 'deal-specific ROI analysis,' 'demo script,' 'talk track,' 'sales playbook,' 'proposal template,' 'buyer persona card,' 'help my sales team,' 'sales materials,' or 'what should I give my sales… 激活提示：当用户任务与“sales-enablement”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/sales-enablement/SKILL.md`\n- **schema-markup**（skill）：When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions \"schema markup,\" \"structured data,\" \"JSON-LD,\" \"rich snippets,\" \"schema.org,\" \"FAQ schema,\" \"product schema,\" \"review schema,\" \"breadcrumb schema,\" \"Google rich results,\" \"knowledge panel,\" \"star ratings in search,\" or \"add structured data.\" Use this whenever someone wants their pages to show… 激活提示：当用户任务与“schema-markup”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/schema-markup/SKILL.md`\n- **seo-audit**（skill）：When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions \"SEO audit,\" \"technical SEO,\" \"why am I not ranking,\" \"SEO issues,\" \"on-page SEO,\" \"meta tags review,\" \"SEO health check,\" \"my traffic dropped,\" \"lost rankings,\" \"not showing up in Google,\" \"site isn't ranking,\" \"Google update hit me,\" \"page speed,\" \"core web vitals,\" \"crawl errors,\" or \"indexing issues.\" Use… 激活提示：当用户任务与“seo-audit”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/seo-audit/SKILL.md`\n- **signup-flow-cro**（skill）：When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the user mentions \"signup conversions,\" \"registration friction,\" \"signup form optimization,\" \"free trial signup,\" \"reduce signup dropoff,\" \"account creation flow,\" \"people aren't signing up,\" \"signup abandonment,\" \"trial conversion rate,\" \"nobody completes registration,\" \"too many steps to sign up,\" or \"s… 激活提示：当用户任务与“signup-flow-cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/signup-flow-cro/SKILL.md`\n- **site-architecture**（skill）：When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions \"sitemap,\" \"site map,\" \"visual sitemap,\" \"site structure,\" \"page hierarchy,\" \"information architecture,\" \"IA,\" \"navigation design,\" \"URL structure,\" \"breadcrumbs,\" \"internal linking strategy,\" \"website planning,\" \"what pages do I need,\" \"how should I organiz… 激活提示：当用户任务与“site-architecture”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/site-architecture/SKILL.md`\n- **social-content**（skill）：When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,'… 激活提示：当用户任务与“social-content”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/social-content/SKILL.md`\n- **video**（skill）：When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Runway,' 'Kling,' 'Pika,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make… 激活提示：当用户任务与“video”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/video/SKILL.md`\n\n## 证据索引\n\n- 共索引 80 条证据。\n\n- **AGENTS.md**（documentation）：Guidelines for AI agents working in this repository. 证据：`AGENTS.md`\n- **Marketing Skills for AI Agents**（documentation）：A collection of AI agent skills focused on marketing tasks. Built for technical marketers and founders who want AI coding agents to help with conversion optimization, copywriting, SEO, analytics, and growth engineering. Works with Claude Code, OpenAI Codex, Cursor, Windsurf, and any agent that supports the Agent Skills spec https://agentskills.io . 证据：`README.md`\n- **Marketing CLIs**（documentation）：Zero-dependency, single-file CLI tools for marketing platforms that don't ship their own. 证据：`tools/clis/README.md`\n- **Composio Quick Start**（documentation）：Get MCP access to 500+ marketing tools through a single integration. 证据：`tools/composio/README.md`\n- **Contributing**（documentation）：Thanks for your interest in contributing to Marketing Skills! This guide will help you add new skills or improve existing ones. 证据：`CONTRIBUTING.md`\n- **A/B Test Setup**（skill_instruction）：You are an expert in experimentation and A/B testing. Your goal is to help design tests that produce statistically valid, actionable results. 证据：`skills/ab-test-setup/SKILL.md`\n- **Ad Creative**（skill_instruction）：You are an expert performance creative strategist. Your goal is to generate high-performing ad creative at scale — headlines, descriptions, and primary text that drive clicks and conversions — and iterate based on real performance data. 证据：`skills/ad-creative/SKILL.md`\n- **AI SEO**（skill_instruction）：You are an expert in AI search optimization — the practice of making content discoverable, extractable, and citable by AI systems including Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini, and Copilot. Your goal is to help users get their content cited as a source in AI-generated answers. 证据：`skills/ai-seo/SKILL.md`\n- **Analytics Tracking**（skill_instruction）：You are an expert in analytics implementation and measurement. Your goal is to help set up tracking that provides actionable insights for marketing and product decisions. 证据：`skills/analytics-tracking/SKILL.md`\n- **ASO Audit**（skill_instruction）：Analyze App Store and Google Play listings against ASO best practices. Fetches live listing data, scores metadata, visuals, and ratings, then produces a prioritized action plan. 证据：`skills/aso-audit/SKILL.md`\n- **Churn Prevention**（skill_instruction）：You are an expert in SaaS retention and churn prevention. Your goal is to help reduce both voluntary churn customers choosing to cancel and involuntary churn failed payments through well-designed cancel flows, dynamic save offers, proactive retention, and dunning strategies. 证据：`skills/churn-prevention/SKILL.md`\n- **Before Starting**（skill_instruction）：You are a co-marketing strategist who helps SaaS companies identify ideal partners and brainstorm high-impact joint campaigns. 证据：`skills/co-marketing/SKILL.md`\n- **Cold Email Writing**（skill_instruction）：You are an expert cold email writer. Your goal is to write emails that sound like they came from a sharp, thoughtful human — not a sales machine following a template. 证据：`skills/cold-email/SKILL.md`\n- **Community Marketing**（skill_instruction）：You are an expert community builder and community-led growth strategist. Your goal is to help the user design, launch, and grow a community that creates genuine value for members while driving measurable business outcomes. 证据：`skills/community-marketing/SKILL.md`\n- **Competitor & Alternative Pages**（skill_instruction）：You are an expert in creating competitor comparison and alternative pages. Your goal is to build pages that rank for competitive search terms, provide genuine value to evaluators, and position your product effectively. 证据：`skills/competitor-alternatives/SKILL.md`\n- **Competitor Profiling**（skill_instruction）：You are an expert competitive intelligence analyst. Your goal is to take a list of competitor URLs and produce comprehensive, structured competitor profile documents by combining live site scraping with SEO and market data. 证据：`skills/competitor-profiling/SKILL.md`\n- **Content Strategy**（skill_instruction）：You are a content strategist. Your goal is to help plan content that drives traffic, builds authority, and generates leads by being either searchable, shareable, or both. 证据：`skills/content-strategy/SKILL.md`\n- **Copy Editing**（skill_instruction）：You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message. 证据：`skills/copy-editing/SKILL.md`\n- **Copywriting**（skill_instruction）：You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action. 证据：`skills/copywriting/SKILL.md`\n- **Customer Research**（skill_instruction）：You are an expert customer researcher. Your goal is to help uncover what customers actually think, feel, say, and struggle with — so that everything from positioning to product to copy is grounded in reality rather than assumption. 证据：`skills/customer-research/SKILL.md`\n- **Directory Submissions**（skill_instruction）：You are an expert in directory-driven distribution for software products. Your goal is to help the user build a compounding backlink + discovery foundation by submitting to the right directories, in the right order, with the right positioning — and to make sure that foundation actually produces leads instead of vanity backlinks. 证据：`skills/directory-submissions/SKILL.md`\n- **Email Sequence Design**（skill_instruction）：You are an expert in email marketing and automation. Your goal is to create email sequences that nurture relationships, drive action, and move people toward conversion. 证据：`skills/email-sequence/SKILL.md`\n- **Form CRO**（skill_instruction）：You are an expert in form optimization. Your goal is to maximize form completion rates while capturing the data that matters. 证据：`skills/form-cro/SKILL.md`\n- **Free Tool Strategy Engineering as Marketing**（skill_instruction）：Free Tool Strategy Engineering as Marketing 证据：`skills/free-tool-strategy/SKILL.md`\n- **Image**（skill_instruction）：You are an expert visual content producer who helps create marketing images using AI generation models, design tools, and optimization best practices. Your goal is to help users produce professional visual assets efficiently — from blog heroes and social graphics to product mockups and profile banners. 证据：`skills/image/SKILL.md`\n- **Launch Strategy**（skill_instruction）：You are an expert in SaaS product launches and feature announcements. Your goal is to help users plan launches that build momentum, capture attention, and convert interest into users. 证据：`skills/launch-strategy/SKILL.md`\n- **Lead Magnets**（skill_instruction）：You are an expert in lead magnet strategy. Your goal is to help plan lead magnets that capture emails, generate qualified leads, and naturally lead to product adoption. 证据：`skills/lead-magnets/SKILL.md`\n- **Marketing Ideas for SaaS**（skill_instruction）：You are a marketing strategist with a library of 139 proven marketing ideas. Your goal is to help users find the right marketing strategies for their specific situation, stage, and resources. 证据：`skills/marketing-ideas/SKILL.md`\n- **Marketing Psychology & Mental Models**（skill_instruction）：Marketing Psychology & Mental Models 证据：`skills/marketing-psychology/SKILL.md`\n- **Onboarding CRO**（skill_instruction）：You are an expert in user onboarding and activation. Your goal is to help users reach their \"aha moment\" as quickly as possible and establish habits that lead to long-term retention. 证据：`skills/onboarding-cro/SKILL.md`\n- **Page Conversion Rate Optimization CRO**（skill_instruction）：Page Conversion Rate Optimization CRO 证据：`skills/page-cro/SKILL.md`\n- **Paid Ads**（skill_instruction）：You are an expert performance marketer with direct access to ad platform accounts. Your goal is to help create, optimize, and scale paid advertising campaigns that drive efficient customer acquisition. 证据：`skills/paid-ads/SKILL.md`\n- **Paywall and Upgrade Screen CRO**（skill_instruction）：You are an expert in in-app paywalls and upgrade flows. Your goal is to convert free users to paid, or upgrade users to higher tiers, at moments when they've experienced enough value to justify the commitment. 证据：`skills/paywall-upgrade-cro/SKILL.md`\n- **Popup CRO**（skill_instruction）：You are an expert in popup and modal optimization. Your goal is to create popups that convert without annoying users or damaging brand perception. 证据：`skills/popup-cro/SKILL.md`\n- **Pricing Strategy**（skill_instruction）：You are an expert in SaaS pricing and monetization strategy. Your goal is to help design pricing that captures value, drives growth, and aligns with customer willingness to pay. 证据：`skills/pricing-strategy/SKILL.md`\n- **Product Marketing Context**（skill_instruction）：You help users create and maintain a product marketing context document. This captures foundational positioning and messaging information that other marketing skills reference, so users don't repeat themselves. 证据：`skills/product-marketing-context/SKILL.md`\n- **Programmatic SEO**（skill_instruction）：You are an expert in programmatic SEO—building SEO-optimized pages at scale using templates and data. Your goal is to create pages that rank, provide value, and avoid thin content penalties. 证据：`skills/programmatic-seo/SKILL.md`\n- **Referral & Affiliate Programs**（skill_instruction）：You are an expert in viral growth and referral marketing. Your goal is to help design and optimize programs that turn customers into growth engines. 证据：`skills/referral-program/SKILL.md`\n- **RevOps**（skill_instruction）：You are an expert in revenue operations. Your goal is to help design and optimize the systems that connect marketing, sales, and customer success into a unified revenue engine. 证据：`skills/revops/SKILL.md`\n- **Sales Enablement**（skill_instruction）：You are an expert in B2B sales enablement. Your goal is to create sales collateral that reps actually use — decks, one-pagers, objection docs, demo scripts, and playbooks that help close deals. 证据：`skills/sales-enablement/SKILL.md`\n- **Schema Markup**（skill_instruction）：You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search. 证据：`skills/schema-markup/SKILL.md`\n- **SEO Audit**（skill_instruction）：You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance. 证据：`skills/seo-audit/SKILL.md`\n- **Signup Flow CRO**（skill_instruction）：You are an expert in optimizing signup and registration flows. Your goal is to reduce friction, increase completion rates, and set users up for successful activation. 证据：`skills/signup-flow-cro/SKILL.md`\n- **Site Architecture**（skill_instruction）：You are an information architecture expert. Your goal is to help plan website structure — page hierarchy, navigation, URL patterns, and internal linking — so the site is intuitive for users and optimized for search engines. 证据：`skills/site-architecture/SKILL.md`\n- **Social Content**（skill_instruction）：You are an expert social media strategist. Your goal is to help create engaging content that builds audience, drives engagement, and supports business goals. 证据：`skills/social-content/SKILL.md`\n- **Video**（skill_instruction）：You are an expert video producer who helps create marketing videos using AI generation models, AI avatars, and programmatic video frameworks. Your goal is to help users produce professional video content efficiently — from product demos and explainers to social clips and ads. 证据：`skills/video/SKILL.md`\n- **Marketplace**（structured_config）：{ \"name\": \"marketingskills\", \"owner\": { \"name\": \"Corey Haines\", \"url\": \"https://corey.co\" }, \"metadata\": { \"description\": \"Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, and growth\", \"version\": \"1.10.0\", \"repository\": \"https://github.com/coreyhaines31/marketingskills\" }, \"plugins\": { \"name\": \"marketing-skills\", \"description\": \"41 marketing skills for technical marketers and founders: ASO, CRO, copywriting, cold email, SEO, AI SEO, paid ads, ad creative, video production, image generation, co-marketing, churn prevention, pricing strategy, referral programs, revenue operations, sales enablement, customer research, site architecture, and more\", \"source\":… 证据：`.claude-plugin/marketplace.json`\n- **Plugin**（structured_config）：{ \"name\": \"marketing-skills\", \"description\": \"Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth\", \"version\": \"1.9.0\", \"author\": { \"name\": \"Corey Haines\" }, \"homepage\": \"https://github.com/coreyhaines31/marketingskills\", \"repository\": \"https://github.com/coreyhaines31/marketingskills\", \"license\": \"MIT\", \"skills\": \"./skills\" } 证据：`.claude-plugin/plugin.json`\n- **License**（source_file）：Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files the \"Software\" , to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 证据：`LICENSE`\n- **Marketing Skills Versions**（documentation）：Current versions of all skills. Agents can compare against local versions to check for updates. 证据：`VERSIONS.md`\n- **Marketing Tools Registry**（documentation）：Quick reference for AI agents to discover tool capabilities and integration methods. 证据：`tools/REGISTRY.md`\n- **Documentation**（documentation）：- Links are valid - Formatting is consistent with existing docs - No sensitive data or credentials 证据：`.github/PULL_REQUEST_TEMPLATE/documentation.md`\n- **New Skill**（skill_instruction）：- name matches directory name exactly - name follows naming rules lowercase, hyphens, no -- - description is 1-1024 chars with trigger phrases - SKILL.md is under 500 lines - No sensitive data or credentials - Tested locally with AI agent 证据：`.github/PULL_REQUEST_TEMPLATE/new-skill.md`\n- **Skill Update**（documentation）：- Bug fix - Improved instructions - Added references/scripts - Other 证据：`.github/PULL_REQUEST_TEMPLATE/skill-update.md`\n- **Sample Size Guide**（documentation）：Reference for calculating sample sizes and test duration. 证据：`skills/ab-test-setup/references/sample-size-guide.md`\n- **Generative AI Tools for Ad Creative**（documentation）：Generative AI Tools for Ad Creative 证据：`skills/ad-creative/references/generative-tools.md`\n- **Platform Specs Reference**（documentation）：Complete character limits, format requirements, and best practices for each ad platform. 证据：`skills/ad-creative/references/platform-specs.md`\n- **AEO and GEO Content Patterns**（documentation）：Reusable content block patterns optimized for answer engines and AI citation. 证据：`skills/ai-seo/references/content-patterns.md`\n- **How Each AI Platform Picks Sources**（documentation）：Each AI search platform has its own search index, ranking logic, and content preferences. This guide covers what matters for getting cited on each one. 证据：`skills/ai-seo/references/platform-ranking-factors.md`\n- **Event Library Reference**（documentation）：Comprehensive list of events to track by business type and context. 证据：`skills/analytics-tracking/references/event-library.md`\n- 其余 20 条证据见 `AI_CONTEXT_PACK.json` 或 `EVIDENCE_INDEX.json`。\n\n## 宿主 AI 必须遵守的规则\n\n- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`AGENTS.md`, `README.md`, `tools/clis/README.md`\n- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`AGENTS.md`, `README.md`, `tools/clis/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, AGENTS.md, CLAUDE.md\n- **快速开始**：importance `high`\n - source_paths: README.md, skills/product-marketing-context/SKILL.md\n- **安装指南**：importance `high`\n - source_paths: README.md, .claude-plugin/marketplace.json, .claude-plugin/plugin.json\n- **技能系统概览**：importance `high`\n - source_paths: README.md, AGENTS.md\n- **技能分类总览**：importance `high`\n - source_paths: README.md, VERSIONS.md\n- **转化率优化技能组**：importance `high`\n - source_paths: skills/page-cro/SKILL.md, skills/signup-flow-cro/SKILL.md, skills/onboarding-cro/SKILL.md, skills/form-cro/SKILL.md, skills/popup-cro/SKILL.md\n- **内容与文案技能组**：importance `high`\n - source_paths: skills/copywriting/SKILL.md, skills/cold-email/SKILL.md, skills/email-sequence/SKILL.md, skills/social-content/SKILL.md, skills/image/SKILL.md\n- **SEO与发现技能组**：importance `medium`\n - source_paths: skills/seo-audit/SKILL.md, skills/ai-seo/SKILL.md, skills/programmatic-seo/SKILL.md, skills/site-architecture/SKILL.md, skills/competitor-alternatives/SKILL.md\n\n## Repo Inspection Evidence / 源码检查证据\n\n- repo_clone_verified: true\n- repo_inspection_verified: true\n- repo_commit: `906c2fb28e471c5b1d149d4159ec5ddb40b7c364`\n- inspected_files: `README.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: 仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- Host AI rule: 在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- Why it matters: 用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- Evidence: identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 2: 来源证据：Add OpenAI Codex plugin support\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 3: 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 4: 来源证据：Feature Request: Add Prefix to skills\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 5: 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能影响升级、迁移或版本选择。\n- Evidence: community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 6: 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 7: 可能修改宿主 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:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 8: 能力判断依赖假设\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:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\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:1135212071 | https://github.com/coreyhaines31/marketingskills | 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:1135212071 | https://github.com/coreyhaines31/marketingskills | 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项目：coreyhaines31/marketingskills\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- 来源证据：Add OpenAI Codex plugin support（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 来源证据：Feature Request: Add Prefix to skills（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand（medium）：可能影响升级、迁移或版本选择。 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\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/coreyhaines31/marketingskills 项目说明书\n\n生成时间：2026-05-11 17:55:30 UTC\n\n## 目录\n\n- [项目概述](#project-overview)\n- [快速开始](#quick-start)\n- [安装指南](#installation-guide)\n- [技能系统概览](#skills-overview)\n- [技能分类总览](#skill-categories)\n- [转化率优化技能组](#cro-skills)\n- [内容与文案技能组](#content-skills)\n- [SEO与发现技能组](#seo-skills)\n- [增长与收入技能组](#growth-skills)\n- [CLI工具集](#cli-tools)\n\n\n\n## 项目概述\n\n### 相关页面\n\n相关主题：[快速开始](#quick-start), [技能系统概览](#skills-overview), [安装指南](#installation-guide)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/schema-markup/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/references/schema-examples.md)\n
\n\n# 项目概述\n\n## 项目简介\n\nMarketing Skills 是一个面向 AI 代理（Agent）的营销技能集合库，旨在为自动化营销任务提供标准化的技能定义和操作指南。该项目通过结构化的技能模块，帮助 AI 代理执行各类营销工作，包括内容策略、SEO 优化、付费广告、网站架构设计等。\n\n资料来源：[CONTRIBUTING.md:1-5]()\n\n## 核心设计理念\n\n### 技能模块化\n\n项目采用模块化设计，每个营销技能独立存放在 `skills/` 目录下的子目录中。每个技能包含完整的指令、参考资料、脚本和资源文件，可被不同的 AI 代理平台调用。\n\n### 跨代理兼容性\n\n技能设计遵循跨平台兼容原则，确保同一套技能可以在多种 AI 代理环境中运行，包括 Codex、Cursor、Windsurf 等主流平台。\n\n资料来源：[CLAUDE.md:1-5]()\n\n## 项目架构\n\n### 整体架构图\n\n```mermaid\ngraph TD\n subgraph \"项目根目录\"\n CLAUDE[\"CLAUDE.md\"]\n AGENTS[\"AGENTS.md\"]\n CONTRIBUTING[\"CONTRIBUTING.md\"]\n end\n \n subgraph \"skills/ 技能目录\"\n SKILL1[\"content-strategy/\"]\n SKILL2[\"paid-ads/\"]\n SKILL3[\"site-architecture/\"]\n SKILL4[\"schema-markup/\"]\n SKILL5[\"image/\"]\n end\n \n subgraph \"tools/ 工具集成\"\n CLI[\"clis/\"]\n INTEGRATIONS[\"integrations/\"]\n end\n \n CLAUDE --> SKILL1\n CLAUDE --> SKILL2\n AGENTS --> SKILL1\n CONTRIBUTING --> SKILL1\n \n SKILL1 --> REF1[\"references/\"]\n SKILL2 --> REF2[\"references/\"]\n SKILL3 --> REF3[\"references/\"]\n```\n\n### 目录结构规范\n\n```\nmarketingskills/\n├── skills/ # 技能模块目录\n│ ├── [skill-name]/ # 单个技能目录\n│ │ ├── SKILL.md # 必需 - 主指令文件\n│ │ ├── references/ # 可选 - 附加文档\n│ │ │ └── guide.md\n│ │ ├── scripts/ # 可选 - 可执行代码\n│ │ │ └── helper.py\n│ │ └── assets/ # 可选 - 模板、图片、数据\n│ │ └── template.json\n├── tools/ # 工具集成\n│ ├── clis/ # CLI 工具\n│ │ └── optimizely.js\n│ └── integrations/ # 第三方集成\n│ ├── postmark.md\n│ ├── sanity.md\n│ ├── wordpress.md\n│ └── ahrefs.md\n├── CLAUDE.md # Claude Code 配置\n├── AGENTS.md # 代理配置说明\n└── CONTRIBUTING.md # 贡献指南\n```\n\n资料来源：[CONTRIBUTING.md:25-40]()\n\n## 技能系统详解\n\n### SKILL.md 文件规范\n\n每个技能的核心是 `SKILL.md` 文件，必须包含 YAML frontmatter 元数据：\n\n```yaml\n---\nname: your-skill-name\ndescription: 技能使用场景描述，包含触发短语和关键词，帮助代理识别相关任务\n---\n```\n\n**可选字段：**\n\n| 字段 | 说明 | 默认值 |\n|------|------|--------|\n| `license` | 许可证类型 | MIT |\n| `metadata` | 元数据（作者、版本等） | 无 |\n\n**命名规范：**\n\n- 目录名：小写，仅使用连字符（例：`email-sequence`）\n- name 字段：必须与目录名完全一致\n- description：1-1024 字符，包含触发短语\n\n资料来源：[CONTRIBUTING.md:10-25]()\n\n### 技能文件结构\n\n```mermaid\ngraph LR\n A[\"SKILL.md
必需\"] --> B[\"references/
可选\"]\n A --> C[\"scripts/
可选\"]\n A --> D[\"assets/
可选\"]\n \n B --> B1[\"guide.md\"]\n B --> B2[\"mermaid-templates.md\"]\n C --> C1[\"helper.py\"]\n C --> C2[\"optimizely.js\"]\n D --> D1[\"template.json\"]\n D --> D2[\"schema-examples.md\"]\n```\n\n## 代理集成机制\n\n### 动态内容注入\n\nClaude Code 支持在 SKILL.md 中嵌入 shell 命令，使用 `` !`command` `` 语法。当技能被调用时，系统执行命令并将结果内联注入。\n\n**常用应用场景：**\n\n```markdown\n# 自动注入产品营销上下文文件\nProduct context: !`cat .agents/product-marketing-context.md 2>/dev/null || echo \"No product context file found\"`\n\n# 注入当前日期\nToday's date: !`date +%Y-%m-%d`\n\n# 注入当前 git 分支\nCurrent branch: !`git branch --show-current 2>/dev/null`\n```\n\n### 产品上下文自动加载\n\n在技能文件顶部放置以下内容，使上下文在技能执行时自动可用：\n\n```markdown\nProduct context: !`cat .agents/product-marketing-context.md 2>/dev/null || echo \"No product context file found — ask the user about their product before proceeding.\"`\n```\n\n资料来源：[CLAUDE.md:10-35]()\n\n### 代理兼容性说明\n\n| 代理平台 | 支持状态 | 特殊说明 |\n|---------|---------|---------|\n| Claude Code | 完全支持 | 支持 `!`command`` 动态注入 |\n| Codex | 基础支持 | 仅读取标准 SKILL.md |\n| Cursor | 基础支持 | 仅读取标准 SKILL.md |\n| Windsurf | 基础支持 | 仅读取标准 SKILL.md |\n\n**重要限制：** 动态内容注入功能仅限于 Claude Code。其他代理会看到字面量的 `` !`command` `` 字符串而非执行结果。\n\n资料来源：[CLAUDE.md:35-45]()\n\n## 工具集成\n\n### CLI 工具\n\n项目在 `tools/clis/` 目录下提供了多种 CLI 工具脚本：\n\n| 工具 | 文件 | 功能 |\n|------|------|------|\n| Optimizely | `optimizely.js` | 项目和页面管理 |\n| Livestorm | `livestorm.js` | 活动、会话、人员管理 |\n\n### 第三方集成\n\n`tools/integrations/` 目录包含与主流营销工具的集成文档：\n\n| 集成服务 | 文件 | API 端点示例 |\n|---------|------|-------------|\n| Postmark | `postmark.md` | `/templates`, `/messages/outbound` |\n| Sanity | `sanity.md` | `/export`, `/dataset` |\n| WordPress | `wordpress.md` | `/wp-json/wp/v2/posts` |\n| Ahrefs | `ahrefs.md` | `/v3/site-explorer/` |\n| Hyperframes | `hyperframes.md` | 视频帧生成 |\n\n资料来源：[tools/integrations/postmark.md:1-30]()\n资料来源：[tools/integrations/sanity.md:1-25]()\n\n## 技能模块概览\n\n### 内容策略技能\n\n**目录：** `skills/content-strategy/`\n\n包含内容规划、编辑工作流、SEO 字段规范等参考资料。\n\n### 付费广告技能\n\n**目录：** `skills/paid-ads/`\n\n涵盖转化追踪、广告平台集成等。\n\n### 网站架构技能\n\n**目录：** `skills/site-architecture/`\n\n提供导航模式、面包屑规范、移动端导航等设计模板，包含 Mermaid 图表模板。\n\n### Schema 标记技能\n\n**目录：** `skills/schema-markup/`\n\n提供 JSON-LD 结构化数据示例，覆盖 Article、Product、WebSite 等类型。\n\n### 图片技能\n\n**目录：** `skills/image/`\n\n包含 AI 图片生成提示词指南，支持多种用例场景。\n\n## 贡献指南\n\n### 添加新技能流程\n\n```mermaid\ngraph TD\n A[\"创建技能目录
mkdir skills/your-skill-name\"] --> B[\"创建 SKILL.md 文件\"]\n B --> C[\"添加 YAML frontmatter\"]\n C --> D[\"编写技能指令\"]\n D --> E[\"添加可选资源
references/scripts/assets\"]\n E --> F[\"遵循命名规范\"]\n F --> G[\"提交 Pull Request\"]\n```\n\n### 技能请求\n\n用户可通过 [GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 提交新技能请求。\n\n资料来源：[CONTRIBUTING.md:5-10]()\n\n## 工作原理\n\n```mermaid\nsequenceDiagram\n participant User as 用户\n participant Agent as AI 代理\n participant Skill as SKILL.md\n participant Ref as References\n participant Tool as Tools\n\n User->>Agent: 调用技能\n Agent->>Skill: 读取技能指令\n Skill-->>Agent: 返回指令内容\n Agent->>Ref: 访问参考资料（如需要）\n Ref-->>Agent: 返回文档内容\n Agent->>Tool: 执行脚本或集成\n Tool-->>Agent: 返回结果\n Agent-->>User: 完成营销任务\n```\n\n## 关键特性总结\n\n| 特性 | 说明 |\n|------|------|\n| 模块化设计 | 每个技能独立，可单独使用 |\n| 跨平台兼容 | 支持多种 AI 代理环境 |\n| 丰富的参考资料 | 内置模板、图表、示例代码 |\n| 工具集成 | 预置主流营销工具集成文档 |\n| 动态内容 | 支持 shell 命令注入 |\n| 标准化格式 | 统一的 SKILL.md 规范 |\n\n---\n\n**维护者：** Corey Haines\n\n**许可证：** MIT\n\n---\n\n\n\n## 快速开始\n\n### 相关页面\n\n相关主题：[项目概述](#project-overview), [安装指南](#installation-guide), [技能系统概览](#skills-overview)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/product-marketing-context/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/product-marketing-context/SKILL.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/image/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/image/SKILL.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n
\n\n# 快速开始\n\n本页面为用户提供如何在 marketingskills 项目中快速上手的完整指南，包括项目安装、技能添加和工作流程。\n\n## 项目概述\n\nMarketing Skills 是一个 AI 代理营销技能集合，为 AI 代理提供专业的营销知识和 workflows。当用户将这些技能添加到项目中时，代理能够识别营销任务并应用正确的框架和最佳实践。\n\n## 核心概念\n\n### 什么是技能（Skills）\n\n技能是 Markdown 文件，为 AI 代理提供特定任务的专门知识和 workflows。每个技能包含：\n- 触发短语和关键词\n- 详细的使用说明\n- 可选的参考资料、脚本和模板\n\n### 技能层级结构\n\n```mermaid\ngraph TD\n PMC[\"product-marketing-context
(产品营销上下文)\"]\n \n SEO[\"SEO 与内容\"]\n CRO[\"转化率优化\"]\n CONTENT[\"内容与文案\"]\n PAID[\"付费与分发\"]\n GROWTH[\"增长与留存\"]\n SALES[\"销售与GTM\"]\n STRATEGY[\"策略\"]\n \n PMC --> SEO\n PMC --> CRO\n PMC --> CONTENT\n PMC --> PAID\n PMC --> GROWTH\n PMC --> SALES\n PMC --> STRATEGY\n \n style PMC fill:#f9f,stroke:#333,stroke-width:2px\n```\n\n`product-marketing-context` 技能是整个系统的基础，所有其他技能在执行任务前都会先读取它以了解产品、受众和定位。\n\n## 添加新技能\n\n### 目录结构\n\n每个技能需要遵循标准的目录结构：\n\n```\nskills/your-skill-name/\n├── SKILL.md # 必需 - 主指令文件\n├── references/ # 可选 - 附加文档\n│ └── guide.md\n├── scripts/ # 可选 - 可执行代码\n│ └── helper.py\n└── assets/ # 可选 - 模板、图片、数据\n └── template.json\n```\n\n### 创建 SKILL.md 文件\n\n每个技能必须有包含 YAML 前置数据的 `SKILL.md` 文件：\n\n```yaml\n---\nname: your-skill-name\ndescription: 何时使用此技能。包含帮助代理识别相关任务的触发短语和关键词。\n---\n\n# 你的技能名称\n\n代理指令在此处...\n```\n\n前置数据字段说明：\n\n| 字段 | 必填 | 说明 | 默认值 |\n|------|:----:|------|:------:|\n| name | 是 | 技能名称，必须与目录名完全匹配 | - |\n| description | 是 | 描述，包含触发短语 | - |\n| license | 否 | 许可证类型 | MIT |\n| metadata | 否 | 元数据（作者、版本等） | - |\n\n### 命名规范\n\n- **目录名**：小写，仅使用连字符（如 `email-sequence`）\n- **Name 字段**：必须与目录名完全一致\n- **Description**：1-1024 字符，包含触发短语\n\n## 技能工作流程\n\n### 代理识别流程\n\n```mermaid\ngraph TD\n A[\"用户请求\"] --> B[\"代理分析请求\"]\n B --> C{\"匹配触发短语?\"}\n C -->|是| D[\"加载对应技能\"]\n C -->|否| E[\"使用通用知识\"]\n D --> F[\"读取 product-marketing-context\"]\n F --> G[\"执行技能指令\"]\n G --> H[\"应用最佳实践\"]\n \n style D fill:#90EE90\n style F fill:#FFD700\n```\n\n### 技能间的协作\n\n技能相互引用并建立在共享上下文之上。当代理执行任务时：\n\n1. **初始化**：代理识别相关技能\n2. **上下文加载**：读取 `product-marketing-context` 获取项目背景\n3. **技能执行**：按照技能指令执行具体任务\n4. **参考资料**：如有需要，引用 `references/` 目录中的附加文档\n\n## 可用技能分类\n\n### 获客与增长\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `seo-content` | SEO 与内容策略 | 博客文章、落地页 |\n| `programmatic-seo` | 规模化页面生成 | 大量长尾页面 |\n| `site-architecture` | 页面层级与导航 | 网站结构优化 |\n| `schema-markup` | 结构化数据 | 搜索引擎优化 |\n\n### 付费与分发\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `paid-ads` | Google、Meta、LinkedIn 广告 | 付费推广活动 |\n| `ad-creative` | 广告创意生成 | 批量广告制作 |\n| `social-content` | 社交媒体策略 | 内容排期管理 |\n\n### 测量与测试\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `analytics-tracking` | 事件追踪设置 | 数据收集配置 |\n| `ab-test-setup` | 实验设计 | A/B 测试规划 |\n\n### 留存与增长工程\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `churn-prevention` | 流失预防 | 取消流程、拯救优惠 |\n| `co-marketing` | 联合营销 | 合作伙伴识别 |\n| `free-tool-strategy` | 免费工具策略 | 营销工具与计算器 |\n| `referral-program` | 推荐与联盟 | 裂变营销 |\n\n### 策略与变现\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `marketing-ideas` | 140+ SaaS 营销创意 | 营销灵感 |\n| `marketing-psychology` | 心理模型 | 用户行为洞察 |\n| `launch-strategy` | 产品发布 | 新功能推广 |\n| `pricing-strategy` | 定价策略 | 套餐设计 |\n\n### 销售与运营\n\n| 技能目录 | 说明 | 适用场景 |\n|----------|------|----------|\n| `revops` | 生命周期与评分 | 线索路由 |\n| `sales-enablement` | 销售赋能 | 演示脚本、异议处理 |\n\n## 典型使用流程\n\n### 创建竞品分析\n\n以 `competitor-profiling` 技能为例，展示典型工作流程：\n\n```mermaid\ngraph TD\n A[\"确定竞品 URL\"] --> B[\"Firecrawl Map 站点映射\"]\n B --> C[\"识别关键页面\"]\n C --> D[\"Firecrawl Scrape 抓取页面\"]\n D --> E[\"保存原始数据\"]\n E --> F[\"提取定位和定价\"]\n F --> G[\"生成竞品报告\"]\n \n style B fill:#87CEEB\n style D fill:#87CEEB\n```\n\n具体步骤：\n\n1. **映射站点**：`firecrawl_map` 发现竞品站点结构\n2. **识别页面类型**：首页、定价、功能、关于、博客\n3. **抓取关键页**：`firecrawl_scrape` 逐页抓取\n4. **保存数据**：`competitor-profiles/raw/<竞品 slug>/<日期>/scrapes/`\n5. **合成报告**：生成 `<竞品 slug>.md` 文件\n\n### 事件追踪配置\n\n使用 `analytics-tracking` 技能配置追踪：\n\n#### 核心事件结构\n\n```javascript\n{\n event: \"event_name\",\n properties: {\n // 必需\n plan: \"starter\" | \"pro\" | \"enterprise\",\n // 可选\n product_id: \"SKU123\",\n category: \"Category\",\n price: 99.99\n }\n}\n```\n\n#### 典型漏斗事件序列\n\n| 漏斗类型 | 事件序列 |\n|----------|----------|\n| 注册漏斗 | signup_started → signup_step_completed → signup_completed → onboarding_started |\n| 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed |\n| 电商漏斗 | product_viewed → product_added_to_cart → cart_viewed → checkout_started → purchase_completed |\n\n## 贡献指南\n\n### 建议新技能\n\n通过 [打开技能请求 issue](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 建议新技能。\n\n### 提交 PR\n\n1. Fork 仓库\n2. 创建技能目录和文件\n3. 遵循命名规范和目录结构\n4. 编写清晰的 SKILL.md 说明\n5. 提交 Pull Request\n\n详细贡献规范请参阅 [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)。\n\n## 快速操作清单\n\n- [ ] Fork 并克隆仓库\n- [ ] 阅读 `product-marketing-context/SKILL.md` 了解上下文机制\n- [ ] 创建一个示例技能目录\n- [ ] 编写 SKILL.md 文件，包含 YAML 前置数据\n- [ ] 添加 references/ 目录和示例文档\n- [ ] 提交 PR 并等待审核\n\n## 后续步骤\n\n完成快速开始后，建议深入了解：\n\n1. **[产品营销上下文](skills/product-marketing-context/SKILL.md)** - 所有技能的基础\n2. **[贡献指南](CONTRIBUTING.md)** - 完整的贡献规范\n3. **[竞品分析技能](skills/competitor-profiling/SKILL.md)** - 学习技能如何协同工作\n4. **[分析追踪](skills/analytics-tracking/references/event-library.md)** - 事件追踪最佳实践\n\n---\n\n\n\n## 安装指南\n\n### 相关页面\n\n相关主题：[快速开始](#quick-start), [项目概述](#project-overview)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)\n- [tools/integrations/wordpress.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/wordpress.md)\n- [tools/integrations/hubspot.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hubspot.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [.claude-plugin/plugin.json](https://github.com/coreyhaines31/marketingskills/blob/main/.claude-plugin/plugin.json)\n
\n\n# 安装指南\n\n本指南旨在帮助开发者和技术团队快速上手并正确配置 marketingskills 项目。marketingskills 是一个营销技能集合仓库，提供了涵盖内容策略、SEO优化、付费广告、社交媒体、分析追踪、A/B测试等营销全链路所需的技能、模板和参考文档。\n\n## 环境要求\n\n### 硬件与操作系统要求\n\n| 组件 | 最低要求 | 推荐配置 |\n|------|---------|---------|\n| 处理器 | 双核 1.5 GHz | 四核 2.5 GHz 或更高 |\n| 内存 | 4 GB RAM | 8 GB RAM |\n| 磁盘空间 | 500 MB | 1 GB 以上 |\n| 操作系统 | macOS 10.14+ / Ubuntu 18.04+ / Windows 10 | macOS 12+ / Ubuntu 20.04+ |\n\n### 软件依赖\n\n- **Node.js**: 版本 18.0.0 或更高\n- **npm**: 版本 8.0.0 或更高（随 Node.js 一起安装）\n- **Git**: 版本 2.30.0 或更高\n\n## 快速安装\n\n### 步骤一：克隆仓库\n\n打开终端并执行以下命令：\n\n```bash\ngit clone https://github.com/coreyhaines31/marketingskills.git\ncd marketingskills\n```\n\n### 步骤二：安装依赖\n\n项目使用 npm 管理依赖，执行安装命令：\n\n```bash\nnpm install\n```\n\n此命令将读取 `package.json` 并安装所有必要的依赖包。\n\n### 步骤三：验证安装\n\n运行以下命令验证环境配置正确：\n\n```bash\nnpm --version\nnode --version\n```\n\n确保 Node.js 版本符合要求。\n\n## 项目结构概览\n\n```\nmarketingskills/\n├── skills/ # 营销技能集合\n│ ├── content-strategy/ # 内容策略相关技能\n│ ├── seo/ # SEO优化技能\n│ ├── paid-ads/ # 付费广告技能\n│ ├── social-content/ # 社交媒体内容技能\n│ ├── analytics-tracking/ # 分析追踪技能\n│ ├── ab-test-setup/ # A/B测试设置技能\n│ ├── churn-prevention/ # 客户流失预防技能\n│ ├── marketing-ideas/ # 营销创意技能\n│ └── sales-enablement/ # 销售赋能技能\n├── tools/ # 工具集\n│ ├── clis/ # 命令行工具\n│ │ ├── optimizely.js # Optimizely CLI\n│ │ ├── livestorm.js # Livestorm CLI\n│ │ ├── wistia.js # Wistia CLI\n│ │ └── intercom.js # Intercom CLI\n│ └── integrations/ # 第三方集成文档\n│ ├── sanity.md # Sanity CMS 集成\n│ ├── wordpress.md # WordPress 集成\n│ ├── hubspot.md # HubSpot 集成\n│ ├── postmark.md # Postmark 邮件服务\n│ └── hyperframes.md # Hyperframes 视频工具\n├── .claude-plugin/ # Claude 插件配置\n│ ├── plugin.json # 插件元数据\n│ └── marketplace.json # 市场列表配置\n├── README.md # 项目主文档\n├── CONTRIBUTING.md # 贡献指南\n└── LICENSE # MIT 许可证\n```\n\n## 技能模块详解\n\n### 内容策略模块\n\n内容策略模块位于 `skills/content-strategy/` 目录下，包含以下核心技能：\n\n| 技能名称 | 功能描述 |\n|---------|---------|\n| headless-cms | 无头 CMS 集成与工作流 |\n| editorial-workflows | 编辑工作流程管理 |\n| content-calendar | 内容日历规划 |\n\n**配置 headless-cms 集成：**\n\n参考 `skills/content-strategy/references/headless-cms.md` 中的配置指南，定义内容模型包括：\n\n```json\n{\n \"contentType\": \"blogPost\",\n \"fields\": {\n \"title\": \"string (required)\",\n \"slug\": \"slug (required)\",\n \"body\": \"richText\",\n \"publishDate\": \"datetime\",\n \"author\": \"reference (author)\",\n \"category\": \"reference (category)\"\n }\n}\n```\n\n### 站点架构模块\n\n站点架构技能位于 `skills/site-architecture/`，提供页面层级、导航模式和 URL 结构的设计参考：\n\n- **页面层级设计**：定义页面优先级和导航位置\n- **导航模式**：包括顶部导航、页脚导航、面包屑导航\n- **URL 结构**：标准化 URL 命名约定\n\n详细模板参考 `skills/site-architecture/references/site-type-templates.md`。\n\n### SEO 模块\n\nSEO 技能目录包含：\n\n| 模块 | 功能 |\n|-----|------|\n| gsc-api | Google Search Console API 集成 |\n| programmatic-seo | 大规模页面生成 |\n| schema-markup | 结构化数据标记 |\n\nSchema markup 参考 `skills/schema-markup/references/schema-examples.md`，支持以下类型：\n\n- Organization\n- WebSite\n- Article/BlogPosting\n- Product\n\n### 付费广告模块\n\n位于 `skills/paid-ads/` 和 `skills/ad-creative/`，支持以下平台：\n\n- **Google Ads**：搜索广告、展示广告\n- **Meta Ads**：Facebook/Instagram 广告\n- **LinkedIn Ads**：B2B 广告投放\n\n## CLI 工具安装\n\n### Optimizely CLI\n\n参考 `tools/clis/optimizely.js`：\n\n```bash\n# 安装（如果需要全局安装）\nnpm install -g optimizely-cli\n\n# 基本用法\nnode tools/clis/optimizely.js events list --project-id <项目ID>\nnode tools/clis/optimizely.js pages list --project-id <项目ID>\n```\n\n### Livestorm CLI\n\n参考 `tools/clis/livestorm.js`：\n\n```bash\n# 活动管理\nnode tools/clis/livestorm.js events list\nnode tools/clis/livestorm.js sessions list --event-id <活动ID>\n\n# 与会人员管理\nnode tools/clis/livestorm.js people list --email <邮箱>\n```\n\n### Wistia CLI\n\n参考 `tools/clis/wistia.js`：\n\n```bash\n# 媒体管理\nnode tools/clis/wistia.js media list\nnode tools/clis/wistia.js media stats --id <媒体ID>\n\n# 观众分析\nnode tools/clis/wistia.js stats visitors\nnode tools/clis/wistia.js stats engagement --id <媒体ID>\n```\n\n### Intercom CLI\n\n参考 `tools/clis/intercom.js`：\n\n```bash\n# 用户管理\nnode tools/clis/intercom.js users list\nnode tools/clis/intercom.js users get --id <用户ID>\n\n# 工单管理\nnode tools/clis/intercom.js tickets list\nnode tools/clis/intercom.js conversations list --user-id <用户ID>\n```\n\n## 第三方服务集成\n\n### Sanity CMS\n\n详细配置参考 `tools/integrations/sanity.md`。\n\n```bash\n# 初始化 Sanity 项目\nsanity init\n\n# 本地开发\nsanity dev\n\n# 部署 Studio\nsanity deploy\n\n# 导出数据集\nsanity dataset export production ./backup.tar.gz\n```\n\n**GROQ 查询示例：**\n\n```javascript\n// 获取最近10篇文章\nconst query = '*[_type == \"post\"][0..9]{title, slug}';\n\n// 获取特定文章\nconst singlePost = '*[_type == \"post\" && slug.current == $slug][0]';\n```\n\n### WordPress REST API\n\n参考 `tools/integrations/wordpress.md`。\n\n```bash\n# 获取文章列表\ncurl -X GET \"https://example.com/wp-json/wp/v2/posts?per_page=20\" \\\n -H \"Authorization: Basic {base64(username:app_password)}\"\n\n# 创建文章\ncurl -X POST \"https://example.com/wp-json/wp/v2/posts\" \\\n -H \"Authorization: Basic {base64(username:app_password)}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"title\": \"标题\", \"content\": \"内容\", \"status\": \"publish\"}'\n```\n\n**WP-CLI 命令：**\n\n```bash\n# 列出文章\nwp post list --post_type=post --post_status=publish\n\n# 创建文章\nwp post create --post_title=\"标题\" --post_content=\"内容\" --post_status=publish\n\n# 数据库操作\nwp db export backup.sql\nwp search-replace 'old-domain.com' 'new-domain.com'\n```\n\n### HubSpot\n\n参考 `tools/integrations/hubspot.md`。\n\n```bash\n# HubSpot CLI 安装\nnpm install -g @hubspot/cli\n\n# 初始化项目\nhs init\n\n# 上传文件\nhs upload src dest\n\n# 监听变化\nhs watch src dest\n```\n\n**关键对象：**\n\n| 对象类型 | 说明 |\n|---------|------|\n| Contacts | CRM 中的联系人 |\n| Companies | 公司组织 |\n| Deals | 销售机会 |\n| Tickets | 支持工单 |\n| Products | 销售产品 |\n| Line Items | 交易行项目 |\n\n### Postmark 邮件服务\n\n参考 `tools/integrations/postmark.md`。\n\n```bash\n# 创建模板\ncurl -X POST https://api.postmarkapp.com/templates \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Postmark-Account-Token: {account_token}\" \\\n -d '{\n \"Name\": \"Welcome Email\",\n \"Alias\": \"welcome\",\n \"Subject\": \"Welcome {{name}}!\",\n \"HtmlBody\": \"

Hello {{name}}

\"\n }'\n```\n\n**统计分析接口：**\n\n```bash\n# 投递统计\nGET https://api.postmarkapp.com/deliverystats\n\n# 跳出率查询\nGET https://api.postmarkapp.com/bounces?count=50&offset=0&type=HardBounce\n\n# 打开统计\nGET https://api.postmarkapp.com/stats/outbound/opens\n```\n\n### Hyperframes 视频工具\n\n参考 `tools/integrations/hyperframes.md`。\n\n```javascript\n// 创建视频场景\nconst hyperframes = require('hyperframes');\n\nconst video = await hyperframes.createVideo({\n frames: [\n {\n html: `\n
\n

Welcome to Acme

\n
\n `,\n duration: 3,\n },\n {\n html: `\n
\n

Ship faster with AI

\n
\n `,\n duration: 3,\n },\n ],\n output: \"intro.mp4\",\n width: 1080,\n height: 1920,\n fps: 30,\n});\n```\n\n## Claude 插件配置\n\n项目包含 Claude 插件配置，位于 `.claude-plugin/` 目录。\n\n### plugin.json 结构\n\n```json\n{\n \"name\": \"marketingskills\",\n \"description\": \"营销技能集合：内容策略、SEO、付费广告、社交媒体、分析追踪等\",\n \"version\": \"1.0.0\",\n \"skills\": [\n \"content-strategy\",\n \"seo\",\n \"paid-ads\",\n \"social-content\",\n \"analytics-tracking\"\n ],\n \"tools\": {\n \"clis\": [\n \"optimizely\",\n \"livestorm\",\n \"wistia\",\n \"intercom\"\n ],\n \"integrations\": [\n \"sanity\",\n \"wordpress\",\n \"hubspot\",\n \"postmark\"\n ]\n }\n}\n```\n\n## 环境变量配置\n\n### 必需的环境变量\n\n创建 `.env` 文件并配置以下变量：\n\n```bash\n# Sanity\nSANITY_PROJECT_ID=your_project_id\nSANITY_DATASET=production\nSANITY_TOKEN=your_token\n\n# WordPress\nWP_API_URL=https://your-site.com/wp-json/wp/v2\nWP_USERNAME=your_username\nWP_APP_PASSWORD=your_app_password\n\n# HubSpot\nHUBSPOT_ACCESS_TOKEN=your_access_token\n\n# Postmark\nPOSTMARK_ACCOUNT_TOKEN=your_account_token\nPOSTMARK_SERVER_TOKEN=your_server_token\n\n# Optimizely\nOPTIMIZELY_API_TOKEN=your_api_token\n\n# Livestorm\nLIVESTORM_API_KEY=your_api_key\n\n# Wistia\nWISTIA_API_TOKEN=your_api_token\n\n# Intercom\nINTERCOM_ACCESS_TOKEN=your_access_token\n```\n\n## 常见问题排查\n\n### npm install 失败\n\n```bash\n# 清除缓存后重试\nnpm cache clean --force\nrm -rf node_modules\nnpm install\n```\n\n### CLI 工具无法执行\n\n确保 Node.js 版本正确，并检查文件执行权限：\n\n```bash\nchmod +x tools/clis/*.js\n```\n\n### 环境变量未生效\n\n确保 `.env` 文件位于项目根目录，或在执行命令前手动导出变量：\n\n```bash\nexport $(cat .env | xargs)\n```\n\n## 相关资源\n\n- **贡献指南**：[CONTRIBUTING.md](CONTRIBUTING.md)\n- **许可证**：[MIT License](LICENSE)\n- **问题反馈**：[GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues)\n\n## 贡献代码\n\n欢迎提交 Pull Request 和 Issue。贡献前请阅读 `CONTRIBUTING.md` 了解：\n\n1. 如何添加新的技能模块\n2. 如何改进现有文档\n3. 代码风格规范\n4. 提交信息的格式要求\n\n---\n\n\n\n## 技能系统概览\n\n### 相关页面\n\n相关主题：[技能分类总览](#skill-categories), [转化率优化技能组](#cro-skills), [内容与文案技能组](#content-skills), [SEO与发现技能组](#seo-skills), [增长与收入技能组](#growth-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)\n
\n\n# 技能系统概览\n\n## 概述\n\n技能系统（Agent Skills）是 Marketing Skills 项目中用于定义和封装营销自动化任务的核心组件。该系统基于 [Agent Skills 规范](https://agentskills.io/specification.md)，为 AI 代理提供标准化的技能描述和执行指南。\n\n技能系统的设计目标是将复杂的营销任务（如竞争对手分析、SEO 优化、广告投放管理等）封装为可复用、可组合的模块，使 AI 代理能够根据用户需求自动调用相应的技能完成任务。\n\n## 核心架构\n\n### 技能目录结构\n\n每个技能存放在独立的目录中，采用统一的目录结构组织各类资源：\n\n```\nskills//\n├── SKILL.md # 必需 - 技能主指令文件\n├── references/ # 可选 - 参考文档和指南\n│ └── *.md\n├── scripts/ # 可选 - 可执行脚本\n│ └── *.py\n└── assets/ # 可选 - 模板、数据文件\n └── *.json\n```\n\n### 技能定义规范\n\n技能使用 YAML frontmatter 定义元数据，格式如下：\n\n```yaml\n---\nname: skill-name\ndescription: 技能用途描述，包含触发短语和关键词\n---\n\n# 技能标题\n\n技能详细指令内容...\n```\n\n### Frontmatter 字段约束\n\n| 字段 | 必需 | 约束条件 |\n|------|------|----------|\n| `name` | 是 | 1-64 字符，小写字母、数字、连字符，必须与目录名完全一致 |\n| `description` | 是 | 1-1024 字符，描述技能用途和触发场景 |\n| `license` | 否 | 许可证名称（默认：MIT） |\n| `metadata` | 否 | 键值对（作者、版本等） |\n\n资料来源：[AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n\n## 技能分类\n\n### 按功能领域分类\n\n| 类别 | 示例技能 | 用途 |\n|------|----------|------|\n| 内容营销 | `ai-seo` | AI 驱动的 SEO 内容优化 |\n| 网站架构 | `site-architecture` | 网站结构规划和导航设计 |\n| 数据分析 | `analytics-tracking` | 事件跟踪和漏斗分析 |\n| 广告投放 | `paid-ads` | 付费广告管理和转化追踪 |\n| 竞争情报 | `competitor-profiling` | 竞争对手数据收集和分析 |\n\n### 按文件类型分类\n\n| 类型 | 说明 |\n|------|------|\n| 核心技能 | 包含完整 SKILL.md 和 references/ 目录 |\n| 简单技能 | 仅包含 SKILL.md 的轻量级技能 |\n| 工具技能 | 配合 CLI 工具使用的技能 |\n\n## 工作流程\n\n### 技能创建流程\n\n```mermaid\ngraph TD\n A[创建技能目录] --> B[编写 SKILL.md]\n B --> C[添加 YAML frontmatter]\n C --> D{是否需要参考资料?}\n D -->|是| E[创建 references/ 目录]\n D -->|否| F{需要脚本支持?}\n E --> F\n F -->|是| G[创建 scripts/ 目录]\n F -->|否| H{需要资源文件?}\n G --> H\n H -->|是| I[创建 assets/ 目录]\n H -->|否| J[验证 frontmatter 有效性]\n I --> J\n J --> K[提交 PR]\n```\n\n### 技能执行流程\n\n```mermaid\ngraph TD\n A[用户请求] --> B[解析触发短语]\n B --> C{匹配技能}\n C -->|找到| D[加载 SKILL.md]\n C -->|未找到| E[返回错误]\n D --> F{存在 references?}\n F -->|是| G[加载参考文档]\n F -->|否| H{存在 scripts?}\n G --> H\n H -->|是| I[准备脚本环境]\n H -->|否| J[执行技能指令]\n I --> J\n J --> K[返回结果]\n```\n\n## 命名规范\n\n### 目录命名\n\n- 使用小写字母\n- 仅使用连字符 `-` 分隔单词\n- 示例：`email-sequence`、`competitor-profiling`\n\n### 字段命名\n\n- `name` 字段必须与目录名完全一致\n- 描述中应包含触发短语，帮助代理识别相关任务\n\n## 验证与测试\n\n### 手动验证清单\n\n技能开发完成后需手动验证以下内容：\n\n| 检查项 | 命令/方法 |\n|--------|----------|\n| YAML 语法 | 检查 frontmatter 格式正确 |\n| 字段一致性 | `name` 字段与目录名匹配 |\n| 字段长度 | `name` 1-64 字符，`description` 1-1024 字符 |\n| 命名规范 | 仅允许小写字母、数字、连字符 |\n\n### CLI 工具验证\n\n对于需要 CLI 工具配合的技能：\n\n```bash\n# 语法检查\nnode --check tools/clis/.js\n\n# 显示用法\nnode tools/clis/.js\n\n# 预览请求（不发送）\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n\n## 技能示例结构\n\n### 竞争对手分析技能\n\n`competitor-profiling` 技能展示了完整的技能结构：\n\n```\ncompetitor-profiles/\n├── raw/\n│ └── /\n│ └── /\n│ ├── scrapes/ # 页面抓取结果\n│ ├── seo/ # SEO 数据\n│ └── reviews/ # 评论数据\n├── .md # 合成的竞品档案\n└── _summary.md # 跨竞品汇总\n```\n\n研究流程分为三个阶段：\n\n1. **站点抓取（Firecrawl）** - 提取定位、特性、定价和消息\n2. **SEO 数据收集（DataForSEO）** - 收集排名关键词、反向链接等\n3. **评论数据采集** - 从 G2、Capterra 等平台收集用户评价\n\n资料来源：[skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n\n### 分析跟踪技能\n\n`analytics-tracking` 技能定义了标准的事件模型：\n\n**用户上下文：**\n```json\n{\n \"user_id\": \"user_123\",\n \"plan\": \"pro\"\n}\n```\n\n**会话上下文：**\n```json\n{\n \"session_id\": \"sess_abc\",\n \"session_number\": 5,\n \"page\": \"/pricing\"\n}\n```\n\n**漏斗事件序列示例：**\n\n| 漏斗类型 | 事件序列 |\n|----------|----------|\n| 注册漏斗 | signup_started → step_completed → completed → onboarding_started |\n| 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed |\n| 电商漏斗 | product_viewed → added_to_cart → cart_viewed → checkout_started → purchase_completed |\n\n资料来源：[skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n\n## 工具集成\n\n### 集成 API 文档\n\n项目在 `tools/integrations/` 目录下维护了多种营销工具的 API 集成文档：\n\n| 工具 | 功能 | 关键端点 |\n|------|------|----------|\n| Postmark | 邮件发送与追踪 | 模板管理、退订统计 |\n| Livestorm | 网络研讨会管理 | 活动、会话、人员管理 |\n| ZoomInfo | B2B 数据 enrichment | 联系人、公司、意向数据 |\n| Intercom | 客户沟通 | 文章、事件追踪 |\n| WordPress | CMS 内容管理 | 文章、页面、媒体管理 |\n| Sanity | 结构化内容管理 | 文档查询、GROQ |\n\n### CLI 工具\n\n`tools/clis/` 目录包含 Node.js 编写的命令行工具，采用零依赖设计：\n\n| 工具 | 支持命令 |\n|------|----------|\n| livestorm.js | events、sessions、people、webhooks、organization |\n| optimizely.js | campaigns、pages |\n\n## 扩展技能系统\n\n### 添加新技能\n\n1. 创建技能目录：`mkdir -p skills/your-skill-name`\n2. 编写 SKILL.md 文件，包含有效的 YAML frontmatter\n3. 按需添加 references/、scripts/、assets/ 目录\n4. 验证文件结构和命名规范\n\n### 技能请求\n\n如需新技能，可通过 [GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 提交技能请求。\n\n资料来源：[CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n\n## 最佳实践\n\n### 技能设计原则\n\n1. **单一职责** - 每个技能专注于特定领域\n2. **清晰描述** - description 应包含触发短语和关键词\n3. **模块化结构** - 使用 references/ 目录组织相关文档\n4. **可验证性** - 提供清晰的执行路径和预期结果\n\n### 文档编写规范\n\n- 使用中文标题和说明（保留英文技术术语）\n- 包含代码示例和命令片段\n- 使用表格整理结构化数据\n- 使用 Mermaid 图展示流程和架构\n\n---\n\n\n\n## 技能分类总览\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [转化率优化技能组](#cro-skills), [内容与文案技能组](#content-skills), [SEO与发现技能组](#seo-skills), [增长与收入技能组](#growth-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n- [skills/ai-seo/references/content-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/content-patterns.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)\n- [tools/clis/livestorm.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/livestorm.js)\n
\n\n# 技能分类总览\n\n## 项目概述\n\nMarketing Skills 是一个开源的营销技能库，旨在为营销专业人员提供可复用的技能模板、参考文档和工具集成。该项目采用模块化架构，将营销技能分为多个类别，每个类别包含主技能说明文件（SKILL.md）和可选的参考文档、脚本和资源文件。资料来源：[CONTRIBUTING.md:1-10]()\n\n## 技能架构\n\n项目采用标准化目录结构管理各类营销技能，所有技能遵循统一的命名规范和元数据格式。资料来源：[CONTRIBUTING.md:18-35]()\n\n```mermaid\ngraph TD\n ROOT[\"marketingskills/\"]\n ROOT --> SKILLS[\"skills/\"]\n ROOT --> TOOLS[\"tools/\"]\n \n SKILLS --> CAT1[\"竞争对手分析
(competitor-profiling)\"]\n SKILLS --> CAT2[\"付费广告
(paid-ads)\"]\n SKILLS --> CAT3[\"站点架构
(site-architecture)\"]\n SKILLS --> CAT4[\"AI SEO
(ai-seo)\"]\n SKILLS --> CAT5[\"分析追踪
(analytics-tracking)\"]\n \n CAT1 --> SM1[\"SKILL.md\"]\n CAT1 --> REF1[\"references/\"]\n CAT1 --> SCR1[\"scripts/\"]\n \n TOOLS --> INT[\"integrations/\"]\n INT --> POSTMARK[\"postmark.md\"]\n INT --> SANITY[\"sanity.md\"]\n INT --> LIVESTORM[\"livestorm.md\"]\n INT --> WP[\"wordpress.md\"]\n INT --> ZOOMINFO[\"zoominfo.md\"]\n INT --> OUTREACH[\"outreach.md\"]\n INT --> INTERCOM[\"intercom.md\"]\n INT --> TOLT[\"tolt.md\"]\n INT --> SAVVYCAL[\"savvycal.md\"]\n \n TOOLS --> CLI[\"clis/\"]\n CLI --> LIVESTORM_JS[\"livestorm.js\"]\n CLI --> OPTIMIZELY_JS[\"optimizely.js\"]\n```\n\n## 技能类别详解\n\n### 竞争对手分析（competitor-profiling）\n\n竞争对手分析技能提供系统化的竞品研究方法论，支持营销团队深入了解市场格局。资料来源：[skills/competitor-profiling/SKILL.md:1-20]()\n\n该技能的数据采集结构如下：\n\n| 数据类型 | 存储位置 | 格式 |\n|---------|---------|------|\n| 页面抓取 | `raw/<竞品slug>/<日期>/scrapes/` | Markdown |\n| SEO数据 | `raw/<竞品slug>/<日期>/seo/` | JSON |\n| 评价数据 | `raw/<竞品-slug>/<日期>/reviews/` | Markdown/JSON |\n\n技能执行流程采用 Firecrawl 进行页面抓取，DataForSEO 进行 SEO 数据采集，并支持 G2、Capterra 等评价平台的数据整合。资料来源：[skills/competitor-profiling/SKILL.md:25-40]()\n\n### 付费广告（paid-ads）\n\n付费广告技能聚焦于转化追踪最佳实践，提供多平台的广告追踪集成方案。资料来源：[skills/paid-ads/references/conversion-tracking.md:1-15]()\n\n该技能包含主流广告平台的追踪脚本模板，包括 TikTok 广告分析等集成方案，帮助团队建立完整的广告效果归因体系。\n\n### 站点架构（site-architecture）\n\n站点架构技能指导营销人员设计合理的网站结构，涵盖导航模式、信息架构和内部链接策略。资料来源：[skills/site-architecture/references/navigation-patterns.md:1-30]()\n\n核心导航组件包括：\n\n| 组件类型 | 用途 | Schema标记 |\n|---------|------|------------|\n| 标准导航 | 主菜单导航 | nav 元素 |\n| 面包屑 | 路径导航 | BreadcrumbList |\n| 页脚导航 | 辅助链接 | footer 元素 |\n| 侧边导航 | 内容分类 | nav 元素 |\n\n技能提供了 Hub-and-Spoke 内容模型，帮助建立中心主题页面与相关子主题页面的层级关系，优化内部链接结构和 SEO 效果。资料来源：[skills/site-architecture/references/mermaid-templates.md:1-30]()\n\n### AI SEO（ai-seo）\n\nAI SEO 技能针对生成式搜索引擎优化场景，提供内容创作指南和 E-E-A-T（经验、专业性、权威性、可信度）优化策略。资料来源：[skills/ai-seo/references/content-patterns.md:1-25]()\n\n核心内容模式包括：\n\n- **自包含答案块**：可被 AI 直接提取的独立声明\n- **证据三明治结构**：主张、数据证据、结论的标准化呈现\n- **领域特定权威信号**：技术内容强调精确性，医疗内容引用同行评审研究\n\n### 分析追踪（analytics-tracking）\n\n分析追踪技能提供标准化的用户行为事件库，支持跨平台的分析数据收集。资料来源：[skills/analytics-tracking/references/event-library.md:1-50]()\n\n标准事件序列定义：\n\n| 漏斗类型 | 事件序列 |\n|---------|---------|\n| 注册漏斗 | signup_started → signup_step_completed → signup_completed → onboarding_started |\n| 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed |\n| 电商漏斗 | product_viewed → product_added_to_cart → cart_viewed → checkout_started → purchase_completed |\n\n事件上下文包含会话信息、用户属性、时间戳等标准字段，确保数据一致性和可比性。\n\n## 工具集成\n\n### 邮件服务集成\n\n**Postmark** 提供.Transactional 邮件 API 集成，支持模板管理、投递统计、退信管理和开点击追踪。资料来源：[tools/integrations/postmark.md:1-25]()\n\n| 功能 | 端点 |\n|------|------|\n| 创建模板 | POST /templates |\n| 获取投递统计 | GET /deliverystats |\n| 列表退信 | GET /bounces |\n| 搜索出站消息 | GET /messages/outbound |\n\n### 内容管理系统集成\n\n**Sanity** 作为结构化内容管理平台，支持博客、营销网站等多渠道内容交付。该集成提供文档查询（GROQ）、数据导入导出和实时协作编辑能力。资料来源：[tools/integrations/sanity.md:1-35]()\n\n关键对象类型：\n\n| 对象类型 | 说明 |\n|---------|------|\n| Document | 顶级内容项，包含 `_id`、`_type`、`_rev` |\n| Asset | CDN 存储的图片和文件 |\n| Reference | 文档间引用链接 |\n| Portable Text | 结构化富文本块 |\n| Dataset | 隔离的内容数据库 |\n\n### 网络研讨会集成\n\n**Livestorm** 支持产品演示和网络研讨会的自动化管理，提供活动创建、注册管理、会话追踪和录制获取等功能。资料来源：[tools/integrations/livestorm.md:1-30]()\n\nCLI 工具 livestorm.js 提供命令行接口，支持活动的完整生命周期管理。资料来源：[tools/clis/livestorm.js:1-25]()\n\n```bash\n# CLI 命令示例\nnode livestorm.js events list\nnode livestorm.js sessions create --event-id \nnode livestorm.js people register --id --email \n```\n\n### 其他平台集成\n\n| 平台 | 用途 | 关键功能 |\n|------|------|---------|\n| WordPress | CMS 管理 | 文章/页面 CRUD、媒体上传、用户管理 |\n| ZoomInfo | B2B 数据 | 联系人搜索、公司数据、意向信号 |\n| Outreach | 销售外联 | 潜在客户管理、序列自动化 |\n| Intercom | 客户沟通 | 文章管理、会话追踪、事件提交 |\n| Tolt | 联盟营销 | 佣金追踪、联盟管理、支付自动化 |\n| SavvyCal | 日程安排 | 预约链接管理、活动检索、网页钩子 |\n\n## CLI 工具\n\n项目提供零依赖的 Node.js CLI 工具（Node 18+），位于 `tools/clis/` 目录。资料来源：[CLAUDE.md:12-18]()\n\n| 工具 | 功能 |\n|------|------|\n| livestorm.js | Livestorm 活动、会话、人员管理 |\n| optimizely.js | Optimizely 项目和页面管理 |\n\n验证方式：\n\n```bash\n# 语法检查\nnode --check tools/clis/.js\n\n# 显示帮助\nnode tools/clis/.js\n\n# 预览请求（不发送）\nnode tools/clis/.js --dry-run\n```\n\n## 技能贡献指南\n\n### 目录命名规范\n\n| 规范项 | 要求 |\n|-------|------|\n| 目录名 | 小写，仅使用连字符分隔（如 `email-sequence`） |\n| name 字段 | 必须与目录名完全一致 |\n| 字符限制 | 1-64 个字符 |\n\n### 元数据格式\n\n```yaml\n---\nname: skill-name\ndescription: 技能描述，1-1024字符，包含触发短语\nlicense: MIT # 可选，默认 MIT\nmetadata: # 可选\n author: 作者名\n version: 1.0.0\n---\n```\n\n### 标准目录结构\n\n```\nskills/your-skill-name/\n├── SKILL.md # 必需 - 主指令文件\n├── references/ # 可选 - 附加文档\n│ └── guide.md\n├── scripts/ # 可选 - 可执行代码\n│ └── helper.py\n└── assets/ # 可选 - 模板、图片、数据\n └── template.json\n```\n\n## 技能选择流程\n\n```mermaid\ngraph TD\n START[\"营销需求识别\"] --> Q1{\"需要竞品研究?\"}\n Q1 -->|是| COMPETITOR[\"竞争对手分析\"]\n Q1 -->|否| Q2\n \n Q2{\"需要广告追踪?\"}\n Q2 -->|是| PAID[\"付费广告\"]\n Q2 -->|否| Q3\n \n Q3{\"需要网站结构设计?\"}\n Q3 -->|是| SITE[\"站点架构\"]\n Q3 -->|否| Q4\n \n Q4{\"需要 AI 搜索优化?\"}\n Q4 -->|是| AISE[\"AI SEO\"]\n Q4 -->|否| Q5\n \n Q5{\"需要用户行为分析?\"}\n Q5 -->|是| ANALYTICS[\"分析追踪\"]\n Q5 -->|否| END[\"查看工具集成\"]\n \n COMPETITOR --> TOOL1[\"数据采集 + Sanity\"]\n PAID --> TOOL2[\"TikTok + Postmark\"]\n SITE --> TOOL3[\"WordPress\"]\n AISE --> TOOL4[\"内容模式库\"]\n ANALYTICS --> TOOL5[\"事件库 + 集成\"]\n```\n\n## 总结\n\nMarketing Skills 项目通过标准化的技能分类体系，为营销团队提供从竞品研究、内容创作到效果追踪的完整工具链。每个技能类别均包含结构化的参考文档和可选的脚本工具，支持灵活组合以满足不同营销场景需求。\n\n---\n\n\n\n## 转化率优化技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [内容与文案技能组](#content-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)\n
\n\n# 转化率优化技能组\n\n## 概述\n\n转化率优化（CRO, Conversion Rate Optimization）技能组是 marketingskills 项目中的核心技能分类之一，专门用于指导 AI 代理执行各类转化率优化任务。该技能组通过结构化的指令模板，帮助自动化系统分析和改进用户旅程中的关键转化节点。\n\n根据项目文档，转化率优化技能组包含六大核心技能，覆盖从落地页到付费升级的完整用户生命周期。\n\n资料来源：[README.md:1-30]()\n\n## 技能分类体系\n\n转化率优化技能组按照用户旅程的不同阶段划分为以下六个专门技能：\n\n| 技能标识 | 适用场景 | 主要职责 |\n|---------|---------|---------|\n| `page-cro` | 营销落地页 | 分析和优化营销页面的转化效率 |\n| `signup-flow-cro` | 注册流程 | 改进用户注册/报名流程的转化率 |\n| `onboarding-cro` | 激活引导 | 优化用户注册后的激活和上手体验 |\n| `form-cro` | 线索捕获表单 | 提升表单填写率和线索收集效果 |\n| `popup-cro` | 弹窗和遮罩层 | 优化模态窗口和弹窗的转化表现 |\n| `paywall-upgrade-cro` | 付费墙升级 | 改进应用内付费升级时刻的转化 |\n\n资料来源：[README.md:18-26]()\n\n## 技能结构规范\n\n每个转化率优化技能遵循统一的项目结构规范：\n\n```\nskills/{skill-name}/\n├── SKILL.md # 必需 - 主指令文件\n├── references/ # 可选 - 补充文档\n├── scripts/ # 可选 - 可执行代码\n└── assets/ # 可选 - 模板和数据文件\n```\n\n### SKILL.md 文件规范\n\n主指令文件必须包含 YAML 前置元数据：\n\n```yaml\n---\nname: skill-name\ndescription: 何时使用此技能的描述，包含触发短语和关键词\n---\n```\n\n**必填字段规则：**\n\n| 字段 | 必填 | 规则 |\n|-----|-----|------|\n| `name` | 是 | 小写字母、数字、连字符，与目录名完全一致 |\n| `description` | 是 | 1-1024 字符，包含触发短语 |\n| `license` | 否 | 许可证名称（默认：MIT）|\n| `metadata` | 否 | 键值对（作者、版本等）|\n\n**Name 字段命名规则：**\n- 只能使用小写字母、数字和连字符\n- 不能以连字符开头或结尾\n- 不能有连续连字符（`--`）\n- 必须与父目录名称完全匹配\n\n有效示例：`page-cro`、`email-sequence`、`ab-test-setup`\n无效示例：`Page-CRO`、`-page`、`page--cro`\n\n资料来源：[CONTRIBUTING.md:1-50]()\n\n### 技能目录结构\n\n```\nskills/skill-name/\n├── SKILL.md # 必需 - 主指令（<500 行）\n├── references/ # 可选 - 按需加载的详细文档\n├── scripts/ # 可选 - 可执行代码\n└── assets/ # 可选 - 模板、数据文件\n```\n\n资料来源：[CLAUDE.md:1-30]()\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 G --> H[监控效果]\n H --> I{达成目标?}\n I -->|否| D\n I -->|是| J[持续优化]\n```\n\n### 转化漏斗序列\n\n根据事件追踪库规范，典型的转化漏斗包含以下事件序列：\n\n**注册漏斗：**\n1. `signup_started` - 注册开始\n2. `signup_step_completed` (email) - 邮箱步骤完成\n3. `signup_step_completed` (password) - 密码步骤完成\n4. `signup_completed` - 注册完成\n5. `onboarding_started` - 激活开始\n\n**购买漏斗：**\n1. `pricing_viewed` - 价格页浏览\n2. `plan_selected` - 方案选择\n3. `checkout_started` - 结账开始\n4. `payment_info_entered` - 支付信息填写\n5. `purchase_completed` - 购买完成\n\n资料来源：[skills/analytics-tracking/references/event-library.md:1-50]()\n\n## 事件追踪规范\n\n转化率优化需要依赖精确的事件追踪系统。事件追踪应包含以下关键上下文信息：\n\n### 用户上下文\n```\nuser_id: \"usr_123\"\nanonymous_id: \"anon_456\"\nemail: \"user@example.com\"\nplan: \"starter\" | \"pro\" | \"enterprise\"\n```\n\n### 会话上下文\n```\nsession_id: \"sess_abc\"\nsession_number: 5\npage: \"/pricing\"\nreferrer: \"https://google.com\"\n```\n\n### 活动上下文\n```\nsource: \"google\"\nmedium: \"cpc\"\ncampaign: \"spring_sale\"\ncontent: \"hero_cta\"\n```\n\n### 产品上下文（电商场景）\n```\nproduct_id: \"SKU123\"\nproduct_name: \"Product Name\"\ncategory: \"Category\"\nprice: 99.99\nquantity: 1\ncurrency: \"USD\"\n```\n\n### 时间上下文\n```\ntimestamp: \"2024-01-15T10:30:00Z\"\ntime_on_page: 45\nsession_duration: 300\n```\n\n资料来源：[skills/analytics-tracking/references/event-library.md:50-80]()\n\n## 导航与面包屑优化\n\n转化率优化与网站架构密切相关。良好的导航设计直接影响用户转化路径的流畅性。\n\n### 标准面包屑格式\n\n```\nHome > Features > Analytics\nHome > Blog > SEO Category > How to Do Keyword Research\nHome > Docs > API Reference > Authentication\n```\n\n**规则：**\n- 分隔符：使用 `>` 或 `/`，保持一致\n- 除当前页面外，每个段落都是链接\n- 当前页面为纯文本（不链接）\n- 如果 H1 中已显示标题，则不包含当前页面\n\n### 带 Schema 标记的面包屑\n\n```html\n\n```\n\n资料来源：[skills/site-architecture/references/navigation-patterns.md:1-50]()\n\n## 技能质量检查清单\n\n在提交或更新转化率优化技能时，必须满足以下质量标准：\n\n- [ ] `name` 字段与目录名完全匹配\n- [ ] `name` 遵循命名规则（小写、连字符、无 `--`）\n- [ ] `description` 包含 1-1024 字符的触发短语\n- [ ] `SKILL.md` 行数控制在 500 行以内\n- [ ] 不包含敏感数据或凭证信息\n- [ ] 遵循项目中现有技能的规范模式\n\n资料来源：[CONTRIBUTING.md:50-70]()\n\n## 提交工作流程\n\n### 分支命名规范\n\n| 变更类型 | 分支前缀 | 示例 |\n|---------|---------|------|\n| 新技能 | `feature/` | `feature/page-cro` |\n| 改进 | `fix/` | `fix/page-cro-clarity` |\n| 文档 | `docs/` | `docs/cro-guide` |\n\n### 提交信息规范\n\n遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范：\n\n- `feat: add page-cro skill` - 新增技能\n- `fix: improve clarity in signup-flow-cro` - 修复改进\n- `docs: update CRO guide` - 文档更新\n\n### Pull Request 模板\n\n项目提供三种 PR 模板：\n- 新技能（New Skill）\n- 技能更新（Skill Update）\n- 文档（Documentation）\n\n资料来源：[AGENTS.md:1-50]()\n\n## 技能使用示例\n\n在 Claude Code 等 AI 代理环境中，可以通过以下方式调用转化率优化技能：\n\n### 直接调用技能\n\n```\n/page-cro\n/email-sequence\n/seo-audit\n```\n\n### 通过描述触发\n\n用户可以描述任务，AI 代理会根据描述自动选择合适的技能：\n\n```\n\"优化我们的落地页以提高注册转化率\"\n→ 使用 page-cro 技能\n\n\"设置 Google Analytics 4 追踪注册事件\"\n→ 使用 analytics-tracking 技能\n```\n\n资料来源：[README.md:1-15]()\n\n## 与其他技能组的协作\n\n转化率优化技能组并非独立运作，而是与项目中的其他技能组紧密协作：\n\n```mermaid\ngraph LR\n CRO[转化率优化技能组] --> COPY[内容与文案技能组]\n CRO --> SEO[SEO与发现技能组]\n CRO --> PAID[付费与分发技能组]\n CRO --> ANALYTICS[分析与追踪技能组]\n \n COPY -->|文案优化| CRO\n SEO -->|流量提升| CRO\n PAID -->|广告优化| CRO\n ANALYTICS -->|数据支撑| CRO\n```\n\n### 协作技能列表\n\n**内容与文案：**\n- `copywriting` - 营销页面文案\n- `copy-editing` - 文案编辑润色\n- `email-sequence` - 自动化邮件序列\n\n**SEO 与发现：**\n- `seo-audit` - 技术性和页面 SEO\n- `ai-seo` - AI 搜索优化\n- `programmatic-seo` - 大规模页面生成\n\n**付费与分发：**\n- `paid-ads` - Google、Meta、LinkedIn 广告\n- `ad-creative` - 批量广告创意\n\n**分析与追踪：**\n- `analytics-tracking` - 事件追踪配置\n\n资料来源：[README.md:26-40]()\n\n## 扩展阅读\n\n如需深入了解相关主题，建议参考以下资源：\n\n- **站点架构**：`skills/site-architecture/references/` 目录下的导航模式和站点类型模板\n- **事件追踪**：`skills/analytics-tracking/references/event-library.md` 完整的事件库定义\n- **Schema 标记**：`skills/schema-markup/references/schema-examples.md` 结构化数据示例\n- **贡献指南**：`CONTRIBUTING.md` 完整的技能开发流程\n\n---\n\n\n\n## 内容与文案技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [转化率优化技能组](#cro-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/copywriting/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/SKILL.md)\n- [skills/cold-email/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/SKILL.md)\n- [skills/email-sequence/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/email-sequence/SKILL.md)\n- [skills/social-content/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social-content/SKILL.md)\n- [skills/image/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/image/SKILL.md)\n- [skills/video/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/video/SKILL.md)\n
\n\n# 内容与文案技能组\n\n## 概述\n\n内容与文案技能组是 Marketing Skills 项目中专注于营销内容创作的核心模块，涵盖从文案撰写到视觉内容生成的完整内容营销工作流程。该技能组为营销团队提供了一套标准化的内容创作指南和最佳实践，帮助生成高质量的营销文案、邮件内容、社交媒体帖子以及图像和视频素材。\n\n根据项目架构，内容与文案技能组主要包含以下核心技能：\n\n| 技能名称 | 功能描述 | 典型应用场景 |\n|---------|---------|-------------|\n| copywriting | 营销页面文案撰写 | 首页、落地页、产品页 |\n| copy-editing | 文案编辑与润色 | 现有内容的优化提升 |\n| cold-email | B2B 冷启动外联邮件 | 销售线索开发 |\n| email-sequence | 自动化邮件序列 | 欢迎序列、客户培育 |\n| social-content | 社交媒体内容 | LinkedIn、Twitter、Instagram |\n| image | AI 图像生成与设计 | 营销素材、社交图片 |\n| video | 视频内容创作 | 产品演示、教程视频 |\n\n资料来源：[README.md](README.md)\n\n## 技能组架构\n\n内容与文案技能组采用模块化设计，各技能既可独立使用，也可组合形成完整的内容营销流程。技能之间存在明确的数据流向和依赖关系：\n\n```mermaid\ngraph TD\n A[内容策略规划] --> B[copywriting 文案撰写]\n B --> C[copy-editing 文案润色]\n C --> D[多渠道分发]\n \n D --> E[cold-email 冷启动邮件]\n D --> F[email-sequence 自动化序列]\n D --> G[social-content 社交内容]\n \n G --> H[image 图像创作]\n G --> I[video 视频制作]\n \n H --> J[视觉素材输出]\n I --> J\n \n E --> K[邮件营销输出]\n F --> K\n \n style A fill:#f9f,stroke:#333\n style J fill:#9f9,stroke:#333\n style K fill:#9f9,stroke:#333\n```\n\n## 核心技能详解\n\n### 文案撰写（Copywriting）\n\n文案撰写技能是整个内容与文案技能组的基础，负责生成各类营销页面的核心文案内容。该技能专注于创建能够有效传达产品价值主张并推动用户行动的营销文案。\n\n**触发关键词与场景：**\n\n- 落地页文案（homepage copy for my SaaS）\n- 产品特性描述\n- 价值主张提炼\n- 行动号召按钮文案\n- 客户成功案例文案\n\n资料来源：[skills/copywriting/SKILL.md](skills/copywriting/SKILL.md)\n\n### 文案编辑（Copy-editing）\n\n文案编辑技能专注于对现有文案进行优化和润色，确保文案达到专业水准。该技能不从头创作内容，而是在既有文案基础上进行改进，提升可读性、说服力和品牌一致性。\n\n**适用场景：**\n\n- 现有营销页面的A/B测试变体创建\n- 品牌语言规范化调整\n- 语法和格式修正\n- 语气和调性统一\n\n### 冷启动邮件（cold-email）\n\n冷启动邮件技能专为 B2B 销售场景设计，帮助营销人员快速生成有效的冷启动外联邮件。该技能涵盖单封邮件撰写和多步骤邮件序列编排。\n\n**核心功能：**\n\n```mermaid\ngraph TD\n A[目标受众分析] --> B[邮件个性化策略]\n B --> C[开场白设计]\n C --> D[价值主张传递]\n D --> E[行动号召设置]\n E --> F[邮件序列编排]\n \n C --> G[单封冷启动邮件]\n D --> G\n E --> G\n \n F --> H[序列1: 首次接触]\n F --> I[序列2: 跟进邮件]\n F --> J[序列3: 最终唤起]\n```\n\n**API 集成支持：**\n该技能支持与多种邮件发送平台集成，包括 Postmark、ConvertKit、Mailchimp 等主流服务。\n\n资料来源：[skills/cold-email/SKILL.md](skills/cold-email/SKILL.md)\n\n### 自动化邮件序列（email-sequence）\n\n自动化邮件序列技能帮助营销团队设计和创建多步骤的自动化邮件流程，用于客户培育、欢迎序列、购物车挽回等多种场景。\n\n**邮件序列类型：**\n\n| 序列类型 | 典型邮件数量 | 发送周期 | 主要目的 |\n|---------|------------|---------|---------|\n| 欢迎序列 | 3-5 封 | 3-7 天 | 新用户激活 |\n| 培育序列 | 5-10 封 | 2-4 周 | 潜在客户培养 |\n| 挽回序列 | 2-3 封 | 1-3 天 | 购物车挽回 |\n| 再激活序列 | 3-5 封 | 1-2 周 | 沉睡用户唤醒 |\n\n**邮件内容结构：**\n每封邮件应包含清晰的标题、个性化问候、价值内容、行动号召按钮和退订链接。邮件长度应控制在合理范围内，确保移动端阅读体验。\n\n资料来源：[skills/email-sequence/SKILL.md](skills/email-sequence/SKILL.md)\n\n### 社交内容（social-content）\n\n社交内容技能专注于生成适合不同社交媒体平台的短格式内容，包括 LinkedIn、Twitter、Instagram 等主流平台的帖子和更新。\n\n**平台适配策略：**\n\n| 平台 | 内容风格 | 推荐长度 | 视觉要求 |\n|-----|---------|---------|---------|\n| LinkedIn | 专业洞察、行业发展 | 150-300 字符 | 高质量配图 |\n| Twitter/X | 简洁有力、话题标签 | 280 字符以内 | 可选配图/GIF |\n| Instagram | 视觉驱动、故事化 | 短文案 + 话题 | 必须配图 |\n| Facebook | 社区互动、轻松对话 | 100-250 字符 | 吸引眼球配图 |\n\n**内容创作原则：**\n\n- 保持品牌声音一致性\n- 使用强开场白吸引注意力\n- 包含明确的互动号召\n- 合理使用话题标签和 emoji\n\n资料来源：[skills/social-content/SKILL.md](skills/social-content/SKILL.md)\n\n### 图像创作（image）\n\n图像创作技能提供 AI 驱动的图像生成和设计能力，帮助营销团队快速创建各类视觉素材。该技能支持从提示词生成图像、图像编辑优化以及多尺寸适配输出。\n\n**核心功能模块：**\n\n```mermaid\ngraph TD\n A[图像创作需求] --> B[创作类型选择]\n \n B --> C[AI 生成图像]\n B --> D[图像编辑优化]\n B --> E[尺寸适配输出]\n \n C --> F[营销素材图]\n C --> G[社交媒体配图]\n C --> H[产品展示图]\n \n D --> I[背景移除]\n D --> J[风格转换]\n D --> K[图像增强]\n \n E --> L[社交媒体尺寸]\n E --> M[广告素材尺寸]\n E --> N[网站图片优化]\n```\n\n资料来源：[skills/image/SKILL.md](skills/image/SKILL.md)\n\n### 视频内容（video）\n\n视频内容技能专注于产品演示、教程和营销视频的脚本创作与内容规划。该技能帮助团队高效规划视频结构、撰写吸引人的脚本，并确保视频内容与整体营销策略保持一致。\n\n**视频类型支持：**\n\n- 产品功能演示\n- 操作教程和指南\n- 客户成功案例\n- 品牌故事和理念传达\n- 社交媒体短视频\n\n资料来源：[skills/video/SKILL.md](skills/video/SKILL.md)\n\n## 工作流程集成\n\n内容与文案技能组支持与项目的分析和跟踪工具集成，实现内容效果的数据闭环：\n\n```mermaid\ngraph LR\n A[内容创作] --> B[GA4 分析跟踪]\n A --> C[邮件发送统计]\n A --> D[转化归因]\n \n B --> E[效果优化建议]\n C --> E\n D --> E\n \n E --> A\n```\n\n**典型使用场景：**\n\n1. **落地页优化流程**：使用 copywriting 创建页面文案 → 通过 GA4 设置转化跟踪 → 分析用户行为数据 → 使用 copy-editing 优化文案\n\n2. **邮件营销流程**：使用 cold-email 创建外联邮件 → 使用 email-sequence 设计培育序列 → 通过邮件平台发送 → 跟踪打开率和点击率\n\n3. **社交媒体运营**：使用 social-content 创建帖子 → 使用 image 生成配图 → 发布到各平台 → 分析互动数据优化内容策略\n\n资料来源：[README.md](README.md)\n\n## 工具集成\n\n内容与文案技能组与项目中的多种工具实现集成，提供了完整的营销技术栈支持：\n\n| 工具类别 | 集成工具 | 功能支持 |\n|---------|---------|---------|\n| 邮件发送 | Postmark, Mailchimp, ConvertKit | 邮件发送、模板管理、退订处理 |\n| 分析跟踪 | GA4 | 页面访问、事件跟踪、转化归因 |\n| 设计协作 | Figma | 设计稿同步、评论反馈 |\n| 社交管理 | Buffer, Hootsuite | 定时发布、内容日历 |\n| CRM 集成 | HubSpot, Salesforce | 线索管理、邮件序列触发 |\n\n资料来源：[tools/REGISTRY.md](tools/REGISTRY.md)\n\n## 最佳实践\n\n### 内容质量标准\n\n- 所有文案应经过至少一轮审查和修改\n- 保持品牌声音和语调的一致性\n- 确保内容的准确性和可验证性\n- 针对不同渠道进行内容适配\n\n### 版本控制与迭代\n\n```mermaid\ngraph TD\n A[初稿创作] --> B[内部审查]\n B --> C{通过审核?}\n C -->|否| D[修改润色]\n D --> B\n C -->|是| E[A/B 测试变体]\n E --> F[数据分析]\n F --> G{效果达标?}\n G -->|否| D\n G -->|是| H[正式发布]\n```\n\n### 性能指标监控\n\n内容效果应通过以下关键指标进行监控：\n\n- **落地页**：转化率、跳出率、停留时间\n- **邮件**：打开率、点击率、退订率\n- **社交**：互动率、分享数、关注增长\n\n## 总结\n\n内容与文案技能组为营销团队提供了从策略规划到执行落地的完整内容创作解决方案。通过模块化的技能设计和灵活的组合方式，团队可以根据具体需求选择合适的技能组合，快速生成高质量的营销内容。技能的标准化和最佳实践的固化，确保了内容产出的一致性和可扩展性。\n\n---\n\n\n\n## SEO与发现技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [CLI工具集](#cli-tools)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/seo-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/SKILL.md)\n- [skills/ai-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/SKILL.md)\n- [skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)\n- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)\n- [skills/competitor-alternatives/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-alternatives/SKILL.md)\n- [skills/schema-markup/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/SKILL.md)\n- [skills/aso-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/aso-audit/SKILL.md)\n
\n\n# SEO与发现技能组\n\n## 概述\n\nSEO与发现技能组是Marketing Skills仓库中专注于提升内容可发现性和搜索引擎排名的技能集合。该技能组包含七个核心技能模块，涵盖了从技术SEO审计到AI驱动的内容优化、从程序化页面生成到结构化数据标记的完整SEO工作流程。\n\n这些技能协同工作，帮助营销团队系统性地优化网站的搜索可见性，同时支持程序化SEO策略以实现规模化内容生产。技能组的设计遵循模块化原则，每个技能可以独立使用，也可以组合形成完整的SEO优化方案。\n\n资料来源：[README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n\n## 技能组架构\n\n```mermaid\ngraph TD\n subgraph \"SEO与发现技能组\"\n A[seo-audit
SEO审计]\n B[ai-seo
AI驱动SEO]\n C[programmatic-seo
程序化SEO]\n D[site-architecture
网站架构]\n E[competitor-alternatives
竞品替代]\n F[schema-markup
结构化数据]\n G[aso-audit
ASO审计]\n end\n \n A --> D\n A --> F\n B --> F\n C --> D\n E --> A\n G --> A\n```\n\n## 核心技能详解\n\n### 1. SEO审计 (seo-audit)\n\nSEO审计技能负责对网站进行全面的技术健康检查，识别影响搜索排名的技术问题。\n\n#### 主要功能\n\n| 功能类别 | 描述 |\n|---------|------|\n| 索引状态分析 | 检查页面是否被搜索引擎正确索引 |\n| 元数据审查 | 验证标题标签、描述标签的优化情况 |\n| 链接健康检查 | 识别断链、重定向问题和内部链接结构 |\n| 页面速度评估 | 测量Core Web Vitals指标 |\n| 移动友好性测试 | 确保移动端用户体验符合标准 |\n\n#### 集成工具\n\n该技能依赖以下集成工具进行数据收集和分析：\n\n- **Google Search Console** - 搜索表现数据、索引状态监控\n- **Ahrefs** - 域名评级、反向链接分析、关键词排名\n- **Screaming Frog** - 网站爬取和技术问题识别\n\n资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n\n### 2. AI驱动SEO (ai-seo)\n\nAI驱动SEO技能专注于优化内容以获得AI助手的引用和推荐，这代表了搜索优化的新方向。\n\n#### 生成引擎优化模式\n\n```mermaid\ngraph LR\n A[高质量内容创作] --> B[统计引用块]\n A --> C[E-E-A-T信号]\n A --> D[自包含答案块]\n B --> E[AI引用机会增加]\n C --> E\n D --> E\n```\n\n#### 内容优化策略\n\n该技能采用多种GEO（生成引擎优化）模式来提升内容被AI引用的概率：\n\n**E-E-A-T信号块**\n\n强调经验、专业性、权威性和可信度，特别适用于YMYL（Your Money Your Life）主题的内容。Google搜索质量评估指南确认，信任是最关键因素，可信度低的页面即使看起来专业权威也会被评为低E-E-A-T。\n\n**自包含答案块**\n\n创建可直接引用、独立成立的完整答案块，包含具体细节、数字或示例，便于AI助手直接提取使用。\n\n**证据三明治结构**\n\n将声明与支撑证据配对，包括数据点列表和将证据与可操作洞察联系起来的结论性陈述。\n\n资料来源：[skills/ai-seo/references/content-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/content-patterns.md)\n\n### 3. 程序化SEO (programmatic-seo)\n\n程序化SEO技能用于大规模页面生成，通过模板和数据驱动的方式批量创建针对特定关键词的优化页面。\n\n#### 适用场景\n\n| 场景 | 描述 |\n|------|------|\n| 地理位置页面 | 为每个城市/地区生成独立页面 |\n| FAQ页面群 | 按主题批量生成问答内容 |\n| 产品比较页面 | 基于产品属性自动生成对比表 |\n| 行业术语词典 | 批量创建词条定义页面 |\n\n#### 内容模型\n\n程序化SEO依赖结构化的内容类型定义，包括页面元数据和可编程字段。内容模型需要定义动态字段以支持程序化内容生成，同时包含标准SEO字段如metaTitle、metaDescription和slug。\n\n资料来源：[skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)\n\n### 4. 网站架构 (site-architecture)\n\n网站架构技能定义了页面的层级结构、导航系统和URL规范，确保搜索引擎能够有效抓取和理解网站内容。\n\n#### 导航模式\n\n**简单导航头**\n\n适用于小型企业、简单SaaS或作品集网站，遵循以下规则：\n\n- Logo始终链接到首页\n- CTA按钮位于最右侧，视觉上突出\n- 按优先级排序（访问量最高的优先）\n- 当前页面获得视觉指示器（下划线、加粗或颜色变化）\n\n**大型菜单导航**\n\n适用于功能丰富的SaaS、电子商务或有大量内容分类的网站：\n\n- 2-4列布局\n- 按功能区域、用例或受众逻辑分组\n- 底部包含\"查看全部\"链接\n- 大型菜单内不嵌套下拉菜单\n\n#### 内容模型\n\n网站架构技能定义了核心内容类型及其字段：\n\n| 内容类型 | 核心字段 | 用途 |\n|---------|---------|------|\n| Landing Page | title, headline, body, ctaText, ctaUrl | 转化导向页面 |\n| Blog Post | title, slug, author, publishDate, body, category | 博客文章 |\n| Documentation | title, slug, body, category | 帮助文档 |\n| Author | name, bio, avatar, socialLinks | 博客作者信息 |\n| CTA Block | heading, body, buttonText, buttonUrl, variant | 可复用CTA |\n\n#### SEO字段清单\n\n每个页面级内容类型都需要配置以下字段：\n\n| 字段 | 描述 | 建议长度 |\n|------|------|---------|\n| metaTitle | 元标题 | 50-60字符 |\n| metaDescription | 元描述 | 150-160字符 |\n| ogImage | 社交分享图 | 1200x630像素 |\n| slug | URL路径段 | 简短有意义 |\n| canonicalUrl | 规范链接 | 可选覆盖 |\n| noIndex | 索引排除 | 布尔值 |\n| structuredData | 结构化数据 | 可选JSON-LD |\n\n资料来源：[skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n\n### 5. 竞品替代页面 (competitor-alternatives)\n\n竞品替代技能用于创建针对竞争对手的比较页面，帮助用户发现和评估替代产品。\n\n#### 研究流程\n\n```mermaid\ngraph TD\n A[竞品URL] --> B[Firecrawl Map
发现站点结构]\n B --> C[识别关键页面]\n C --> D[Firecrawl Scrape
抓取页面内容]\n D --> E[提取定位和功能信息]\n E --> F[生成竞品档案]\n F --> G[创建替代对比页面]\n```\n\n#### 优先抓取页面类型\n\n| 页面类型 | 提取内容 |\n|---------|---------|\n| 首页 | 标题、副标题、价值主张、主要CTA、社会证明 |\n| 定价页 | 定价层级、功能对比、计费选项、免费试用 |\n| 功能页 | 功能分类、主要功能、功能描述 |\n| 关于页 | 公司信息、团队背景、发展历程 |\n\n#### 数据工具\n\n- **Firecrawl Map** - 发现站点结构，识别关键页面\n- **Firecrawl Scrape** - 批量抓取页面内容\n- **Firecrawl Extract** - 使用schema提取结构化数据\n\n资料来源：[skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n\n### 6. 结构化数据 (schema-markup)\n\n结构化数据技能为网页添加Schema.org标记，帮助搜索引擎理解页面内容并生成丰富搜索结果。\n\n#### 支持的Schema类型\n\n**Organization**\n\n用于品牌和组织信息，声明站点名称、标志和社交资料。\n\n**WebSite**\n\n用于整个网站，包含站点名称和搜索框配置，支持Sitelink搜索框。\n\n**Article/BlogPosting**\n\n用于博客文章和新闻，包含标题、图片、发布日期、作者和发布者信息。\n\n**Product**\n\n用于电商或SaaS产品页面，包含名称、图片、描述、价格和库存状态。\n\n#### JSON-LD格式示例\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Article\",\n \"headline\": \"文章标题\",\n \"image\": \"https://example.com/image.jpg\",\n \"datePublished\": \"2024-01-15T08:00:00+00:00\",\n \"author\": {\n \"@type\": \"Person\",\n \"name\": \"作者名称\"\n },\n \"publisher\": {\n \"@type\": \"Organization\",\n \"name\": \"公司名称\",\n \"logo\": {\n \"@type\": \"ImageObject\",\n \"url\": \"https://example.com/logo.png\"\n }\n }\n}\n```\n\n资料来源：[skills/schema-markup/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/references/schema-examples.md)\n\n### 7. ASO审计 (aso-audit)\n\nASO（应用商店优化）审计技能专注于提升移动应用在应用商店中的可见性，包括App Store和Google Play。\n\n#### 审计维度\n\n| 维度 | 描述 |\n|------|------|\n| 应用标题 | 关键词优化、品牌识别 |\n| 应用描述 | 关键词密度、价值主张 |\n| 截图和视频 | 视觉吸引力、功能展示 |\n| 评分和评论 | 用户反馈、问题识别 |\n| 关键词覆盖 | 搜索词排名监控 |\n\n资料来源：[skills/aso-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/aso-audit/SKILL.md)\n\n## 工作流程整合\n\n### 完整SEO优化流程\n\n```mermaid\ngraph TD\n subgraph \"阶段一：技术基础\"\n A1[网站架构规划] --> A2[URL结构设计]\n A2 --> A3[导航系统搭建]\n A3 --> A4[面包屑实现]\n end\n \n subgraph \"阶段二：内容创建\"\n B1[内容策略制定] --> B2[程序化页面生成]\n B2 --> B3[竞品替代页面]\n B3 --> B4[AI驱动内容优化]\n end\n \n subgraph \"阶段三：技术优化\"\n C1[结构化数据添加] --> C2[SEO审计执行]\n C2 --> C3[问题修复跟踪]\n C3 --> C4[持续监控]\n end\n \n A4 --> B1\n B4 --> C1\n C4 --> A1\n```\n\n### 技能间依赖关系\n\n| 源技能 | 目标技能 | 依赖说明 |\n|-------|---------|---------|\n| site-architecture | seo-audit | 提供URL结构和导航基础 |\n| site-architecture | programmatic-seo | 定义内容模型和模板 |\n| seo-audit | schema-markup | 基于审计结果添加标记 |\n| ai-seo | schema-markup | E-E-A-T内容支持结构化数据 |\n| competitor-alternatives | seo-audit | 提供竞品分析输入 |\n\n## 工具集成总览\n\n| 工具类别 | 工具名称 | 用途 |\n|---------|---------|------|\n| 分析平台 | Google Search Console | 搜索表现、索引状态 |\n| SEO工具 | Ahrefs | 域名评级、关键词、外链 |\n| 内容管理 | Sanity | 无头CMS，内容建模 |\n| 数据源 | ZoomInfo | 公司和联系人数据 |\n| 链接管理 | Dub.co | 短链接、UTM追踪 |\n| 网站发布 | WordPress | 内容发布和媒体管理 |\n| 客户数据 | Optimizely | 实验和个性化 |\n\n资料来源：[tools/integrations/ahrefs.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/ahrefs.md)\n\n## 最佳实践\n\n### 内容创作标准\n\n1. **E-E-A-T优先** - 在所有内容中强调经验、专业性、权威性和可信度\n2. **自包含答案** - 创建能被AI直接引用的独立答案块\n3. **统计引用** - 使用具体数据支撑声明，统计内容可提升15-30%的AI引用率\n4. **自然语言** - 使用自然的疑问句式，匹配用户实际搜索意图\n\n### 技术实现要点\n\n1. **SEO字段完整** - 每个页面必须包含metaTitle、metaDescription、slug\n2. **结构化数据验证** - 使用Google Rich Results Test验证Schema标记\n3. **导航一致性** - 保持全站导航模式统一，面包屑清晰准确\n4. **性能优先** - 优化Core Web Vitals指标，特别是LCP和CLS\n\n### 程序化SEO注意事项\n\n1. **避免重复内容** - 确保程序化页面有足够的独特价值\n2. **内部链接策略** - Hub-and-Spoke模型建立主题集群\n3. **规范化处理** - 使用canonical标签防止内部重复\n4. **分层架构** - 高权重页面支撑长尾页面\n\n## 总结\n\nSEO与发现技能组提供了从技术审计到AI优化的完整SEO解决方案。通过整合这七个核心技能，营销团队可以系统性地提升网站在传统搜索引擎和AI助手中的可见性，实现可持续的有机流量增长。技能组的模块化设计允许团队根据具体需求选择使用单个技能或组合多个技能，形成定制化的SEO工作流程。\n\n---\n\n\n\n## 增长与收入技能组\n\n### 相关页面\n\n相关主题：[技能系统概览](#skills-overview), [CLI工具集](#cli-tools)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)\n- [skills/content-strategy/references/headless-cms.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/content-strategy/references/headless-cms.md)\n- [skills/competitor-alternatives/references/templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-alternatives/references/templates.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [tools/integrations/zoominfo.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/zoominfo.md)\n
\n\n# 增长与收入技能组\n\n## 概述\n\n增长与收入技能组是 marketingskills 项目中专注于业务扩张、变现策略和销售运营的技能集合。该技能组涵盖从获客增长到客户保留的完整业务增长周期，旨在帮助 SaaS 企业实现可持续的收入增长。\n\n根据项目结构，该技能组包含以下核心领域：\n\n| 技能分类 | 技能名称 | 用途说明 |\n|---------|---------|---------|\n| 增长工程 | `co-marketing` | 合作伙伴识别与联合营销活动 |\n| 增长工程 | `free-tool-strategy` | 营销工具与计算器策略 |\n| 增长工程 | `referral-program` | 推荐与联盟项目 |\n| 策略与变现 | `marketing-ideas` | 140个 SaaS 营销创意 |\n| 策略与变现 | `marketing-psychology` | 心理模型与用户心理 |\n| 策略与变现 | `launch-strategy` | 产品发布与公告 |\n| 策略与变现 | `pricing-strategy` | 定价、包装与商业化 |\n| 销售与运营 | `revops` | 潜在客户生命周期、评分、路由与管道管理 |\n| 销售与运营 | `sales-enablement` | 销售演示、单页资料、异议处理文档与演示脚本 |\n| 转化优化 | `page-cro` | 营销页面优化 |\n| 转化优化 | `signup-flow-cro` | 注册流程优化 |\n| 转化优化 | `onboarding-cro` | 激活流程优化 |\n| 转化优化 | `churn-prevention` | 流失防止、取消流程、挽留优惠与付款恢复 |\n| 付费分发 | `paid-ads` | Google、Meta、LinkedIn 广告活动 |\n| 付费分发 | `ad-creative` | 批量广告创意生成与迭代 |\n\n资料来源：[README.md]()\n\n## 架构总览\n\n增长与收入技能组采用分层架构，涵盖从获客到留存的全链路。\n\n```mermaid\ngraph TD\n subgraph \"获客层\"\n PA[paid-ads
付费广告]\n CC[co-marketing
联合营销]\n FT[free-tool-strategy
免费工具策略]\n RP[referral-program
推荐计划]\n end\n\n subgraph \"转化层\"\n PC[page-cro
页面优化]\n SF[signup-flow-cro
注册流程]\n OB[onboarding-cro
激活流程]\n end\n\n subgraph \"变现层\"\n PS[pricing-strategy
定价策略]\n LS[launch-strategy
发布策略]\n SE[sales-enablement
销售赋能]\n end\n\n subgraph \"留存层\"\n CP[churn-prevention
流失防止]\n RV[revops
收入运营]\n end\n\n subgraph \"策略层\"\n MI[marketing-ideas
营销创意]\n MP[marketing-psychology
营销心理学]\n end\n\n PA --> PC\n CC --> PC\n FT --> PC\n RP --> PC\n PC --> SF\n SF --> OB\n OB --> PS\n PS --> SE\n SE --> RV\n OB --> CP\n CP --> RV\n LS --> PA\n MI --> CC\n MP --> FT\n\n style PA fill:#e1f5ff\n style PS fill:#fff3e0\n style CP fill:#f3e5f5\n style RV fill:#e8f5e9\n```\n\n## 核心技能详解\n\n### 1. 增长工程技能\n\n增长工程技能组专注于通过创新策略和合作伙伴关系实现用户增长。\n\n#### 1.1 联合营销 (co-marketing)\n\n联合营销技能帮助识别潜在合作伙伴并策划联合营销活动。该技能涵盖：\n\n- **合作伙伴识别**：根据目标受众重叠度、品牌定位匹配度评估合作伙伴\n- **活动策划**：设计联合网络研讨会、内容合作、联合推广等活动\n- **ROI 追踪**：建立双方认可的效果衡量指标\n\n#### 1.2 免费工具策略 (free-tool-strategy)\n\n免费工具策略技能用于设计营销导向的工具和计算器：\n\n- **工具类型**：ROI 计算器、ROI 预测工具、行业基准工具\n- **获客机制**：通过工具使用引导用户留下联系方式\n- **数据收集**：在用户使用工具过程中收集行为数据\n\n```mermaid\ngraph LR\n A[用户访问
免费工具] --> B[使用工具
获得价值]\n B --> C[查看结果
需要邮箱]\n C --> D[获取报告
留下联系方式]\n D --> E[触发线索
培育流程]\n \n style A fill:#e3f2fd\n style E fill:#c8e6c9\n```\n\n#### 1.3 推荐计划 (referral-program)\n\n推荐计划技能涵盖推荐人和被推荐人的激励机制设计：\n\n- **双面奖励**：为推荐人和被推荐人提供双向奖励\n- **分级机制**：根据推荐数量设置阶梯奖励\n- **防刷机制**：识别虚假推荐和激励滥用\n\n### 2. 策略与变现技能\n\n#### 2.1 营销创意 (marketing-ideas)\n\n该技能提供 140 个 SaaS 营销创意，涵盖：\n\n- 内容营销策略\n- 社交媒体增长策略\n- 社区建设策略\n- 合作伙伴策略\n\n#### 2.2 营销心理学 (marketing-psychology)\n\n运用心理模型优化营销效果：\n\n- **承诺与一致性**：通过小请求引导大承诺\n- **社会认同**：展示用户评价和使用数据\n- **稀缺性**：限时优惠和限量供应\n- **锚定效应**：设置高价选项引导选择\n\n#### 2.3 发布策略 (launch-strategy)\n\n产品发布技能包含完整的发布流程：\n\n```mermaid\ngraph TD\n P1[预热期
建立期待] --> P2[预告期
功能揭秘]\n P2 --> P3[发布日
全面上线]\n P3 --> P4[跟进期
用户反馈]\n P4 --> P5[优化期
迭代改进]\n \n style P1 fill:#fff3e0\n style P3 fill:#ffcdd2\n style P5 fill:#c8e6c9\n```\n\n#### 2.4 定价策略 (pricing-strategy)\n\n定价策略技能覆盖定价、包装和商业化的各个方面：\n\n| 定价模式 | 适用场景 | 关键考量 |\n|---------|---------|---------|\n| 按用户数定价 | B2B SaaS | 团队规模与使用量匹配 |\n| 按功能分层 | 功能差异化物 | 功能分层与价值感知 |\n| 用量计费 | API 产品 | 成本结构与扩展性 |\n| 混合定价 | 复杂产品 | 基础订阅 + 额外用量 |\n\n**定价心理学要素：**\n\n- 锚定价格设置\n- 视觉层次引导\n- 价值对比框架\n- 套餐捆绑策略\n\n### 3. 销售赋能技能\n\n#### 3.1 收入运营 (revops)\n\n收入运营技能覆盖销售运营的完整生命周期：\n\n```mermaid\ngraph TD\n LE[线索生成
Lead Generation] --> LEQ[线索资质认定
Lead Qualification]\n LEQ --> LH[线索分配
Lead Handoff]\n LH --> SQ[销售线索
Sales Qualified]\n SQ --> OP[商机管道
Opportunity]\n OP --> CN[谈判
Negotiation]\n CN --> CW[成交
Closed Won]\n CW --> IR[初始收入
Initial Revenue]\n \n style LE fill:#e3f2fd\n style SQ fill:#fff3e0\n style CW fill:#c8e6c9\n```\n\n**核心指标追踪：**\n\n- 线索转化率 (Lead Conversion Rate)\n- 销售周期 (Sales Cycle Length)\n- 管道覆盖率 (Pipeline Coverage)\n- 成交率 (Win Rate)\n\n#### 3.2 销售赋能 (sales-enablement)\n\n销售赋能技能提供标准化的销售辅助材料：\n\n| 材料类型 | 用途 | 关键要素 |\n|---------|-----|---------|\n| 销售演示 | 客户会议 | 痛点共鸣、解决方案、案例证明 |\n| 单页资料 | 快速传递价值 | 单页概述、关键指标、CTA |\n| 异议处理 | 应对客户疑虑 | 常见反对意见及标准答复 |\n| 演示脚本 | 产品演示 | 关键功能点、价值语言 |\n\n### 4. 转化优化技能\n\n#### 4.1 页面转化优化 (page-cro)\n\n营销页面优化涵盖以下关键元素：\n\n**首屏优化要素：**\n\n- 价值主张清晰表达\n- 社会认同元素展示\n- 主要 CTA 突出显示\n\n**信任信号布局：**\n\n- 客户 logo 展示\n- 评价和推荐\n- 安全认证标识\n\n#### 4.2 注册流程优化 (signup-flow-cro)\n\n注册流程优化关注转化漏斗的每一步：\n\n```mermaid\ngraph LR\n A[开始注册] --> B{邮箱输入}\n B -->|成功| C{密码设置}\n B -->|失败| B\n C -->|成功| D{邮箱验证}\n C -->|失败| C\n D -->|成功| E[注册完成]\n D -->|失败| D\n \n style E fill:#c8e6c9\n```\n\n**优化要点：**\n\n- 减少必填字段数量\n- 实时表单验证\n- 渐进式表单设计\n- 社会化登录选项\n\n#### 4.3 激活流程优化 (onboarding-cro)\n\n新用户激活流程确保用户快速发现产品价值：\n\n- 引导式入职流程\n- 个性化激活路径\n- 关键里程碑设置\n- 早期成功指标追踪\n\n### 5. 留存与流失防止\n\n#### 5.1 流失防止 (churn-prevention)\n\n流失防止技能覆盖整个客户生命周期：\n\n```mermaid\ngraph TD\n subgraph \"客户成功管理\"\n ON[新用户激活] --> UU[正常使用]\n UU --> HR[健康度监控]\n HR --> RI[风险识别]\n RI --> IR[干预措施]\n IR --> RS[问题解决]\n RS --> RU[恢复使用]\n end\n\n subgraph \"风险信号\"\n RI --> RS1[低活跃度]\n RI --> RS2[低功能使用]\n RI --> RS3[支持工单增加]\n RI --> RS4[支付问题]\n end\n\n style ON fill:#e3f2fd\n style RI fill:#ffcdd2\n style RS fill:#c8e6c9\n```\n\n**流失防止策略：**\n\n| 策略类型 | 触发条件 | 干预措施 |\n|---------|---------|---------|\n| 挽留优惠 | 检测到流失意向 | 折扣、增值功能 |\n| 主动关怀 | 使用频率下降 | 1v1 沟通、引导使用 |\n| Dunning | 支付失败 | 付款提醒、多方式重试 |\n| 取消流程 | 用户申请取消 | 取消原因收集、最终优惠 |\n\n### 6. 付费分发技能\n\n#### 6.1 付费广告 (paid-ads)\n\n付费广告技能覆盖主流广告平台的投放策略：\n\n| 平台 | 适用目标 | 核心指标 |\n|-----|---------|---------|\n| Google Ads | 搜索意图明确 | CPC、转化率、质量得分 |\n| Meta Ads | 品牌认知、漏斗中层 | CPM、CPC、ROAS |\n| LinkedIn Ads | B2B 决策者触达 | CPM、CPC、线索成本 |\n\n**广告活动结构：**\n\n- 活动层级：Campaign → Ad Set → Ad\n- 受众分层：人口统计 + 兴趣 + 行为\n- 出价策略：手动出价 vs 目标 ROAS\n\n#### 6.2 广告创意 (ad-creative)\n\n广告创意技能支持批量生成和迭代优化：\n\n- 多变体 A/B 测试\n- 素材规格适配（图片、视频、轮播）\n- 文案模板库\n- 效果追踪与分析\n\n## 工具集成\n\n增长与收入技能组支持与多种营销工具集成：\n\n### 客户数据与情报\n\n| 工具 | 功能 | 集成方式 |\n|-----|-----|---------|\n| ZoomInfo | B2B 联系人数据 | API 批量查询 |\n\n**ZoomInfo 关键接口：**\n\n```json\n// 联系人搜索\nPOST https://api.zoominfo.com/search/contact\n{\n \"firstName\": [\"Jane\"],\n \"lastName\": [\"Doe\"],\n \"jobTitle\": [\"VP Marketing\"],\n \"companyName\": [\"Acme Corp\"],\n \"rpp\": 25,\n \"page\": 1\n}\n\n// 联系人富化\nPOST https://api.zoominfo.com/enrich/contact\n{\n \"matchEmail\": [\"jane@acme.com\"]\n}\n```\n\n资料来源：[tools/integrations/zoominfo.md]()\n\n### 邮件营销\n\n| 工具 | 功能 | 集成方式 |\n|-----|-----|---------|\n| Postmark | 交易邮件、模板管理 | REST API |\n\n**Postmark 核心功能：**\n\n- 邮件模板创建与管理\n- 批量发送与统计\n- 退信处理与激活\n- 打开和点击追踪\n\n资料来源：[tools/integrations/postmark.md]()\n\n### 内容管理\n\n| 工具 | 功能 | 适用场景 |\n|-----|-----|---------|\n| Sanity | 无头 CMS | 结构化内容管理 |\n\n**Sanity 内容类型设计：**\n\n| 内容类型 | 核心字段 | 用途 |\n|---------|---------|-----|\n| Page | title, slug, content, seo | 营销页面 |\n| BlogPost | title, body, author, category | 博客内容 |\n| Author | name, bio, avatar, socialLinks | 作者信息 |\n| CTA Block | heading, body, buttonText, buttonUrl | 可复用 CTA |\n\n资料来源：[skills/content-strategy/references/headless-cms.md]()\n\n## 最佳实践\n\n### 增长策略框架\n\n1. **测量优先**：建立完整的数据追踪体系\n2. **快速迭代**：小步快跑，持续优化\n3. **用户洞察**：深入理解用户旅程和痛点\n4. **跨职能协作**：增长、产品、销售协同\n\n### 收入运营流程\n\n```mermaid\ngraph LR\n A[数据收集] --> B[分析洞察]\n B --> C[策略制定]\n C --> D[执行实施]\n D --> E[效果验证]\n E --> A\n\n style A fill:#e3f2fd\n style B fill:#fff3e0\n style C fill:#f3e5f5\n style D fill:#e8f5e9\n style E fill:#ffecb3\n```\n\n### 流失防止机制\n\n- **预警系统**：建立客户健康度评分模型\n- **自动化干预**：基于触发的自动关怀流程\n- **人工介入**：高价值客户的专属关怀\n\n## 相关资源\n\n- **贡献指南**：[CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - 学习如何添加新技能\n- **项目架构**：[CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md) - 项目结构说明\n- **站点架构**：[skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md) - 页面层次结构设计\n\n## 总结\n\n增长与收入技能组构成了 marketingskills 项目中实现业务增长的核心能力矩阵。该技能组从获客增长（付费广告、联合营销、推荐计划）到转化优化（页面优化、注册流程、入职激活），再到变现策略（定价策略、销售赋能）和客户留存（收入运营、流失防止），覆盖了 SaaS 企业增长的全生命周期。\n\n通过灵活组合这些技能，营销团队可以构建完整的增长引擎，实现可持续的收入增长目标。\n\n---\n\n\n\n## CLI工具集\n\n### 相关页面\n\n相关主题：[SEO与发现技能组](#seo-skills)\n\n
\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [tools/REGISTRY.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/REGISTRY.md)\n- [tools/clis/README.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/README.md)\n- [tools/clis/google-ads.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/google-ads.js)\n- [tools/clis/meta-ads.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/meta-ads.js)\n- [tools/clis/ga4.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/ga4.js)\n- [tools/clis/hubspot.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/hubspot.js)\n- [tools/integrations/ahrefs.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/ahrefs.md)\n- [tools/integrations/zoominfo.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/zoominfo.md)\n
\n\n# CLI工具集\n\n## 概述\n\nCLI工具集是marketingskills项目中的命令行接口模块，位于`tools/clis/`目录下。该模块为市场营销专业人员提供了一套统一的命令行工具，用于管理与Google Ads、Meta Ads、Google Analytics 4、HubSpot等主流营销平台的交互。\n\nCLI工具集的主要目标是简化营销自动化工作流程，使营销人员能够在终端环境中直接执行广告管理、分析查询和CRM操作等任务。通过统一的命令行界面，用户可以快速集成到现有的开发或自动化流程中。\n\n## 架构设计\n\n```mermaid\ngraph TD\n subgraph \"CLI工具集架构\"\n CLI[\"CLI入口
node cli-name.js\"]\n REGISTRY[\"工具注册表
REGISTRY.md\"]\n GOOGLE[\"google-ads.js\"]\n META[\"meta-ads.js\"]\n GA4[\"ga4.js\"]\n HUBSPOT[\"hubspot.js\"]\n OPTIMIZELY[\"optimizely.js\"]\n LIVESTORM[\"livestorm.js\"]\n end\n \n CLI --> REGISTRY\n REGISTRY --> GOOGLE\n REGISTRY --> META\n REGISTRY --> GA4\n REGISTRY --> HUBSPOT\n REGISTRY --> OPTIMIZELY\n REGISTRY --> LIVESTORM\n \n GOOGLE --> GOOGLE_API[\"Google Ads API\"]\n META --> META_API[\"Meta Marketing API\"]\n GA4 --> GA4_API[\"GA4 Data API\"]\n HUBSPOT --> HS_API[\"HubSpot API\"]\n```\n\n## 核心组件\n\n### 工具注册表\n\n工具注册表（`tools/REGISTRY.md`）是CLI工具集的核心配置文件，定义了所有可用工具的元数据。每个工具条目包含以下字段：\n\n| 字段 | 必填 | 说明 |\n|------|------|------|\n| `name` | 是 | 工具名称（小写字母、数字、连字符） |\n| `description` | 是 | 工具功能描述（1-1024字符） |\n| `license` | 否 | 许可证类型（默认MIT） |\n| `metadata` | 否 | 键值对元数据（作者、版本等） |\n\n**名称字段规则：**\n\n- 仅使用小写字母、数字和连字符\n- 不能以连字符开头或结尾\n- 禁止连续连字符\n- 必须与父目录名称完全匹配\n\n### Google Ads CLI\n\nGoogle Ads命令行工具（`tools/clis/google-ads.js`）提供与Google Ads平台的交互能力。该工具支持广告系列管理、关键词查询和效果报告等核心功能。\n\n**主要功能模块：**\n\n- 广告系列（Campaigns）管理\n- 广告组（Ad Groups）操作\n- 关键词（Keywords）查询\n- 转化追踪配置\n\n### Meta Ads CLI\n\nMeta Ads命令行工具（`tools/clis/meta-ads.js`）用于管理Facebook和Instagram广告。该工具封装了Meta Marketing API的核心功能。\n\n**支持的API端点类型：**\n\n- 账户层级操作\n- 广告系列管理\n- 受众定向\n- 广告创意管理\n\n### Google Analytics 4 CLI\n\nGA4命令行工具（`tools/clis/ga4.js`）提供对Google Analytics 4 Data API的访问。该工具允许用户查询网站和应用的分析数据。\n\n**关键指标类型：**\n\n| 类别 | 指标示例 |\n|------|----------|\n| 用户指标 | activeUsers, newUsers, totalUsers |\n| 会话指标 | sessions, bounces, sessionDuration |\n| 转化指标 | conversions, totalRevenue |\n| 事件指标 | eventCount, userEngagementDuration |\n\n### HubSpot CLI\n\nHubSpot命令行工具（`tools/clis/hubspot.js`）集成HubSpot CRM API，支持联系人、公司和交易管理。\n\n**核心功能：**\n\n- 联系人CRUD操作\n- 公司数据管理\n- 交易管道追踪\n- 营销自动化工作流触发\n\n### Optimizely CLI\n\nOptimizely命令行工具（`tools/clis/optimizely.js`）提供实验平台的管理能力。\n\n**命令结构：**\n\n```bash\noptimizely [options]\n\n可用命令：\n campaigns campaigns list --project-id \n experiments experiments list --project-id \n pages pages list --project-id \n \n选项参数：\n --page 页码\n --per-page 每页数量\n --status 状态过滤（not_started|running|paused|archived）\n```\n\n### Livestorm CLI\n\nLivestorm命令行工具（`tools/clis/livestorm.js`）管理虚拟活动和在线研讨会。\n\n**命令体系：**\n\n| 命令 | 功能 | 子命令示例 |\n|------|------|------------|\n| `events` | 活动管理 | list, get, create, update, delete |\n| `sessions` | 场次管理 | list, create, delete, register |\n| `people` | 参与者 | list, get |\n| `webhooks` | Webhook | list, create, delete |\n| `organization` | 组织信息 | organization |\n\n## 数据模型\n\n### 通用CLI输出格式\n\n所有CLI工具采用统一的JSON输出格式，便于后续处理和集成。\n\n```javascript\n// 成功响应\n{\n \"data\": [...],\n \"metadata\": {\n \"page\": 1,\n \"perPage\": 20,\n \"total\": 100\n }\n}\n\n// 错误响应\n{\n \"error\": \"错误消息\",\n \"code\": \"ERROR_CODE\"\n}\n```\n\n### 状态流转\n\n```mermaid\nstateDiagram-v2\n [*] --> 初始化: CLI启动\n 初始化 --> 认证: 加载配置\n 认证 --> 就绪: Token验证\n 就绪 --> 执行: 接收命令\n 执行 --> 处理: 解析参数\n 处理 --> API调用: 构建请求\n API调用 --> 响应解析: 获取结果\n 响应解析 --> 输出: 格式化JSON\n 输出 --> [*]: 完成\n 认证 --> 错误: 认证失败\n 执行 --> 错误: 参数错误\n 错误 --> [*]: 退出\n```\n\n## 工具使用工作流\n\n```mermaid\ngraph LR\n A[\"用户输入命令\"] --> B[\"CLI解析器\"]\n B --> C{\"命令有效性\"}\n C -->|有效| D[\"读取配置\"]\n C -->|无效| E[\"显示帮助信息\"]\n D --> F[\"调用工具模块\"]\n F --> G[\"API认证\"]\n G --> H[\"发送请求\"]\n H --> I{\"响应状态\"}\n I -->|成功| J[\"解析响应数据\"]\n I -->|失败| K[\"输出错误信息\"]\n J --> L[\"格式化输出\"]\n L --> M[\"终端显示\"]\n```\n\n## 与集成工具的关系\n\nCLI工具集与`tools/integrations/`目录下的其他集成工具协同工作，形成完整的营销技术栈：\n\n| CLI工具 | 对应集成 | 主要用途 |\n|---------|----------|----------|\n| google-ads.js | - | 广告投放管理 |\n| meta-ads.js | - | 社交广告管理 |\n| ga4.js | - | 数据分析 |\n| hubspot.js | ahrefs.md, zoominfo.md | CRM与数据丰富 |\n| optimizely.js | - | A/B测试与实验 |\n| livestorm.js | - | 活动管理 |\n\n## 安全与认证\n\n### 环境变量配置\n\nCLI工具通过环境变量管理敏感凭证：\n\n```bash\n# Google Ads\nexport GOOGLE_ADS_DEVELOPER_TOKEN=\"your-token\"\nexport GOOGLE_ADS_CLIENT_ID=\"your-client-id\"\nexport GOOGLE_ADS_CLIENT_SECRET=\"your-secret\"\n\n# Meta Ads\nexport META_ACCESS_TOKEN=\"your-token\"\n\n# GA4\nexport GOOGLE_APPLICATION_CREDENTIALS=\"/path/to/service-account.json\"\n\n# HubSpot\nexport HUBSPOT_ACCESS_TOKEN=\"your-token\"\n```\n\n### 最佳实践\n\n- 凭证不应硬编码在源码中\n- 使用`.env`文件管理本地开发环境\n- 生产环境使用密钥管理服务\n- 定期轮换API访问令牌\n\n## 扩展指南\n\n### 新增CLI工具\n\n在`tools/clis/`目录下创建新的CLI工具文件：\n\n```\ntools/clis/\n├── new-tool.js\n└── ...\n```\n\n工具文件应遵循以下结构：\n\n```javascript\n#!/usr/bin/env node\n\nfunction main() {\n // 主逻辑\n const result = {\n command: 'new-tool',\n options: { /* 参数定义 */ },\n description: '工具功能描述'\n };\n \n console.log(JSON.stringify(result, null, 2));\n}\n\nmain().catch(err => {\n console.error(JSON.stringify({ error: err.message }));\n process.exit(1);\n});\n```\n\n### 注册新工具\n\n在`tools/REGISTRY.md`中添加新工具条目，确保：\n\n- `name`字段与文件名匹配\n- 提供清晰的`description`\n- 包含完整的`metadata`信息\n\n## 相关资源\n\n- 集成工具文档：[tools/integrations/](../integrations/)\n- 工具注册表配置：[tools/REGISTRY.md](./REGISTRY.md)\n- 源码示例：[tools/clis/](./)\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：coreyhaines31/marketingskills\n\n摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令：`npx skills`\n- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n\n## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 7. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n\n## 8. 能力坑 · 能力判断依赖假设\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:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\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:1135212071 | https://github.com/coreyhaines31/marketingskills | 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:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.\n\n## 12. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。\n\n## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。\n\n## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。\n\n## 18. 维护坑 · 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:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown\n\n## 19. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | 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项目：coreyhaines31/marketingskills\n\n摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令：`npx skills`\n- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n\n## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 7. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n\n## 8. 能力坑 · 能力判断依赖假设\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:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\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:1135212071 | https://github.com/coreyhaines31/marketingskills | 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:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.\n\n## 12. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。\n\n## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。\n\n## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。\n\n## 18. 维护坑 · 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:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown\n\n## 19. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown\n", "summary": "用户实践前最可能遇到的身份、安装、配置、运行和安全坑。", "title": "Pitfall Log / 踩坑日志" }, "prompt_preview": { "asset_id": "prompt_preview", "filename": "PROMPT_PREVIEW.md", "markdown": "# marketingskills - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 marketingskills 的“安装前体验版”。\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-overview：项目概述。围绕“项目概述”模拟一次用户任务，不展示安装或运行结果。\n2. quick-start：快速开始。围绕“快速开始”模拟一次用户任务，不展示安装或运行结果。\n3. installation-guide：安装指南。围绕“安装指南”模拟一次用户任务，不展示安装或运行结果。\n4. skills-overview：技能系统概览。围绕“技能系统概览”模拟一次用户任务，不展示安装或运行结果。\n5. skill-categories：技能分类总览。围绕“技能分类总览”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. project-overview\n输入：用户提供的“项目概述”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. quick-start\n输入：用户提供的“快速开始”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. installation-guide\n输入：用户提供的“安装指南”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. skills-overview\n输入：用户提供的“技能系统概览”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n5. skill-categories\n输入：用户提供的“技能分类总览”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / project-overview：Step 1 必须围绕“项目概述”形成一个小中间产物，并等待用户确认。\n- Step 2 / quick-start：Step 2 必须围绕“快速开始”形成一个小中间产物，并等待用户确认。\n- Step 3 / installation-guide：Step 3 必须围绕“安装指南”形成一个小中间产物，并等待用户确认。\n- Step 4 / skills-overview：Step 4 必须围绕“技能系统概览”形成一个小中间产物，并等待用户确认。\n- Step 5 / skill-categories：Step 5 必须围绕“技能分类总览”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/coreyhaines31/marketingskills\n- https://github.com/coreyhaines31/marketingskills#readme\n- skills/ab-test-setup/SKILL.md\n- skills/ad-creative/SKILL.md\n- skills/ai-seo/SKILL.md\n- skills/analytics-tracking/SKILL.md\n- skills/aso-audit/SKILL.md\n- skills/churn-prevention/SKILL.md\n- skills/co-marketing/SKILL.md\n- skills/cold-email/SKILL.md\n- skills/community-marketing/SKILL.md\n- skills/competitor-alternatives/SKILL.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 marketingskills 的核心服务。\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项目：coreyhaines31/marketingskills\n\n## 官方安装入口\n\n### Node.js / npx · 官方安装入口\n\n```bash\nnpx skills\n```\n\n来源：https://github.com/coreyhaines31/marketingskills#readme\n\n## 来源\n\n- repo: https://github.com/coreyhaines31/marketingskills\n- docs: https://github.com/coreyhaines31/marketingskills#readme\n", "summary": "从项目官方 README 或安装文档提取的开工入口。", "title": "Quick Start / 官方入口" } }, "validation_id": "dval_d436df076e8348609d8f07e74d4f2057" }