https://adongwanai.github.io/AgentGuide | AI Agent开发指南 | LangGraph实战 | 高级RAG | 转行大模型 | 大模型面试 | 算法工程师 | 面试题库 | 强化学习｜数据合成
This report summarizes scanner evidence for adongwanai/AgentGuide, a MDX project with 10,686 GitHub stars. SynthScan examined 125,671 lines of code across 230 source files, recording 201 pattern matches distributed across 10 syntactic categories. The legacy adjusted pattern signal is 4.4 (Low pattern signal); it is not an authorship estimate.
Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.
Use each vector to guide manual verification of the underlying findings.
Can maintainers explain intent, assumptions, and trade-offs? 159 finding(s).
Are imports declared and package/API names verified? 9 finding(s).
Are wrappers, guards, and repeated structures necessary? 36 finding(s).
Which changes need focused human review? 201 finding(s).
This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.
Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.
This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.
The scanner identified 201 distinct pattern matches across 10 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.
Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | README.md | 61 | - [📖 技术教程](#-第五步系统学习-agent-技术技术准备) - LangGraph、RAG、上下文工程、监督微调、强化学习 | CODE |
| MEDIUM | README.md | 421 | | **零基础** | 从 [6步学习路径](#-从零到offer的完整路径快速导航) 开始，先建立 Agent / Workflow / RAG / Multi-Agent 的坐标系 | | CODE |
| MEDIUM | resources/tools.md | 124 | ### RAG 技术栈 | COMMENT |
| MEDIUM | resources/tools.md | 271 | ### 场景1：开发 RAG Agent | COMMENT |
| MEDIUM | resources/agent/frameworks.md | 293 | **链接**：https://github.com/ginobefun/agentic-design-patterns-cn | CODE |
| MEDIUM | resources/agent/official-guides.md | 181 | **链接**：https://github.com/ginobefun/agentic-design-patterns-cn | CODE |
| MEDIUM | resources/agent/official-guides.md | 255 | - 阅读 [Agentic Design Patterns](#1-agentic-design-patterns中英对照)，理解主流的 Agent 架构思想。 | CODE |
| MEDIUM | resources/agent/official-guides.md | 264 | - 学习 [Multi-Agent 设计模式](#1-agentic-design-patterns中英对照)，并尝试在协作场景中进行应用。 | CODE |
| MEDIUM | resources/agent/evaluation-harness.md | 63 | ## 📄 RAG 评估框架 | COMMENT |
| MEDIUM | resources/agent/README.md | 343 | - **链接**：https://github.com/ginobefun/agentic-design-patterns-cn | CODE |
| MEDIUM | resources/agent/README.md | 349 | #### 1. RAG from Scratch ⭐⭐⭐⭐ | COMMENT |
| MEDIUM | resources/rag/projects.md | 217 | ## ⚙️ RAG 引擎与服务 | COMMENT |
| MEDIUM | resources/rag/README.md | 10 | # RAG 资源总览 | COMMENT |
| MEDIUM | resources/rag/papers/README.md | 10 | # RAG Papers | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 28 | ## 什么是Agentic RAG? | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 45 | #### Athina AI RAG Cookbooks ⭐⭐⭐⭐⭐ | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 51 | #### IBM Granite Agentic RAG | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 56 | #### NVIDIA Agentic RAG | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 57 | - **GitHub**: https://github.com/NVIDIA/workbench-example-agentic-rag | CODE |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 65 | #### Azure GPT-RAG Agentic Orchestrator | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 66 | - **GitHub**: https://github.com/Azure/gpt-rag-agentic | CODE |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 70 | #### Hierarchical Multi-Agent RAG | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 71 | - **GitHub**: https://github.com/lorenzejay/agentic-rag-practical-example | CODE |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 79 | #### Hugging Face Agentic RAG | COMMENT |
| MEDIUM⚡ | resources/rag/papers/agentic_rag/agentic_rag.md | 80 | - **GitHub**: https://github.com/aymericroucher/agentic-rag-query-reformulation | CODE |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 101 | #### Redis Agentic RAG | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 102 | - **GitHub**: https://github.com/redis-developer/agentic-rag | CODE |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 134 | #### Agentic RAG Survey (2025.01) ⭐⭐⭐⭐⭐ | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 156 | #### Self-RAG (ICLR 2024 Oral) ⭐⭐⭐⭐⭐ | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 567 | - Building Agentic RAG with LlamaIndex: https://www.deeplearning.ai/short-courses/building-agentic-rag-with-llamaindex/ | CODE |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 568 | - AI Agentic Design Patterns with AutoGen: https://www.deeplearning.ai/short-courses/ai-agentic-design-patterns-with-aut | CODE |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 581 | - LlamaIndex Agentic RAG: https://www.llamaindex.ai/blog/agentic-rag-with-llamaindex-2721b8a49ff6 | CODE |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 588 | ### Agentic RAG Survey | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/agentic_rag.md | 600 | ### Self-RAG | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/README.md | 11 | # Agentic RAG 论文汇总 | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/README.md | 25 | ## RAG 与推理（RAG-Reasoning） | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/README.md | 82 | ## RAG 系统性思考 | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/README.md | 122 | ##### 4. RAG 如何工作？（How RAG Works） | COMMENT |
| MEDIUM | resources/rag/papers/agentic_rag/README.md | 162 | ##### RAG 风险 | COMMENT |
| MEDIUM | resources/rag/papers/multimodal_rag/README.md | 11 | # Multimodal RAG Papers | COMMENT |
| MEDIUM | resources/multimodal/tools-and-projects.md | 11 | # 多模态 RAG 工具与项目清单 | COMMENT |
| MEDIUM | resources/multimodal/tools-and-projects.md | 46 | ## 一体化多模态 RAG | COMMENT |
| MEDIUM | resources/multimodal/tools-and-projects.md | 48 | ### RAG-Anything | COMMENT |
| MEDIUM | resources/multimodal/README.md | 10 | # Multimodal RAG 与文档智能资源 | COMMENT |
| MEDIUM | resources/multimodal/README.md | 34 | ### 项目 2：财报多模态 RAG | COMMENT |
| MEDIUM | resources/project-catalogs/end-to-end-agent-projects.md | 217 | ### [RAG-Anything](https://github.com/HKUDS/RAG-Anything) | COMMENT |
| MEDIUM | …/03-practice/07-multimodal-rag-evaluation-checklist.md | 11 | # 多模态 RAG 评测清单 | COMMENT |
| MEDIUM | docs/03-practice/02-high-availability-rag.md | 10 | # 高可用 RAG 系统实战 | COMMENT |
| MEDIUM | docs/03-practice/03-agent-security.md | 119 | ## RAG / 文档 Agent 安全 | COMMENT |
| MEDIUM | docs/archive/2.md | 87 | ### 5. RAG | COMMENT |
| MEDIUM | docs/04-interview/06-development-specialized.md | 42 | ### 高并发 RAG 系统设计 | COMMENT |
| MEDIUM | docs/04-interview/06-development-specialized.md | 47 | - 标签：#系统设计 #高并发 #RAG | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 75 | - 标签：#RAG #流式输出 #系统设计 | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 157 | - 标签：#SaaS #多租户 #RAG | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 193 | - 标签：#知识库 #增量更新 #RAG | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 217 | - 标签：#混合检索 #RAG #系统设计 | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 234 | - 标签：#性能优化 #延迟 #RAG | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 258 | - 标签：#向量检索 #优化 #RAG | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 306 | - 标签：#增量更新 #索引 #RAG | CODE |
| MEDIUM | docs/04-interview/06-development-specialized.md | 366 | - 标签：#多语言 #RAG #国际化 | CODE |
| 82 more matches not shown… | ||||
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2010 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2012 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2104 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2106 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2115 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2117 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2126 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2128 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2206 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2208 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2245 | # ============================================================ | COMMENT |
| MEDIUM⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2247 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1406 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1408 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1468 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1470 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1486 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1488 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1579 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1581 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1774 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1776 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1884 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1886 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1937 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1939 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1975 | # ============================================================ | COMMENT |
| MEDIUM | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1977 | # ============================================================ | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW⚡ | CONTRIBUTING.md | 75 | ### Step 1: Fork 项目 | COMMENT |
| LOW⚡ | CONTRIBUTING.md | 79 | ### Step 2: 克隆到本地 | COMMENT |
| LOW⚡ | CONTRIBUTING.md | 86 | ### Step 3: 创建分支 | COMMENT |
| LOW | CONTRIBUTING.md | 99 | ### Step 4: 进行修改 | COMMENT |
| LOW | CONTRIBUTING.md | 105 | ### Step 5: 提交修改 | COMMENT |
| LOW | CONTRIBUTING.md | 123 | ### Step 6: 推送到 GitHub | COMMENT |
| LOW | CONTRIBUTING.md | 129 | ### Step 7: 提交 Pull Request | COMMENT |
| LOW⚡ | …02-tech-stack/22-parlant-agent-compliance-deep-dive.md | 255 | #### Step 1: 引导ARQ阶段 | COMMENT |
| LOW⚡ | …02-tech-stack/22-parlant-agent-compliance-deep-dive.md | 263 | #### Step 2: 响应生成 | COMMENT |
| LOW⚡ | …02-tech-stack/22-parlant-agent-compliance-deep-dive.md | 267 | #### Step 3: 响应验证（可选） | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/markdown_links.test.py | 4 | CODE | |
| LOW | tests/content_metadata.test.py | 4 | CODE | |
| LOW | tests/site_static_smoke.test.py | 4 | CODE | |
| LOW | tests/pages_assembly.test.py | 4 | CODE | |
| LOW | tests/repository_automation.test.py | 4 | CODE | |
| LOW | docs/04-interview/examples/resume_storytelling_check.py | 15 | CODE | |
| LOW | scripts/manage_content_catalog.py | 8 | CODE | |
| LOW | scripts/content_metadata.py | 7 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 866 | api_key: "your-api-key" | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | scripts/generate_resources.py | 230 | except (OSError, ValueError): | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | docs/04-interview/examples/requirements.txt | 1 | # This example uses only the Python standard library. | COMMENT |
| LOW | docs/02-tech-stack/agent-evaluation-complete-guide.md | 1361 | # DOM大小：50,000 tokens（整个网页的HTML） | COMMENT |
| LOW | docs/02-tech-stack/agent-evaluation-complete-guide.md | 1601 | **适用场景**： | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2004 | except Exception as e: | CODE |
| LOW | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1660 | except Exception as e: | CODE |
| LOW | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 1558 | except Exception as e: | STRING |
| LOW | examples/minimal-agent-loop.md | 40 | except Exception as exc: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2210 | def generate_test_cases_from_production_logs(logs, sample_size=100): | CODE |
| LOW⚡ | docs/02-tech-stack/26-agent-evaluation-harness-guide.md | 2249 | def generate_test_cases_with_llm(task_description, num_cases=50): | CODE |
| LOW | apps/InterviewGuide/src/lib/path.ts | 54 | function normalizeCompanyRouteName(name: string): string { | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/markdown_links.test.py | 53 | CODE |