planners-quali-box
面向社媒笔记、评论、搜索词、开放题、访谈摘录、品牌与竞品内容的定性分析工具箱。
先检查数据结构与证据能力,向用户说明推荐方法、方法步骤、预期信息和边界并取得确认,再在消费者洞察、情感定位、沟通策略、品类颠覆、文化结构、消费任务与价值链、品牌关系或品牌社群路线中选择一个主方法,按需加载最多两个辅助镜头,交付来源清楚、可追溯的 Markdown 分析报告与单文件 HTML。
适用于用户要求从不同规模、结构和证据角色的材料中选择合适方法、提炼洞察、比较品牌或形成策略判断;不要求用户预先懂方法或替模型做路由。
含まれるファイル(86)
- SKILL.md20.7 KB
- .gitignore477 B
- agents/openai.yaml365 B
- assets/methods/brand-community.html1.9 KB
- assets/methods/brand-relationship.html1.7 KB
- assets/methods/gwtb.html1.8 KB
- assets/methods/jobs-value-chain.html1.7 KB
- assets/methods/levi-strauss.html2.0 KB
- assets/methods/needscope.html2.9 KB
- assets/methods/ogilvy.html1.7 KB
- assets/methods/tbwa.html1.6 KB
- assets/report-shell.html11.4 KB
- assets/report-style-guide.md5.3 KB
- assets/report-template.md2.6 KB
- CHANGELOG.md4.3 KB
- COMMERCIAL.md470 B
- evals/datasets/README.md694 B
- evals/datasets/synthetic_bistro_comments.csv2.6 KB
- evals/datasets/synthetic_campaign_comments.csv3.0 KB
- evals/datasets/synthetic_gwtb_aster_official.csv1.3 KB
- evals/datasets/synthetic_gwtb_kairo_mixed.csv1.4 KB
- evals/datasets/synthetic_gwtb_northpath_official.csv1.3 KB
- evals/datasets/synthetic_needscope_comments.csv2.3 KB
- evals/datasets/synthetic_routing_comments.csv1.9 KB
- evals/evals.json2.3 KB
- evals/fixtures/claim-ledger.json557 B
- evals/fixtures/corpus-config.json334 B
- evals/fixtures/corpus-sample.csv217 B
- evals/fixtures/evidence-index.json871 B
- evals/fixtures/metrics-ledger.json956 B
- evals/fixtures/report-data.json2.3 KB
- evals/prompts/00-test-routing.md692 B
- evals/prompts/01-test-ogilvy.md707 B
- evals/prompts/02-test-needscope.md741 B
- evals/prompts/03-test-gwtb.md754 B
- evals/prompts/04-test-tbwa.md580 B
- evals/prompts/05-test-levistrauss.md711 B
- evals/prompts/06-test-jobs-value-chain.md401 B
- evals/prompts/07-test-brand-relationship.md380 B
- evals/prompts/08-test-brand-community.md420 B
- evals/rubric.md4.5 KB
- evals/runbook.md4.3 KB
- LICENSE33.7 KB
- NOTICE527 B
- README.md7.6 KB
- references/00-skill-system-map.md3.1 KB
- references/01-ogilvy.md3.5 KB
- references/02-needscope.md6.0 KB
- references/03-gwtb.md3.6 KB
- references/04-tbwa.md2.7 KB
- references/05-levistrauss.md3.1 KB
- references/06-script-routing.md3.2 KB
- references/07-needscope-sources.md5.7 KB
- references/08-jobs-value-chain.md3.7 KB
- references/09-brand-relationship.md3.0 KB
- references/10-brand-community.md2.9 KB
- references/11-auxiliary-lenses.md3.0 KB
- references/12-netnographic-conduct.md2.3 KB
- references/13-method-sources.md2.3 KB
- RELEASE_CHECKLIST.md1.6 KB
- scripts/deepen.py2.4 KB
- scripts/extract_wordfreq.py8.5 KB
- scripts/lib/planners-modules-install.mjs17.6 KB
- scripts/lib/planners-modules-install.test.mjs16.7 KB
- scripts/lib/planners-modules.mjs5.2 KB
- scripts/phase1_analyze.py9.3 KB
- scripts/prepare_corpus.mjs9.1 KB
- scripts/preprocess_comments.py24.5 KB
- scripts/render_report.mjs1.7 KB
- scripts/requirements-ogilvy.txt101 B
- scripts/review_report.mjs4.6 KB
- scripts/test_evidence_pipeline.mjs4.4 KB
- scripts/test_no_review_surface.mjs6.8 KB
- scripts/validate_evidence.mjs814 B
- scripts/validate_run.mjs8.3 KB
- scripts/validation-core.mjs7.3 KB
- SECURITY.md1.1 KB
- stages/00-route-and-corpus.md4.5 KB
- stages/01-research-design.md3.8 KB
- stages/02-calibration.md2.0 KB
- stages/03-full-analysis.md2.0 KB
- stages/04-claim-audit.md4.2 KB
- stages/05-report-and-review.md2.8 KB
- stages/06-deliver-and-learn.md1.1 KB
- THIRD_PARTY_NOTICES.md1.2 KB
- TRADEMARK.md638 B
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Planners Quali Box
来源识别:Planners Quali Box 由阿祖不看 TVC 创建与维护。小红书同名账号,个人网站 https://demyth.info,联系邮箱 Lawyif@163.com。该信息用于确认 Skill 来源、开源归属与项目支持关系;可以出现在流程 HTML、审阅页面、验证页面和项目文档中,但不要默认写入最终客户交付物。
把八种主方法放在同一入口,并按需调用辅助镜头与数字场域研究规范;不把它们压成同一套算法、综合评分或同一种报告。
三层系统
- Project Grounding:当次研究的原始输入、收集情境、格式化读取结果、语料全景、稳定
source_id、编码/分析中间产物、用户真实决定和主张账本。派生文件不能冒充原始事实,模型工作假设不能冒充用户确认。 - Method System:八种主方法、辅助镜头、研究规范的概念、判断框架、专属 Gate 与权威来源,保存在
references/。Canonical Method 与运行经验分开;方法知识不能覆盖当次原始材料。 - Work Pipeline:从路由、研究设计、校准、全量分析、主张审计到报告与学习的阶段,保存在
stages/。
这里没有强制所有项目共用一种证据单位。分析单位可以是笔记、评论、搜索词、账号内容、开放题回答、访谈段落或文档片段;不变量是能从结论回到原始语境、输入产生方式和必要的转换步骤。
总流程
问题 + 原始材料
→ 原生格式读取、权威与语料全景
→ 问题适配 × 证据适配路由(1 个主方法;默认 0 个、通常最多 1 个辅助镜头)
→ 向用户说明分析方案并取得确认
→ 一次性规范化语料、生成稳定 source_id 与覆盖账本
→ 研究设计与证据角色
→ 小样本校准(必要时)
→ 方法专属全量分析
→ Claim → Evidence / Counter-evidence 逆向审计
→ report.md + report.html
→ 项目经验与通用方法分级沉淀
不要在没有数据时假装完成分析。先说明能回答什么、不能回答什么,以及还需要什么。
路由:问题适配 × 证据适配
不要让用户预先选择方法。先读取字段、少量异质原文和收集情境,再同时判断:
- 问题适配:用户最终要理解、比较或决定什么;
- 证据适配:当前材料是否包含该方法所需的对象、角色、时间、对照和语境;
- 推断距离:结论需要跨越多少层从“文本说了什么”推到“人、品牌、品类或文化意味着什么”。
| 候选方法 | 问题适配 | 最低证据条件 | 不足时的处理 |
|---|---|---|---|
| Ogilvy | 消费者深层动机与文化张力 | 有足够消费者表达及其语境,可区分重复与独立声音 | 止于话题/动机诊断,不强行形成 L3/L4 |
| NeedScope | 品牌情感空间与定位差距 | 有品牌对象相关的情感/关系表达;目标位置另需 Brief 或品牌证据 | 只画当前感知或意图,不虚构目标迁移 |
| GWTB | 品牌沟通策略 | GET/TO/BY 需要可归属的品牌传播,WHO 需要受众证据 | 缺官方材料时标“传播推断”或改做内容差异诊断 |
| TBWA | 品类惯例与颠覆机会 | 有跨材料复现的惯例、疲劳/绕行及品牌资格线索 | 只交付惯例与摩擦诊断,不把单条抱怨升级为机会 |
| Levi-Strauss | 文化对立、转换与趋势假设 | 两极、跨来源复现、中介/边界移动,最好有时间或群体差异 | 只交付候选结构,不进入趋势推演 |
| 消费任务与价值链 | 使用情境、待完成任务、期望结果及 A-C-V 价值链 | 有场景、行动、结果与原因;完整 Laddering 另需逐层追问轨迹 | 只交付 job/value-chain 假设,不冒充 Laddering 或 ODI 测量 |
| 品牌关系 | 消费者—品牌关系形态、维持、破裂与修复 | 有第一人称经历、重复/时间互动或关键关系事件 | 只交付关系信号,不补齐 BRQ 六构面或合成总分 |
| 品牌社群 | 成员关系、共同意识、仪式传统与道德责任 | 有成员—成员互动、社群语境,最好有用户、回复链与时间 | 只交付社群信号,不把平铺好评当社群 |
在 corpus-profile.md 记录候选方法、问题适配、证据适配、缺口和最终取舍。若用户点名方法,也要检查证据条件;条件不足时说明降级,而不是伪造完整流程。
除 CP0 必须进行的方案确认外,只有缺少的业务用途或对象边界会实质改变研究时,才额外问一个澄清问题,例如:
这份分析最终是用于理解消费者,还是决定某个品牌接下来如何沟通?
数据文件名、标签与正文语义冲突时,先展示冲突证据并询问研究对象;没有真实回复时写“工作假设”,不得写“经用户确认”。
默认只选择一个主方法,且不加辅助镜头。只有某个局部问题会改变决策、主方法无法回答且当前证据足够时,才增加一个辅助镜头并在 CP0 中确认。第二个辅助镜头是例外:必须说明它会独立改变哪个判断或验证动作;否则不加载。若两个主方法都必要,先分别完成,再写一页跨报告对照;不得混用概念或合并评分。
| 辅助镜头 | 使用信号 | 不能做什么 |
|---|---|---|
| 隐喻与符号表达 | 反复出现的比喻、视觉、物件或文化代码 | 无完整图像引出访谈时不得称 ZMET |
| 区别性资产/品类入口候选 | 品牌 cue、包装、声音、口号或使用触发情境 | 不测 Fame、Uniqueness、mental availability 或 Salience |
| 品牌人格候选词 | 明确的人格化品牌判断 | 不从词频生成五维分数,不与 NeedScope/十二原型混用 |
| 品牌资产定性桥接 | 需要把定性发现转成后续量化假设 | 不输出 MDS、BAV、BVC 或品牌价值分数 |
材料来自线上场域时读取 references/12-netnographic-conduct.md。这是一套场域、语境与伦理规范,不是额外主方法;抓取公开内容不能被称为完整网络志。
分析启动确认(CP0)
Stage 0 的最低限度体检完成后,必须先向用户提交一份简洁的分析方案,不能直接进入正式分析。方案包含:
- 数据结构:文件/工作表、格式、逻辑记录数、分析单位、关键字段、证据角色、主要质量问题与缺口;
- 推荐方法:模型推荐的方法、为什么适配当前问题与数据,以及明显不适合的方法;
- 方法步骤:用非术语化语言说明将如何抽样/校准、分析、反证和形成结论;
- 预期信息:预计能得到哪些层级的洞察、比较或建议,以及这份数据不能回答什么;
- 待确认范围:研究对象、时间/品牌/人群边界、是否采用推荐的一个主方法、是否调用必要的单一辅助镜头及必要工作假设。第二个镜头属于需单独说明价值的例外。
最后明确询问用户是否按该方案开始。得到真实、明确的确认或修改意见前,停止在 CP0:不得做全量编码、聚类、方法专属推理、最终主张或报告。用户点名某个方法也不能替代确认;模型仍需说明该方法是否适配。只有用户当前消息已经明确确认了这份具体方案时才可继续,泛化的“直接做”不能被追认为方案确认。
把确认状态写入 corpus-profile.md:awaiting_confirmation / approved / revision_requested,并记录用户确认的研究问题、方法、范围和关键假设。不得代替用户写“已确认”。
这条门槛不做机器校验,是有意的(与 planners-quanti-box 同一条裁定):CP0 是人的决定,不是机器的状态。corpus-profile.md 里的 confirmation_status 是给流程排序用的记录,不是批准的证据 —— 机器能验的只有"某个字符串非空",那既不能证明批准发生过,也会逼模型写一份看起来像证据的东西。所以:
- 谁读它:模型自己在进 Stage 1 前读(SKILL.md 的「执行阶段」第 2 条);写稿与报告阶段读它判断本版算不算数;
- 谁不读它:
scripts/validate_run.mjs不读、也不该读(它管的是证据、主张、数字与报告契约); - 不做:不落哈希绑定、不生成第二份确认记录、不上公共审阅缝。
执行阶段
依次完整读取并执行:
stages/00-route-and-corpus.md:确定研究问题、方法与语料边界,提交分析方案并等待用户确认,建立corpus-profile.md。- 只有 Stage 0 状态为
approved后,才执行stages/01-research-design.md:定义证据角色、分析单位与抽样;对 CSV/TSV/JSON 优先运行scripts/prepare_corpus.mjs,一次生成normalized-corpus.jsonl、稳定source_id和source-index.json(契约在公共件planners-source-index)。 stages/02-calibration.md:语义编码、分类或大语料任务先用异质小样本校准;纯文本细读可说明理由后跳过。- 加载且只加载所选主方法 Reference、已确认的辅助镜头;线上场域另加载研究规范,再执行
stages/03-full-analysis.md。 stages/04-claim-audit.md:把候选解释整理为evidence-index.json与claim-ledger.json;所有报告数字进入metrics-ledger.json。stages/05-report-and-review.md:只从通过审计的主张写 Markdown,用scripts/render_report.mjs组装 HTML,再用scripts/validate_run.mjs完成唯一一次机械校验。stages/06-deliver-and-learn.md:交付、复盘,并区分项目经验与可升级方法知识。
预处理不是共享算法
共享的是原生格式读取、输入检查和证据追溯,不是聚类方法。记录的“条数”必须是格式解析后的逻辑记录数;物理行、分页或视觉换行不能直接当记录。只有原生解析失败、字段错位或结构不变量被破坏时才可称为损坏,并保留原始输入与转换说明。
八种方法的专属处理策略各自住在自己的 Reference 里(references/01-ogilvy.md … references/10-brand-community.md),本页不复述:一个项目只跑一个主方法,所以只读那一个。共同结论只有一条 —— 聚类不是共享算法,谁都不许用它替代方法专属的证据组织。
脚本路线见 references/06-script-routing.md。运行文件必须写入当前任务的输出目录,不得写回 Skill 安装目录。
统一审阅契约
每个关键结论必须让读者看见以下内容:
- Claim:一句可反驳的判断,而不是主题标签。
- Evidence:至少两条带来源 ID 的原音或内容证据;重要结论尽量跨来源验证。
- Counter-evidence:不支持、相反或构成边界的材料。
- Confidence:只使用高/中/低,并解释来自样本覆盖、来源一致性还是推断距离;限定语写入理由或边界,不另造“中高”等等级。
- Boundary:这份数据不能代表什么,不把互动量当总体占比。
证据身份与证据用途分开记录:actor_identity 表示谁在说,identity_status 使用 verified / inferred / unknown,evidence_role 表示这段材料在当前主张中能证明什么。品牌语气、昵称、标签或商业风格不能把 inferred/unknown 升格为 verified;同一材料可以证明传播表达存在,但不能因此证明品牌内部意图或消费者真实感知。
低频信号可以有高解释力,但升级为主洞察前必须检查独立来源、跨语境复现、与研究问题的相关性和竞争解释。只靠少量显式关键词的宏大解释应标为假设或次级信号。
原文引用保持原意,删除个人信息;统计结果注明分母。推断与事实必须在视觉和文字上分开。
scripts/validate_run.mjs RUN_DIRECTORY 是唯一正式完成校验:一次检查证据 schema、证据到规范化语料的回源、主张引用闭环、数字账本、互斥分类合计、报告存在性、HTML 占位符和基本离线契约。validate_evidence.mjs 只是旧命令的兼容入口,共用同一核心;不得另写“等价”校验器或用其替代完成校验。Validator 不证明解释正确,语义成立仍由 Stage 4 的人机审阅和方法专属 Gate 决定。
Markdown 与 HTML 交付
必须同时交付:
report.md:完整、可继续编辑的分析底稿。使用assets/report-template.md,包含详细数据来源、结论、建议、方法分析、证据索引和限制。report.html:面向阅读与决策的单文件页面。CSS、SVG、导航与必要交互均内联,不依赖 CDN。
两份报告使用同一组结论、统计数字和 source_id;HTML 不能出现 Markdown 中没有依据的新结论。
统一顺序:
- 先看答案:一句短回答、3–5 条单句结论、1–3 条单句建议和一行整体边界;不在摘要堆原音、source_id、长推理或完整数据账目;
- 数据来源:原始来源、样本账目、字段、时间、清洗、证据角色与数据缺口;
- 方法分析:展示该方法专属主图、推理过程、证据与反证;
- 附录:方法参数、来源索引、限制与下一步。
读者面前不出现机器的账目。 正文引用一律用短 handle(A9、N16)或一句可读描述("某品牌官方号·赛事嘉宾笔记下的最高赞评论");comment_id / note_id 这类原始定位符、写稿脚本的文件名(如 phase1_analyze.py)、*.jsonl / *.csv 文件名只出现在附录,并且在 HTML 里默认折叠,不铺在阅读流里。溯源能力不受影响——附录仍然能回源到每一行,只是不再把回源路径印在正文上。判断标准:把正文单独截出来给客户看,里面不该有任何他无法理解的字符串。
- 先用本 Skill 自己的
assets/report-shell.html取得页眉、证据卡、置信度、反证、来源抽屉和打印样式(装配管线是公共的,骨架是本 Skill 的 —— 八种方法的视觉隐喻不可互换)。 - 再加载对应的
assets/methods/*.html,采用主方法自己的信息结构和视觉隐喻;辅助镜头进入正文证据区,不另起一套总报告。 - 替换所有
{{PLACEHOLDER}};不允许把占位文本交给用户。 - 保留可隐藏导航;导航打开/收起均不遮挡正文,移动端默认收起。
- 固定显示作者水印“阿祖不看 TVC · demyth.info”,不得被方法模块覆盖;打印版同样保留轻水印。
- 先运行
validate_run.mjs,再优先运行review_report.mjs,在一次浏览器会话中生成桌面、390px、打印和 DOM 检查的最小批次。默认只做一次视觉模型目检;只有这一次发现具体异常时才针对异常重截,不做多轮无目标复查。 - HTML 通过检查后,立即用当前环境可用的本地浏览器或 HTML 预览器直接打开
report.html供用户查看;不能只返回文件路径。
八种视觉不能互换:Ogilvy 是层层下潜的编辑叙事;NeedScope 是二维情感空间图;GWTB 是四格策略板;TBWA 是惯例到颠覆的强对照;Levi-Strauss 是二元对立与转换公式图;消费任务与价值链是情境—Job 与 A-C-V 链图;品牌关系是事件线与六构面非评分剖面;品牌社群是成员关系与三标志结构图。共享的只是审阅语言。
完成 Gate
只有同时满足以下条件才可以说“完成”:
- 方法选择与问题匹配;
- 方法选择也与数据维度和证据权威匹配,不能只因为用户点名或文件名暗示就执行完整方法;
- 正式分析前已向用户说明数据结构、推荐方法、方法步骤、预期信息与边界,并取得真实确认;
- 原始输入、格式化读取、派生处理和用户决定可区分;
- 数据证据角色没有混淆;
- 关键结论可追溯且有反证检查;
- 方法专属 Gate 已通过;
report.md与report.html的结论、数字和来源一致;- 数据来源能定位每个原始文件,并说明样本账目与统计口径;
report.html是单文件、无占位符、导航可隐藏、水印可见、可读可打印;report.html已在本地浏览器或 HTML 预览器中直接打开;validate_run.mjs已通过,且未使用自建替代校验器;- 局限与下一步明确。
若 Gate 未通过,仍交付 report.md 与阶段性诊断 HTML,明确缺失证据,不能伪装成正式结论。
文件索引
索引只列会被改路径的主要模块;脚本的完整适用边界与调用方式在 references/06-script-routing.md。
| 路径 | 用途 |
|---|---|
references/01-ogilvy.md | 情绪洞察与 Brand Big IdeaL |
references/02-needscope.md | 官方二维情感空间及社会数据诊断边界 |
references/03-gwtb.md | 单一 GWTB 与官方笔记判定 |
references/04-tbwa.md | 惯例、疲劳、愿景与颠覆机会 |
references/05-levistrauss.md | 二元对立、转换与趋势预判 |
assets/report-shell.html | 本 Skill 的报告骨架(页眉/证据卡/置信度/反证/来源抽屉/打印样式)——装配管线公共,骨架自有 |
assets/report-style-guide.md | 共享审阅组件与 HTML 验收规则 |
assets/report-template.md | 结论优先的 Markdown 报告模板与数据来源表 |
assets/methods/ | 八种主方法专属 HTML 模块 |
references/06-script-routing.md | 脚本适用边界和调用说明(脚本全清单在此) |
references/07-needscope-sources.md | NeedScope 官方资料核对与报告设计依据 |
references/08-jobs-value-chain.md | JTBD、MEC 与 Laddering 的身份、证据条件和禁区 |
references/09-brand-relationship.md | Fournier 品牌关系与 BRQ 诊断 |
references/10-brand-community.md | 品牌社群三标志与成员关系 Gate |
references/11-auxiliary-lenses.md | 隐喻/符号、区别性资产、人格和资产桥接镜头 |
references/12-netnographic-conduct.md | 数字场域、网络志命名与研究伦理 |
references/13-method-sources.md | Canonical sources、名称纠错与使用边界 |
references/00-skill-system-map.md | 三层职责、权威、Pipeline 与验证架构 |
stages/ | 当次项目从语料到报告的七阶段 Pipeline |
scripts/prepare_corpus.mjs | 对 CSV/TSV/JSON 一次生成规范化语料、稳定 ID 和覆盖账本 |
scripts/render_report.mjs | 薄壳:把本 Skill 的骨架与主方法模块交给公共件 planners-report-kit 装配(落点、水印、未解析不写盘都在那边) |
scripts/validate_run.mjs | 唯一正式完成校验:证据、主张、数字与报告契约 |
scripts/validation-core.mjs | 上面那个校验器的核心(证据/主张/数字),被 validate_run.mjs 与兼容入口共用 |
scripts/review_report.mjs | 单次浏览器会话生成桌面/移动截图、打印 PDF 与 DOM 审计。与 planners-quanti-box 的 scripts/visual_smoke.mjs 是同一类检查(一次浏览器会话的机械视觉检查),不是人工审阅面 |
scripts/preprocess_comments.py、scripts/extract_wordfreq.py、scripts/phase1_analyze.py、scripts/deepen.py | Ogilvy 路线的预处理、词频、一期分析与深化(适用边界见 references/06-script-routing.md) |
scripts/validate_evidence.mjs | 旧命令兼容入口,与 validate_run.mjs 共用同一验证核心 |
scripts/test_no_review_surface.mjs | 防回退回归:扫整棵 Skill 树,出现任何公共审阅缝的标志物(桥注入点 / review-surface.json / 反馈文件 / 自起服务器)即红。它钉住的裁定是:本 Skill 的人的决定(CP0 方案确认)留在对话里,不上缝 —— 那类决定要的是"模型在旁边多轮协商",而缝的表达力是"一页 → 写一份文件 → 醒一次";挂上去还会让 corpus-profile.md 的 confirmation_status 多出一份副本 |
scripts/test_evidence_pipeline.mjs | 证据管线回归 |
scripts/lib/planners-modules*.mjs | 公共模组的解析适配器与安装器(允许重复的 seam) |
evals/ | 外部模型测试数据、Prompt 与评分表 |
レビュー
まだレビューはありません。使ってみた感想をお寄せください。