Ciuunkos/技能

商业想法验证器

用法：/business-idea-validator <想法文本或文件路径> [--lang en|pl] [--quick] [--out <目录>]

对一个商业想法按照十个评分标准进行评分，应用固定判断规则，并生成报告。判断基于评分及其推理过程；判断结果是评分经过算术运算得出的，确保两个想法得到相同的处理方式，并且读者可以手动检查。

从用户选择的工作目录运行（--out <目录>，默认为当前目录）。切勿写入此技能的文件夹。

你将使用的文件

• references/rubrics/01-problem.md … 10-risks.md：每个评分标准一个文件。阅读你正在评分的那个文件。
• references/report-style.md：写作规则。在任何评分前先阅读一次。
• references/intake.md：何时首先向创始人提问。
• references/verdict.md：规则说明，供你理解；代码位于 scripts/verdict.mjs。
• assets/rubric-output.schema.json：单次评分传递返回的精确JSON格式。
• assets/report.schema.json：完整报告的格式。
• assets/examples/fieldnote/：一个完整示例（虚构的想法），包含 idea.md、report.json、report.md。
• scripts/check.mjs：验证、计算判断结果、渲染Markdown。${CLAUDE_SKILL_DIR} 指向Claude Code中此技能所在的文件夹；在其他环境中，请使用安装此技能的路径。

步骤

1. 信息收集

从参数、提示或文件路径中获取想法。确定报告语言：默认为想法文本的语言，除非通过 --lang 指定。

应用 references/intake.md。如果文本内容薄弱（少于约40个单词，或缺少目标用户、具体功能或盈利方式），向创始人一次性提出最多五个问题，并等待回复。如果无法提问（非交互式，或使用了 --quick），则基于假设继续，并在 synthesis.notes 中说明。

将已获取的信息存储为 idea.text 和 idea.answers（包含 for、money、today、advantage、stage；仅存储已提供的字段）。

2. 评估十个评分标准

首先阅读 references/report-style.md。然后按以下顺序评估每个评分标准：问题、客户、市场、替代方案、变现、分销、可行性、防御性、创始人匹配、风险。

• 向单次评分传递提供：想法文本、答案、评分标准文件、样式规则和输出模式。
• 单次评分传递返回一个与 assets/rubric-output.schema.json 匹配的JSON对象：id、score 1至5、confidence 低/中/高、evidence（直接引用）、assumptions、reasoning（最多160个单词）、questions、improve。

如果Agent工具可用，通过 business-idea-rubric 子代理并行运行评分传递（每个评分标准一个Agent，向其提供文件路径和想法；要求其仅返回JSON）。否则，自行逐个评分，每次评分时重新读取评分标准文件，以便锚点始终在你眼前。

创建 <out>/rubrics/ 文件夹，并在进行过程中将十个结果保存为 <id>.json 文件。验证每个结果：运行 node ${CLAUDE_SKILL_DIR}/scripts/check.mjs --rubric <out>/rubrics/<id>.json。在继续之前修复它报告的任何问题（通常是列表过长或 reasoning 超过120个单词）。

3. 批评性审查

如果使用 --quick，则跳过此步骤。否则，向 business-idea-critic 子代理（或自行处理）提供所有十个结果、想法以及评分标准文件。其任务是：尝试使用分值锚点和文本反驳每个评分为1、2或5的理由，并标记任何信心等级与评分稳定性不匹配的评分标准。它返回一个 { "changes": [{ "id", "from", "to", "confidence", "why" }], "notes": "" } 对象，其中 confidence 为 same 或新的等级；why 和 notes 使用报告语言。将每个更改应用到评分结果：设置新的分数和信心等级，并重写该评分标准的 reasoning，使其为新分数提供论证（结果不得自相矛盾）。保留批评对象用于报告。

4. 综合分析

根据最终评分，编写综合分析对象（参见 assets/report.schema.json 中的 synthesis）：summary（三句话）、riskiestAssumption（一个）、experiments（一到三个，最长14天，每个包含一个数字指标）、pivots（仅真实存在的；可以为空）、openQuestions（从各评分标准的问题中去除重复，按重要性排序，最多八个）、notes（在必要时说明报告是如何生成的，否则为空）。遵循 references/report-style.md 中的综合分析规则。

5. 组装与渲染

编写 <out>/report.json 文件，包含 version: "1"、lang、idea、rubrics（全部十个）、critic（如果执行过）、synthesis、verdict: {}（由脚本填充；切勿手动编写判断结果）、meta（model：你运行时所知的模型名称，createdAt：ISO日期，generator："skill"）。

运行 node ${CLAUDE_SKILL_DIR}/scripts/check.mjs <out>/report.json。它将验证所有内容，将判断结果写入文件，并生成 <out>/report.md。修复问题直到输出 OK。

6. 交付结果

告知用户：判断结果及其产生该结果的规则、最危险的假设、第一个实验，以及两个文件的位置。保持在十行以内；完整的报告包含其余信息。不要在对话中复述评分表。

覆盖上述所有内容的规则

• 在 evidence 中必须直接引用，不得转述。任何不在文本中的内容都是假设，必须标明。
• 禁止虚构数字。市场规模和价格必须采用“假设……，范围在……”的形式。
• 判断结果来自 scripts/check.mjs。切勿手动编写，也切勿在报告中对其进行争论；如果看起来有误，则是评分有误，请附上理由修正评分。
• 报告语言遵循想法文本的语言（或 --lang 指定的语言）。JSON键保持英文。
• 风格：短句，不包含破折号，不夸大宣传，不使用“不仅是X，更是Y”等句式。