用途:audience-check 是一个内部开发技能(不面向消费者发布),用于把 README 或用户指定的任意前置文档,依次以多个不同读者身份重新阅读,而不是以作者视角。作者知道每一行的含义,首次阅读者不知道;该技能的目标是暴露某一类受众会在何处困惑、被忽视或流失,并提出具体修改方案。它配合 readme-brevity 与 docs-quality 规则使用:后者管篇幅与打磨,本技能判断内容是否真正触达目标读者。
主要能力:按受众逐一做冷读。默认覆盖 6 类角色:1)Claude Code 用户(主要受众),关注首屏是否传达 vigiles 做什么、安装路径(npx vigiles init、agent prompt)是否在首屏且可直接运行、是否使用其惯用词汇(hooks、skills、CLAUDE.md、subagents);2)Codex 用户,关注 Codex 支持是否早期可见、示例是否只面向 Claude Code、是否知道 vigiles/codex 存在及哪些可用;3)资深/Staff 工程师,20 秒内判断实质与差异化,会对比 promptfoo、ESLint、ast-grep,关注确定性、无需 API key、跑在自己订阅上的成本说法是否有据;4)初级工程师,关注术语首次出现是否先定义(harness、eval、trigger-rate、subagent、dialect),是否有清晰的“第一步做什么”;5)工程经理/决策者,关注成本、风险与投入,是否以增量低风险方式描述采用,能否仅凭 README 回答“为何现在/为何选它”;6)QA/测试工程师,关注 Test 支柱是否讲到 runHook、runHarnessTest、measureTriggerRate、显著性/回归门禁,确定性运行与真实模型的分界,以及与 promptfoo/DeepEval 的诚实对比。
使用方式:先完整阅读目标文档(默认 README.md,支持用户指定路径),同时浏览其链接的文档,以便核对“README 承诺的深度文档是否兑现”。随后针对每个角色做冷读:代入该读者的目标、词汇与耐心,问他们的问题而非作者的问题。按固定格式输出报告:每个角色一个区块,含判定(✅ lands / ⚠ rough / ✗ bounces)、冷读反应、摩擦点、具体修复;最后给出跨角色共性问题(2–4 条)与按读者影响力排序的修复清单。要求具体:引用确切行、给出确切修改。
限制与说明:这是报告型技能,除非用户要求,不直接改写 README,应用修改是单独的显式步骤。用户可限定只跑部分角色;若资料未提供某角色的细节,则以原文为准,不额外推断。输出应保持可扫描、可执行。