全部技能 / 文档与知识 / competitive-teardown
文档与知识 · nexu-io/html-anything

competitive-teardown

定位图 + 功能矩阵 + 价格对比 + 机会窗口, 把竞品资料转成产品决策报告

风险提醒:绿色 · 放心使用AI 侦查报告
作者 nexu-ioGitHub nexu-io/html-anything ↗Stars 8827许可 Apache-2.0(仓库根 LICENSE:Apache License Version 2.0, January 2004;GitHub API spdx_id=Apache-2.0)commit 553ed98c28
agent 宿主通常会约束 skill 执行权限;风险提醒为 AI 侦查观点,不构成质量或安全保证。第三方 skill 仅作拆解与展示,安装使用风险自负,版权归原作者。

1实现原理 · 为什么它能做到

模板本体没有可执行代码:loader 从 src/lib/templates/skills/<id>/SKILL.md 读入 frontmatter 与正文,正文(body)与 example 内容一起作为 LoadedSkill 返回。

next/src/lib/templates/loader.ts
const raw = safeRead(path.join(dir, "SKILL.md"));
注:这里在做什么:SKILL.md 是唯一行为来源——frontmatter 供选择器渲染(zh_name/emoji/aspect_hint/tags/example_* 等),正文整段即提示词;loader 不做语义校验,模板写什么就下发什么。

下发前宿主固定拼装 prompt:模板正文夹在共享设计指令 SHARED_DESIGN_DIRECTIVES 与【输入格式】/【用户内容】之间。

next/src/lib/templates/shared.ts
Wrap a per-template instruction body with the shared design directives and
注:这里在做什么:模板只定义「这一个交付物长什么样」(版式/节奏/组件),共享指令承担跨模板硬约束——单文件 HTML、禁止用文件工具、Tailwind 与 Google Fonts 走 CDN、内容真实性、中文盘古之白。

共享指令把硬约束写成对 agent 的显式禁令,并强制内容驱动数量(模板里的数字只作参考下限)。

next/src/lib/templates/shared.ts
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。
注:同文件下文还有一条:输出的 slide / frame / card / section 数量完全由【用户内容】的实际长度和信息结构决定——这解释了为什么本类模板不因内容变长而失效:每段内容至少一张卡/一节,模板只提供版面池。

真正执行的是用户本机已安装并登录的编码 agent CLI:宿主 spawn 子进程,把 prompt 交给它,HTML 从 stdout 流式捕获。

next/src/lib/agents/invoke.ts
import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
注:这里在做什么:模板 skill 只提供提示词,能力(含写代码、跑工具)来自宿主 CLI 的既有权限;skill 目录自身没有任何脚本入口,因此判级只看目录内资产(宿主行为不计档)。

/api/convert 是模板的执行路径:它把 skill.body 与用户内容组装成 prompt 后交给 invokeAgent。

next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
注:编辑模式另走 buildEditPrompt(最小化差异编辑,禁用文件工具、要求直接流式输出完整 HTML),因此本类模板的产物形态稳定:单文件 HTML、内联 CSS/SVG,外链仅字体与个别模板显式要求的图表库。

模板的核心是九段固定结构:从 Header、Executive takeaway、Positioning map 一直到 30/90/180 天 Recommended moves,缺段即不合格。

next/src/lib/templates/skills/competitive-teardown/SKILL.md
【必须输出的结构】
注:这里在做什么:把竞品分析从开放式写作变成填空式报告,每段都有硬性内容要求(如 Executive takeaway 恰好 3 条、每条必须含 so what)。

定位图与功能矩阵被规定为从用户内容生成而非套模板词:坐标轴必须来自素材,矩阵列含 Us / Opportunity,用 ✓/△/— 表达覆盖度。

next/src/lib/templates/skills/competitive-teardown/SKILL.md
3. Positioning map: 用 2×2 象限或坐标图表现竞品定位。坐标轴必须来自用户内容, 不要套模板词。
注:同段第 5 条规定矩阵行是关键能力、列是竞品 + Us / Opportunity,并要求用短注释说明——矩阵不是勾选表,而是决策表。

每个竞品一张卡,字段固定为 target user / core promise / pricing signal / primary strength / visible weakness;机会窗口固定含 why now、target segment、first move、risk。

next/src/lib/templates/skills/competitive-teardown/SKILL.md
8. Opportunity windows: 3 个机会窗口, 每个包含 why now、target segment、first move、risk。
注:字段固定带来跨报告可比性:不同次的拆解可用同一张表横向阅读;「3 个机会窗口」是数量下界,配 30/90/180 三档行动建议。

有独立的内容真实性章节:只使用用户提供的资料、缺失信息标注 not found in source / unknown、禁止发明市场份额/ARR/客户名/定价,资料不足也要在 Evidence gaps 列缺口。

next/src/lib/templates/skills/competitive-teardown/SKILL.md
- 只使用用户提供的竞品、价格、功能、评论。缺失信息用 "not found in source" 或 "unknown" 标注。
注:这条是本模板最重要的纪律:把「不许编数」写成可检查的输出约定(矩阵里即出现 unknown / not found 字样),而不是笼统的不要幻觉。

风格三选一由 assets/ 里的三份参考 HTML 提供(war-room-grid 默认、radar-map 深色情报台、analyst-dossier 纸质投研档案),并要求按输入特征择一,不得混用。

next/src/lib/templates/skills/competitive-teardown/SKILL.md
- `assets/war-room-grid.html`: 默认风格。浅色战情室 / 咨询报告, 适合产品团队、PM、普通商业读者。
注:这里在做什么:把战略咨询观感具体化为三套已实现的样式样板(各 44-82 行 HTML),agent 可照抄变量与组件而非从零发明;这也是本批唯一带内部 assets 的模板(本地文件,读取不外发)。

2核心能力

01九段固定报告结构(header / takeaway / positioning / cards / matrix / pricing / UX / opportunities / moves)
02Executive takeaway:恰好 3 条判断且每条含 so what
03功能矩阵(行=关键能力,列=竞品 + Us/Opportunity,✓/△/— 覆盖度 + 短注释)
04价格/包装解读段(层级、试用、限制项、企业销售动作)
05三套可选视觉风格(war-room-grid / radar-map / analyst-dossier),默认 war-room-grid
06内容真实性纪律(缺失标注 unknown / not found in source、禁止发明数字、资料不足仍出报告并列 Evidence gaps)
07单竞品降级路径(只给一个竞品时输出 deep dive)

4风险提醒 风险提醒:绿色 · 放心使用

风险提醒:绿色 · 放心使用
  • 示例覆盖度低于模板要求 — 示例未独立呈现 Pricing / UX notes / Opportunity windows 三段;用户若以示例为验收基准,可能得到比 SKILL.md 要求更薄的报告,需以指令为准。
  • 输入质量决定结论可靠性 — 模板禁止编造但无法核实用户素材真伪;若用户贴入的定价/评价本身过时或错误,报告会把错误结构化输出(矩阵只标 unknown,不会纠错)。
  • 用户内容逐字进 prompt 的注入面(本批最接近外部内容摄入的模板) — 宿主装配层直接插值用户内容,而本模板的输入常是竞品官网摘录、用户评论等第三方文本;粘贴文本中的指令性语句可影响生成结果。产物为本地 HTML 报告,危害限于报告内容。
  • 预览同源沙箱(宿主行为) — preview-pane.tsx:297 / template-picker.tsx:544 使用 sandbox="allow-scripts allow-same-origin";本模板产物除 Tailwind CDN 无自定义脚本。
风险提醒:绿色,放心使用。判级只依据 skill 自身目录(仅 SKILL.md + example.html + example.md + assets/ 三份样式参考 HTML,无脚本入口(assets 与 example 内各有一条 Tailwind CDN <script> 引用)、无自带 CLI、无凭证读取、无写盘):无脚本入口、无自带 CLI、无凭证读取、无写盘指令;SKILL.md 正文未要求运行时引入任何外部端点(三套风格以本地 assets/ 文件给出;SKILL.md 只规定版式与内容结构)。执行期不发生任何外发。目录内实际出现的端点仅存在于 assets/*.html 与 example.html 里的 cdn.tailwindcss.com、fonts.googleapis.com/gstatic(样式参考与产物示例的浏览器端取用),按批4 终版口径属**产物期引用**(生成的 HTML 由浏览器打开时拉取 CDN/字体,skill 执行时不抓取、不上报、不传素材),故不判级,仅在此列出端点;宿主壳(loader→assemblePrompt→本地 agent CLI spawn、预览 iframe sandbox)同属宿主行为,记入 verdict.risks。

5第二遍独立确认

  • [discrepancy] 九段结构在示例中的覆盖度 — example.html 展示了 Header、Executive takeaway(3 条)、Positioning map、3 张竞品卡、Feature matrix(含 not found / unknown 单元格)、30/90/180 天 moves;但第 6 段 Pricing / packaging read 与第 7 段 UX / messaging notes 未独立成节,第 8 段 Opportunity windows 亦未以独立小节出现(部分内容并入卡片与矩阵注释)。模板能力以 SKILL.md 为准,示例属精简演示。
  • [ok] 内容真实性纪律的可见落地 — 矩阵中逐字出现 unknown(Transcript library 行)与 not found(CRM / sales workflow、Cross-interview insight cards 行),与 SKILL.md 要求的标注词一致,证明该纪律可被执行。
  • [ok] 三套 assets 是否为真实不同风格 — war-room-grid:浅色 --paper:#f7f4ec + Inter;radar-map:深色 panel rgba(13,27,45,.76) + 径向雷达网格 repeating-radial-gradient;analyst-dossier:双线规则 .rule + 红色 stamp 旋转 -2deg + IBM Plex Serif 衬线。三份互不相同的实现坐实风格三选一。
  • [ok] 端点与判级 — SKILL.md 正文无 URL/端点要求;端点只出现在 assets 与 example 的 cdn.tailwindcss.com <script> 及字体链接,属产物期引用层,执行期零外发,维持 green。
  • [ok] license / stars / commit 元数据 — GitHub API(api.github.com/repos/nexu-io/html-anything):spdx_id=Apache-2.0、stargazers_count=8827、pushed_at=2026-09-15T03:36:24Z;工作副本 git HEAD = 553ed98c283f9c0f489902d035416a972d6a9699(与任务表 pin 553ed98c283f 同源)。
  • [ok] skill.path 与目录资产面 — pin 目录内该路径存在且含 SKILL.md;目录内文件清单已用 glob 全量核对(含隐藏文件),无 scripts/、无 references/、无二进制资产(competitive-teardown 的 assets/ 为纯 HTML,另行记录)。

6结论

  • 结构即质量:九段固定骨架(含数量与字段要求)把开放式竞品分析变成可交付、可开会讨论的报告。
  • 反幻觉纪律写在模板里且可检查(unknown / not found in source、禁止发明 ARR/定价/客户名、资料不足列 Evidence gaps)。
  • 设计侧给了三套已实现的风格参考(浅色战情室 / 深色雷达台 / 纸质档案)并规定按输入择一,观感一致性与选择自由度兼顾。
  • 降级路径明确:2-6 个竞品最佳、单竞品转 deep dive,不因输入规模不足而拒绝交付。
  • 矩阵以 Us / Opportunity 列把竞品信息直接导向我方决策,避免报告停在描述层。
  • 适合:适合产品/战略团队把零散竞品资料(官网、定价页、changelog、评论、销售反馈)转成一份可决策的拆解报告;也适合投研/行业分析的初步结构化(analyst-dossier 风格)。2-6 个竞品且有 pricing/功能/评价信息时效果最好。
    不适合:不适合营销物料或普通文章(SKILL.md 明文排除);不适合无任何竞品素材、期望模型自行上网调研的场景(模板只消费用户提供的资料);不适合需要严格引用来源页码的合规报告(模板不产引用编号)。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-15
    方式 A · 人下载镜像包下载 competitive-teardown.tar.gz
    sha256: 99cee63fe9181008…
    方式 B · JSON 格式安装指南,复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub?直接去上游安装(实时版,可能已更新)GitHub 原始 ↗
    本页镜像锁定 commit 553ed98c28;上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库nexu-io / nexu-io/html-anything
    Stars8827
    最近推送2026-09-15
    本 skill commit553ed98c28
    许可Apache-2.0(仓库根 LICENSE:Apache License Version 2.0, January 2004;GitHub API spdx_id=Apache-2.0)
    本站信息
    收录日期2026-09-06
    分类文档与知识
    侦查报告AI 侦查 · 2 遍 · 2026-09-06
    本站镜像与 GitHub 原始是不同来源:本站锁定 commit 快照经 /r2 分发;GitHub 为实时上游,内容可能已更新。
    同分类邻近