cs-search-skill

name	cs-search-skill
description	Use for deep, source-backed research of a product, company, technology, market, or competitor set, especially when the user asks for 调研、竞品分析、深度研究、 摸清楚、市场判断, or a decision brief. Build a research map, search current web sources, compare 3-5 relevant competitors, separate facts from inference, and return cited findings, risks, and actions. Do not use for simple factual lookups or article drafting.
metadata	{"author":"陈硕","collection":"CS Skills","source":"https://github.com/ChenShuo2004/cs-skills","compatibility":"Codex and any agent that supports SKILL.md"}

Search Skill

Overview

把一个模糊的调研请求变成可以支持决策的研究简报。默认围绕一个目标对象和 3-5 个代表性竞品，完成纵向发展史、横向现状、用户声音、商业模式与战略判断， 并为关键结论保留可追溯来源。

默认直接在对话中输出中文决策简报；只有用户明确要求时，才把完整结果写入 research.md 或其他文件。

适用范围与边界

适合以下任务：

• 研究一个产品、公司、技术、市场、商业模式或新概念。
• 分析目标对象与直接竞品、替代方案或潜在竞争者。
• 为“是否进入、是否购买、是否跟进、如何定位、下一步做什么”等问题提供依据。
• 需要当前信息、历史演进、用户反馈和多来源交叉验证的深度研究。

不要用于：

• 只需要一个简单定义、一个稳定事实或一次快速查找的问题。
• 纯粹写文章、改稿或包装研究结论；这类任务交给 $cs-writer。
• 没有任何公开证据却要求确认私有数据、内幕消息或确定性预测的任务。

简单事实问题应直接回答，不要为了触发完整流程而制造长报告。

输入契约

开始前识别以下信息：

• 研究对象：产品、公司、技术、市场或概念的明确名称及别名。
• 决策问题：用户希望研究后做什么决定，或需要验证哪一个判断。
• 范围：地区、时间点、行业边界、用户群和重点维度。
• 竞品名单：用户提供的名单优先；没有名单时自动发现 3-5 个代表性对象。
• 已有材料：链接、文档、截图、数据、用户观察或内部假设。
• 深度要求：默认输出决策简报；用户要求时扩展为完整研究报告。
• 交付格式：直接输出文字，或生成 PDF 报告。

只在以下情况提问：研究对象存在多个同名实体、决策问题完全缺失且会改变研究方向， 或研究范围过大到无法在当前任务中完成。其余信息采用合理默认，并在结果中写明。

工作流

1. 定义研究问题

先用一句话复述研究目标，并形成内部研究卡：

目标对象：
决策问题：
研究范围：
竞品集合：
关键维度：
交付形式：中文决策简报

如果用户没有指定竞品，先判断直接竞品、替代方案和潜在进入者，再选出 3-5 个 最有代表性的对象，并说明选择理由。不要为了凑数量加入无关产品。

2. 建立研究地图

根据对象和决策问题选择必要维度，不机械填满清单。通常覆盖：

• 纵向脉络：起源、创始团队或提出者、关键版本、转型、融资/收购、重大争议和当前状态。
• 当前产品：核心能力、目标用户、使用场景、定价、分发渠道、生态和限制。
• 横向竞品：定位、核心差异、产品体验、用户口碑、商业模式和竞争位置。
• 市场环境：需求变化、技术或政策约束、替代方案、进入壁垒和潜在变化。
• 战略判断：优势来源、短板、可持续性、机会、风险和对用户决策的影响。

3. 收集与记录证据

使用可用的网络搜索、页面打开和内容提取能力。先搜索发现线索，再打开原始页面核验， 不要只依赖搜索摘要。针对同一问题组合多个关键词和角度，必要时分别搜索目标对象、 竞品、用户评价和行业背景。

来源优先级：

• 一级来源：官方文档、产品页面、定价页、发布公告、公司披露、监管/法院文件、原始论文、 GitHub 仓库和当事人原始访谈。
• 二级来源：可信媒体的原创报道、行业报告、专业测评和有方法说明的调查。
• 三级来源：论坛、评论、社交媒体和聚合内容，只用于了解用户声音或发现线索，不单独支撑 关键商业判断。

对每条重要结论在内部保留证据记录：

claim：结论或事实
source：来源标题 + URL
published/updated：来源发布日期或更新时间
accessed：访问日期
tier：一级 / 二级 / 三级
confidence：高 / 中 / 低
notes：支持范围、冲突信息或限制

关键数字、当前状态、价格、融资、用户规模和产品能力必须优先使用最新来源； 在可行时用两个相互独立的来源交叉验证。多篇转载同一原始报道不算独立验证。

4. 分析与综合

先整理证据，再提出判断：

• 事实：来源直接支持的内容，紧邻结论放置来源链接。
• 推断：基于多个事实的分析，明确使用“推断”“更可能”“我的判断”等措辞。
• 未知：公开资料无法确认的内容，写明“暂未找到可靠证据”，不要补写确定答案。

纵向分析要回答“哪些历史决策塑造了今天的产品和竞争位置”；横向分析要回答“它与 竞品在什么地方真正不同，以及用户为什么会选择它”。不要把时间线和参数表简单拼接， 必须在交叉部分形成新的判断。

5. 确认交付格式

简单问题和普通决策简报直接输出文字，不要额外提问。

当用户要求“分析报告”“研究报告”、完整报告，或没有明确交付形式时，在完成研究、 准备生成最终报告前只问一个问题：

你希望我直接输出文字版，还是生成一份 PDF 报告？

处理规则：

• 用户选择文字：按本 skill 的决策简报结构直接回复。
• 用户选择 PDF：先按本 skill 完成研究和证据整理，再调用内置 pdf skill 生成、渲染并检查 PDF。
• 用户已经明确要求文字或 PDF：不要重复询问。
• 不能回答或等待用户选择时，默认输出文字，不阻塞研究结果。
• 只调用现有 pdf skill，不创建名为 pdfskill 的目录，也不复制 PDF 生成逻辑到本 skill。

6. 输出决策简报

默认按以下结构直接回复：

# [研究对象] 调研决策简报

## 一句话结论

## 研究问题与范围

## 关键发现

## 目标对象的纵向脉络

## 当前竞品对比
| 对象 | 定位/用户 | 核心差异 | 优势 | 短板 | 证据 |

## 用户与产品证据

## 商业模式与战略位置

## 机会、风险与不确定性

## 建议与下一步

## 来源

结论、关键数字和判断后紧跟来源链接。来源清单只列实际使用过的来源，并标注访问日期； 不能用来源清单掩盖正文缺少证据。用户要求完整报告时，再扩展时间线、竞品个案和证据细节， 但仍保持决策结论在前。

质量门槛

交付前检查：

• 是否确认了研究对象，而不是把同名实体混在一起。
• 是否明确回答了用户的决策问题，而不是只罗列资料。
• 竞品是否为 3-5 个真正相关的对象，且选择理由清楚。
• 关键事实、当前信息和数字是否有可追溯来源。
• 是否交叉验证了重要结论，并识别来源冲突。
• 是否清楚区分事实、推断和未知，避免编造内幕或精确预测。
• 机会、风险和建议是否能回溯到前面的证据。
• 是否在结果中标注研究截止时间与仍需补证的部分。

交付边界

• 不声称访问了未提供的私有数据、付费数据库或用户账户。
• 不把多个转载当成多个独立证据。
• 对医疗、法律、投资等高风险领域明确标注限制，不把研究简报当作专业意见。
• 需要把研究结论写成文章时，交给 $cs-writer，不要在本 skill 内自行改变交付目标。