本文へ移動
cccskills
無料GitHub で公開

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
  → 项目经验与通用方法分级沉淀

不要在没有数据时假装完成分析。先说明能回答什么、不能回答什么,以及还需要什么。

路由:问题适配 × 证据适配

不要让用户预先选择方法。先读取字段、少量异质原文和收集情境,再同时判断:

  1. 问题适配:用户最终要理解、比较或决定什么;
  2. 证据适配:当前材料是否包含该方法所需的对象、角色、时间、对照和语境;
  3. 推断距离:结论需要跨越多少层从“文本说了什么”推到“人、品牌、品类或文化意味着什么”。
候选方法问题适配最低证据条件不足时的处理
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 的最低限度体检完成后,必须先向用户提交一份简洁的分析方案,不能直接进入正式分析。方案包含:

  1. 数据结构:文件/工作表、格式、逻辑记录数、分析单位、关键字段、证据角色、主要质量问题与缺口;
  2. 推荐方法:模型推荐的方法、为什么适配当前问题与数据,以及明显不适合的方法;
  3. 方法步骤:用非术语化语言说明将如何抽样/校准、分析、反证和形成结论;
  4. 预期信息:预计能得到哪些层级的洞察、比较或建议,以及这份数据不能回答什么;
  5. 待确认范围:研究对象、时间/品牌/人群边界、是否采用推荐的一个主方法、是否调用必要的单一辅助镜头及必要工作假设。第二个镜头属于需单独说明价值的例外。

最后明确询问用户是否按该方案开始。得到真实、明确的确认或修改意见前,停止在 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 不读、也不该读(它管的是证据、主张、数字与报告契约);
  • 不做:不落哈希绑定、不生成第二份确认记录、不上公共审阅缝。

执行阶段

依次完整读取并执行:

  1. stages/00-route-and-corpus.md:确定研究问题、方法与语料边界,提交分析方案并等待用户确认,建立 corpus-profile.md。
  2. 只有 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)。
  3. stages/02-calibration.md:语义编码、分类或大语料任务先用异质小样本校准;纯文本细读可说明理由后跳过。
  4. 加载且只加载所选主方法 Reference、已确认的辅助镜头;线上场域另加载研究规范,再执行 stages/03-full-analysis.md。
  5. stages/04-claim-audit.md:把候选解释整理为 evidence-index.json 与 claim-ledger.json;所有报告数字进入 metrics-ledger.json。
  6. stages/05-report-and-review.md:只从通过审计的主张写 Markdown,用 scripts/render_report.mjs 组装 HTML,再用 scripts/validate_run.mjs 完成唯一一次机械校验。
  7. stages/06-deliver-and-learn.md:交付、复盘,并区分项目经验与可升级方法知识。

预处理不是共享算法

共享的是原生格式读取、输入检查和证据追溯,不是聚类方法。记录的“条数”必须是格式解析后的逻辑记录数;物理行、分页或视觉换行不能直接当记录。只有原生解析失败、字段错位或结构不变量被破坏时才可称为损坏,并保留原始输入与转换说明。

八种方法的专属处理策略各自住在自己的 Reference 里(references/01-ogilvy.md … references/10-brand-community.md),本页不复述:一个项目只跑一个主方法,所以只读那一个。共同结论只有一条 —— 聚类不是共享算法,谁都不许用它替代方法专属的证据组织。

脚本路线见 references/06-script-routing.md。运行文件必须写入当前任务的输出目录,不得写回 Skill 安装目录。

统一审阅契约

每个关键结论必须让读者看见以下内容:

  1. Claim:一句可反驳的判断,而不是主题标签。
  2. Evidence:至少两条带来源 ID 的原音或内容证据;重要结论尽量跨来源验证。
  3. Counter-evidence:不支持、相反或构成边界的材料。
  4. Confidence:只使用高/中/低,并解释来自样本覆盖、来源一致性还是推断距离;限定语写入理由或边界,不另造“中高”等等级。
  5. 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 中没有依据的新结论。

统一顺序:

  1. 先看答案:一句短回答、3–5 条单句结论、1–3 条单句建议和一行整体边界;不在摘要堆原音、source_id、长推理或完整数据账目;
  2. 数据来源:原始来源、样本账目、字段、时间、清洗、证据角色与数据缺口;
  3. 方法分析:展示该方法专属主图、推理过程、证据与反证;
  4. 附录:方法参数、来源索引、限制与下一步。

读者面前不出现机器的账目。 正文引用一律用短 handle(A9、N16)或一句可读描述("某品牌官方号·赛事嘉宾笔记下的最高赞评论");comment_id / note_id 这类原始定位符、写稿脚本的文件名(如 phase1_analyze.py)、*.jsonl / *.csv 文件名只出现在附录,并且在 HTML 里默认折叠,不铺在阅读流里。溯源能力不受影响——附录仍然能回源到每一行,只是不再把回源路径印在正文上。判断标准:把正文单独截出来给客户看,里面不该有任何他无法理解的字符串。

  1. 先用本 Skill 自己的 assets/report-shell.html 取得页眉、证据卡、置信度、反证、来源抽屉和打印样式(装配管线是公共的,骨架是本 Skill 的 —— 八种方法的视觉隐喻不可互换)。
  2. 再加载对应的 assets/methods/*.html,采用主方法自己的信息结构和视觉隐喻;辅助镜头进入正文证据区,不另起一套总报告。
  3. 替换所有 {{PLACEHOLDER}};不允许把占位文本交给用户。
  4. 保留可隐藏导航;导航打开/收起均不遮挡正文,移动端默认收起。
  5. 固定显示作者水印“阿祖不看 TVC · demyth.info”,不得被方法模块覆盖;打印版同样保留轻水印。
  6. 先运行 validate_run.mjs,再优先运行 review_report.mjs,在一次浏览器会话中生成桌面、390px、打印和 DOM 检查的最小批次。默认只做一次视觉模型目检;只有这一次发现具体异常时才针对异常重截,不做多轮无目标复查。
  7. 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.mdNeedScope 官方资料核对与报告设计依据
references/08-jobs-value-chain.mdJTBD、MEC 与 Laddering 的身份、证据条件和禁区
references/09-brand-relationship.mdFournier 品牌关系与 BRQ 诊断
references/10-brand-community.md品牌社群三标志与成员关系 Gate
references/11-auxiliary-lenses.md隐喻/符号、区别性资产、人格和资产桥接镜头
references/12-netnographic-conduct.md数字场域、网络志命名与研究伦理
references/13-method-sources.mdCanonical 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.pyOgilvy 路线的预处理、词频、一期分析与深化(适用边界见 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 与评分表

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

このスキルの問題を報告する