القائمة
何时使用需要在写代码、引入依赖、增加集成、创建新工具或抽象前，先检索仓库内已有实现、第三方库、MCP、公开 skill 和 GitHub 模式，避免重复造轮子
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
分析代码库结构并生成中文 token-lean 架构文档。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
| name | dev-search-first |
| description | 何时使用需要在写代码、引入依赖、增加集成、创建新工具或抽象前，先检索仓库内已有实现、第三方库、MCP、公开 skill 和 GitHub 模式，避免重复造轮子 |
在写任何新代码前，先确认现成方案是否已经存在。
这个 skill 解决的是“先调研再实现”的 workflow，而不是替代具体实现 skill。
如果当前任务可能通过现有代码、现有依赖、现有 MCP、现有 skill 或成熟开源方案解决，就必须先完成检索，再决定是 Adopt、Extend 还是 Build。不要先写代码再补搜索。不要把“我大概知道没有现成方案”当作完成检索。
本 skill 触发后，所有本地与联网检索都必须优先使用 agent 自带的搜索能力；需要查仓库内容时使用内置文件搜索/代码搜索，需要联网时使用内置网页搜索。
不要用于：
digraph search_first {
"要新增能力？" [shape=diamond];
"调用 agent 内置搜索做本地/联网检索" [shape=box];
"存在高质量现成方案？" [shape=diamond];
"Adopt" [shape=box];
"可在现有方案上薄封装？" [shape=diamond];
"Extend" [shape=box];
"Build" [shape=box];
"要新增能力？" -> "调用 agent 内置搜索做本地/联网检索" [label="是"];
"调用 agent 内置搜索做本地/联网检索" -> "存在高质量现成方案？";
"存在高质量现成方案？" -> "Adopt" [label="是"];
"存在高质量现成方案？" -> "可在现有方案上薄封装？" [label="否"];
"可在现有方案上薄封装？" -> "Extend" [label="是"];
"可在现有方案上薄封装？" -> "Build" [label="否"];
}
复制并跟踪这份检查清单：
Search-First Progress:
- [ ] Step 1: 明确需求边界与约束
- [ ] Step 2: 搜索仓库内已有实现
- [ ] Step 3: 搜索外部库 / MCP / skill / GitHub 模式
- [ ] Step 4: 对候选方案做结构化比较
- [ ] Step 5: 作出 Adopt / Extend / Build 决策
- [ ] Step 6: 把结论写回设计或实施方案
至少写清：
先查当前仓库，再查上游 submodule。
必查：
使用 agent 自带的联网搜索，至少覆盖：
最少比较这些维度：
| 维度 | 说明 |
|---|---|
| 功能匹配度 | 是否直接解决问题 |
| 维护状态 | 最近是否仍在维护 |
| 集成复杂度 | 接入成本、改造成本 |
| 依赖体积 | 是否引入过重依赖 |
| 许可证 | 是否可用 |
| 与仓库约束兼容性 | 是否违背项目规则 |
输出必须包含：
## Search-First 结论
- Need:
- Constraints:
- Repo Findings:
- External Candidates:
- Recommendation: Adopt / Extend / Build
- Why:
- Risks: