lionad-morotar/find-source

find-source

为代码改动、配置项或技术决策查找文档源头和权威依据。

工作流程

1. 分析改动/主题

确定需要查找来源的内容类型：

| 类型 | 示例 | 查找方向 | |------|------|----------| | 配置项 | eslint --cache, tsconfig.json 选项 | 官方文档 CLI/API 参考 | | 依赖库用法 | lint-staged 配置, husky hook | 官方 README/文档 | | 项目约定 | 分支策略, 代码风格 | 项目内文档 (docs/, CONTRIBUTING.md, CLAUDE.md) | | 语言特性 | TypeScript 新特性, Vue 语法 | 官方文档/Release Notes |

2. 分层查找策略

按优先级顺序查找：

第一层：项目内约定

1. 检查 CLAUDE.md - 项目级 AI 协作约定
2. 检查 docs/ 目录下的相关文档
3. 检查 CONTRIBUTING.md 或开发规范
4. 检查代码注释中的引用

第二层：依赖库官方文档

1. 使用 mcp__plugin_context7_context7__resolve-library-id + query-docs 查找
2. 使用 WebSearch 搜索官方文档
3. 使用 mcp__zread__search_doc 搜索 GitHub 仓库文档

第三层：社区/生态最佳实践

1. 搜索 Stack Overflow / GitHub Discussions
2. 查找知名项目的配置示例

3. 输出格式

找到来源后，按以下格式输出：

## 改动/主题: [简要描述]

### 1. [来源类型] [来源名称]

**来源**: [文档链接或文件路径] (置信度: [高/中/低])
**配置小节**: [具体的章节/选项]
**核心说明**:
> [引用原文]

**相关配置**:
| 选项 | 说明 |
|------|------|
| ... | ... |

### 2. [项目约定]

**来源**: [文件路径] (置信度: 高)
**说明**: [项目特定的约定说明]

### 总结

| 配置项 | 文档源头 | 链接/路径 | 置信度 |
|--------|----------|-----------|--------|
| ... | ... | ... | ... |

置信度标注规则

对每一个来源，评估其权威性和可靠性，并在括号内标注置信度：

| 置信度 | 适用场景 | |--------|----------| | 高 | 官方文档、项目内约定文件、Release Notes、源码中的明确注释 | | 中 | 知名社区文章、Stack Overflow 高赞回答、GitHub Issues/Discussions 中的官方人员回复 | | 低 | 个人博客、未经广泛验证的第三方内容、机器翻译或信息间接转述 |

特别说明：当来源为网页链接或媒体资源时，必须在链接后追加 (置信度: X)。例如：

• **来源**: https://eslint.org/docs/latest/user-guide/command-line-interface (置信度: 高)
• **来源**: https://example-blog.com/article (置信度: 低)

工具使用指南

Context7 (优先)

用于查找主流开源库的官方文档：

1. mcp__plugin_context7_context7__resolve-library-id
   - libraryName: 库名 (如 "eslint", "typescript")
   - query: 具体查询内容

2. mcp__plugin_context7_context7__query-docs
   - libraryId: 上一步返回的 ID
   - query: 具体选项或配置

WebSearch

用于查找官方文档链接或最新信息：

- 搜索: "[库名] [选项] official documentation"
- 搜索: "[库名] [配置] site:官方域名"

GitHub zread

用于搜索 GitHub 仓库的文档：

- mcp__zread__search_doc: 搜索仓库文档
- mcp__zread__read_file: 读取具体文件

项目内查找

- Glob: 查找 docs/, *.md 文件
- Read: 读取 CLAUDE.md, CONTRIBUTING.md
- Grep: 在项目内搜索相关配置

示例

示例 1: 查找 eslint --cache 的文档

用户: "为刚才的改动找到文档源头"

执行:

1. 分析改动: 在 package.json 中添加了 "eslint --fix --cache"
2. 查找 Context7: resolve-library-id("eslint") → query-docs("--cache option")
3. 查找项目约定: Read package.json, .gitignore
4. 输出: 官方文档链接 + 项目配置位置

示例 2: 查找项目分支策略的依据

用户: "这个分支策略有文档吗"

执行:

1. 分析: 项目使用特定的分支模型
2. 查找项目内: Glob docs/ → Read docs/branching.md
3. 查找外部: WebSearch "git branching strategy main test release"
4. 输出: 项目约定文档 + 行业最佳实践参考

示例3：从上下文获取查询内容

上一轮 用户: 更新 ~/.claude/settings.json，禁止 git push You:

已完成。在 `settings.json` 中添加了一个 `PreToolUse` hook：
- 匹配 `Bash` 工具调用
- 如果命令包含 `git push`（不区分大小写），输出 `permissionDecision: "deny"` 拦截执行
- 其他命令正常放行
**验证结果**：
- JSON 语法通过 `jq -e` 校验
- hook 命令已正确写入
**生效方式**：
由于 Claude Code 的 settings watcher 对 `.claude/` 目录的配置热重载有限制，你可能需要：
1. 在会话中输入 `/hooks` 打开 hooks 管理界面，这会触发配置重载
2. 或者重启 Claude Code
完成后，任何我尝试执行的 `git push` 都会被拒绝。

此轮 用户：/find-source You：将给关键决策补充文档来源：

1. 查找 PreToolUse 文档关于 permissionDecision 的信息
2. 查找 Claude Code 配置热重载模式

注意事项

1. 区分层级: 明确区分官方文档、项目约定、社区实践
2. 提供上下文: 不仅给出链接，还要说明为什么这个来源权威
3. 完整性: 如果涉及多个配置项，为每个都找到来源
4. 可追溯性: 优先使用 Context7 等结构化文档，其次是官方文档链接，最后使用 Github、Stack Overflow、以及高质量第三方论坛