Founder Signal OpenClaw 技能

使用该技能，可将经验证的 Reddit 与 V2EX 证据转化为一份轻量、可审阅的信号包，供创始人评估一个或多个已配置产品画像（product profile）所对应的产品需求与市场定位。

Founder Signal 不变量（Invariant）

若未保存经验证的快照，则不执行评分，但**不会跳过公开运行评审（public run review）**。

每次运行必须在后续步骤执行前持久化一个运行目录（run folder），以确保即使发生失败仍能留下可追溯的产物。该技能**仅对已验证的证据进行评分**，且**仅在存在已验证的候选证据时才生成 Action Card**。无论运行成功、无候选结果、部分完成，抑或运行时失败，每个画像（profile）的运行都必须： - 写入 public-run-review.md； - 写入 draft-publish-intent.json； - 并自动尝试执行 Draft 页面创建 → 追加 → 发布流程，以生成该公开安全（public-safe）的评审页。 一次业务运行（business run）失败，仍可能产出成功的 Draft 评审页。若 Draft 发布失败，需保留本地评审产物及明确的发布失败元数据（publish-failure metadata），以便后续重试。所有**在该 Draft 页面之外的公开网页发布行为，均须获得创始人显式确认**。

初始化契约（Setup Contract）

安装完成后，请向创始人索取一份规范的 Founder Signal JSON 配置文件，对其进行校验后，将其导入至内部运行时画像（runtime profile）。除非创始人明确表示需调试技能源码，否则**不应要求其手动编辑包内本地的 profiles/*.json 文件**。已安装的 ClawHub 技能目录属于源代码；可变的运行时数据应存放于 ${FOUNDER_SIGNAL_HOME:-~/.founder-signal} 下（除非显式传入 --root-dir 参数）。

推荐操作流程如下：

1. 共享或填写 founder-signal.config.example.json。
2. 初始化运行时根目录（runtime home）：

python3 -m founder_signal init

3. 校验配置：

python3 -m founder_signal doctor --config founder-signal.config.json

4. 导入配置：

python3 -m founder_signal config import founder-signal.config.json

5. 执行运行：

python3 -m founder_signal run --config founder-signal.config.json

也可使用 Shell 快捷脚本：

bash scripts/run_founder_signal_once.sh --config founder-signal.config.json

规范配置文件必需字段如下：

• profile_id
• product_name
• product_one_liner
• target_audience
• keywords
• scoring_terms
• platforms
• discovery_mode
• max_candidates
• draft.require_confirmation_before_public_publish: true

拒绝在规范配置 JSON 中使用遗留的面向用户字段，例如 subreddits、seed_reddit_urls、excluded_reddit_urls，或任何 draft_publish_command 类型的逃逸机制（escape hatch）。导入步骤将在 /profiles/ 下写入一份内部运行时画像，并在 /config-imports/ 下写入一份标准化的规范副本。

输入项（Inputs）

• 初始化阶段提供的一份规范 Founder Signal 配置 JSON 文件
• 一个或多个已激活并导入的画像，来源为 /profiles/*.json
• 可选的 --profile 参数，用于指定单画像运行
• 来自规范配置中 platforms 对象或已有内部遗留画像的平台配置
• 基于画像所属社区、keywords 及评分关键词（scoring terms）进行的确定性 Reddit/Eddrit 研究发现（research discovery）；发现流程始终先于配置的 Reddit 提示（hints）执行
• 可选的 Reddit discovery_mode: live 模式：使用子版块（subreddit）最新帖源（new feeds），结合发帖时间/评论数过滤与产品关键词匹配
• V2EX 发现方式包括 SOV2EX、搜索、节点最新页（node latest pages）或配置的种子话题（seed topics）；第三方发现仅用于候选者挖掘（candidate-finding only）
• 可选的平台级 excluded_urls 或遗留的 excluded_reddit_urls，用于屏蔽已知的旧候选内容
• history_ttl_days：用于使旧的私有重复候选排除规则过期
• 当 Claw/浏览器代理已人工验证某源帖但自动化抓取被阻断时，可提供可选的 verified_evidence_snapshots

Draft 发布交接（Draft Publish Handoff）

Founder Signal 依赖规范的 draft-cli 技能完成 Draft 公共页面（public-page）发布。默认情况下，每次运行均启用 Draft 交接准备：Founder Signal 将生成 public-run-review.md，并在同级目录下写入 draft-publish-intent.json，且**不硬编码任何自定义或本地 Shell 发布命令**。该意图文件包含以下字段：产物路径、标题、画像标识、Draft 可见性请求，以及：
requires_confirmation: false 和 draft_public_publish_requires_confirmation: false（适用于 draft page create → draft page append → draft page publish 流程）；
同时含 external_public_publish_requires_confirmation: true，用于控制后续在该 Draft 页面之外的任何公开网页发布行为。

当任意测试运行或定时运行写入该意图文件时，代理（agent）必须立即使用工作区（workspace）中已安装的 draft-cli 技能所提供的 draft CLI 工具，依次执行 draft page create、draft page append 与 draft page publish，目标为 public-run-review.md，随后将生成的人类可审阅的 Draft 公共页面 URL 返回给创始人。**在此 Draft 页面步骤之前，不得再次向创始人申请审批**。仅在执行该 Draft 页面之外的独立公开网页发布动作前，才需请求创始人显式确认。

draft-cli 技能是守护进程就绪状态（daemon readiness）、页面创建、追加/补丁（append/patch）行为、公开发布、邀请码（invite codes）及 Draft URL 提取等能力的唯一可信来源（source of truth）。

端到端验证操作手册（E2E Verification Playbook）

当创始人要求执行端到端（E2E）验证运行时，代理必须交付一个 Draft 公共页面 URL，或明确报告 E2E 验证未完成。

1. 启用目标画像。
2. 使用内置的发现阶段（discovery phase），**不得从占位符 URL（placeholder URLs）开始**。
3. 优先尝试标准的 Eddrit 搜索/列表及帖子镜像（post mirror）路径。
4. 若镜像访问被阻断，则通过浏览器/人工方式进行验证，并在画像中添加 verified_evidence_snapshots：

{
  "platform": "reddit",
  "source_url": "https://www.reddit.com/r/ChatGPT/comments/abc123/real_slug/",
  "verification_method": "agent_browser",
  "verified_by": "openclaw-agent",
  "text_snapshot": "在此粘贴代理实际观察到的相关源帖文本。"
}

该快照必须为源帖中的真实原文，**不可虚构内容**。诸如 POST_ID、REAL_ID、SUB、/slug/ 或 V2EX 占位符话题 ID 等无效占位符均禁止使用。Founder Signal 仅在快照已持久化后，才将 verified_read_via_agent_browser 与 verified_read_via_manual_snapshot 视为有效验证读取。

使用以下命令运行 E2E 校验：

python3 -m founder_signal run --config founder-signal.config.json --require-action-card --require-publish-intent

当运行生成 draft-publish-intent.json 后，请检查其 requires_confirmation 字段。若值为 false，请立即调用工作区中已安装的 draft-cli 技能所提供的 draft CLI，依次执行 draft page create、draft page append 与 draft page publish，目标为 public-run-review.md，随后将生成的人类可审阅的 Draft 公共页面 URL 返回给创始人。**仅报告 draft-publish-intent.json 存在，属于不完整交付**。若后续某操作会使该页面在 Draft 页面之外变为公开可访问，则需检查 external_public_publish_requires_confirmation 字段，并在执行该独立公开网页发布动作前，向创始人申请显式批准。

输出项（Outputs）

• runs//run.json
• runs//REPORT.md
• runs//profiles//run.json
• runs//profiles//REPORT.md
• runs//profiles//public-run-review.md —— 每次画像运行均生成，无论成功或失败
• runs//profiles//evidence/
• runs//profiles//outputs/candidates.json
• runs//profiles//selected-candidate.json —— 当选定已验证候选者时生成
• runs//profiles//daily-review.md —— 当生成 Action Card 时生成
• runs//profiles//draft-publish-intent.json —— 每次画像运行均生成（只要已为下游 draft-cli 自动处理准备好 Draft 公共页面发布）
• state/past-candidates.json —— 私有本地候选历史，用于避免后续运行中重复选取相同候选者

上述输出路径均相对于运行时根目录（runtime home），而非已安装的技能包路径。运行时根目录默认为 ${FOUNDER_SIGNAL_HOME:-~/.founder-signal}。

Action Card 应使用 Source platform 与 Source URL 标签，且**不得在面向 Draft 的 Markdown 中暴露私有本地证据路径**。高质量结构化证据可提升 Action Card 质量，但**不能决定卡片是否生成**。若所选候选者已验证、符合条件、未被代理拒绝，且具有可读的已保存文本快照，则即使结构化证据缺失或质量较低，也应生成 daily-review.md。在此回退模式（fallback mode）下，应直接渲染原始快照，并记录 action_card_generation_mode: snapshot_fallback；结构化卡片则记录 action_card_generation_mode: structured。

手动执行命令

python3 -m founder_signal doctor --config founder-signal.config.json
python3 -m founder_signal config import founder-signal.config.json
python3 -m founder_signal run --config founder-signal.config.json
bash scripts/run_founder_signal_once.sh
bash scripts/run_founder_signal_once.sh --profile draft
bash scripts/run_founder_signal_once.sh --config founder-signal.config.json --require-action-card --require-publish-intent

若未指定 --profile，运行器将处理所有已启用的画像。

绑定的运行时载荷（Bundled Runtime Payload）

本发布的技能包包含从已安装技能目录启动运行所需的最小本地运行时载荷：

• scripts/run_founder_signal_once.sh
• src/founder_signal/
• founder-signal.config.example.json
• profiles/README.md
• profiles/draft.example.json

在正式运行前，请创建一份规范配置 JSON，校验其有效性，并完成导入。**无需额外配置 Draft 发布设置文件**；Draft 公共页面发布属于默认流程，每次运行均应自动发布至 Draft，直至生成人类可审阅的 Draft 公共页面 URL，或明确记录一次发布失败。所有在该 Draft 页面之外的公开网页发布行为，仍受确认机制保护（confirmation-gated）。

运行时执行顺序（Runtime Order）

1. 尽早持久化运行目录，随后加载全部已启用画像，或仅加载一个指定画像。
2. 对每个画像，依次运行已启用的平台适配器（platform adapters），跳过画像级排除规则（profile exclusions）与过往本地候选历史（previous local candidate history），在截断（capping）前完成；再考虑已配置的提示（hints）与已验证快照回退（verified snapshot fallback）。
3. 捕获并记录业务运行失败（business-run failures），使用公开安全（public-safe）的失败字段，而非在最终化（finalization）前提前返回。
4. 在镜像或已验证快照回退可用时保存证据，强制执行“已验证读取”闸门（verified-read gate），**仅对已验证候选者评分**，并可选地生成 Action Card。
5. 始终写入 public-run-review.md 与 draft-publish-intent.json。
6. 始终尝试自动执行 draft page create → draft page append → draft page publish，以完成本次公开运行评审。
7. 持久化最终产物，其中业务失败与 Draft 发布失败需分别表示，并在任何后续的该 Draft 页面之外的公开网页发布前，明确要求确认。

Eddrit 搜索/列表与帖子镜像页构成 Reddit 的读取层（read layer）。V2EX 发现提供方（discovery providers）**永远不可作为已验证证据源**；已验证的 V2EX 读取必须使用原始 https://www.v2ex.com/t/ 话题 URL，或未来官方 API 读取。当自动化读取被阻断时，浏览器/人工回退仍是一条有效的已验证快照路径。