教程文档AI Agent人工智能大模型【免费下载链接】awesome-agentic-ai-zhA trilingual (繁中 / English / 简中) learning roadmap for agentic AI: from LLM basics to multi-agent systems, with 240 curated resources and hands-on examples. 中文 AI agent 學習地圖。项目地址https://gitcode.com/gh_mirrors/aw/awesome-agentic-ai-zh点击查看免费下载导读本文基于 awesome-agentic-ai-zh 仓库的公开资源层改造计划完整拆解如何把RESOURCES资源页、resources/资源索引与 MCPSkills 整合目录改造成「任务优先、新手可读」的入口同时保留完整三语目录的可检索、可评分、时效化与安全属性。读完你将掌握一套可落地的「先写回归测试、再退役易腐数据、最后渐进式重写内容」的工程方法包括details渐进披露的 HTML 结构约定、目录计数门禁的改造思路以及多语言镜像委托的校验流程。一、改造目标与整体架构该计划的核心目标Goal只有一句话把公开资源页变成任务优先、新手可读的入口同时让完整的三语 MCPSkills 目录保持可搜索、可评分、时效正确且安全。实现这一目标依赖三个互补的策略保持可见保留五个官方或高质量的起点、16 项精选资源表、以及全部 17 个分类标题可见渐进披露把完整的 83 条目录与次要说明收进关闭状态的details折叠块读者「需要时再展开」去腐化移除易变的 star 数、8176之类的库存宣称与时间承诺仅保留编辑评分、锚点、状态、许可证与权限限制。架构上还明确了语言顺序与责任边界先写并验证繁中zh-TW再交由受约束的 Codex 委托代理生成英文与简中镜像事实、diff 审查、测试与发布门禁始终由父仓库掌控。技术栈为三语 Markdown、HTMLtbodyrowspan分组表格、PyYAML 读者体验配置、pytest 回归测试、仓库时效快照、MkDocs 与 stacked GitHub PR。二、变更范围与固定决策改造只触及公开资源入口与目录这一层表面涉及的文件清单仓库根目录相对路径如下RESOURCES.md、RESOURCES.en.md、RESOURCES.zh-Hans.mdresources/README.md、resources/README.en.md、resources/README.zh-Hans.mdresources/mcp-skills-catalog.md、resources/mcp-skills-catalog.en.md、resources/mcp-skills-catalog.zh-Hans.mdscripts/test_public_entry_resources.pyscripts/reader-ux-pages.ymlscripts/check-catalog-counts.py、scripts/test_catalog_counts.pydocs/TESTING_PLAN.md、stages/DESIGN.md、CHANGELOG.md当前 README、站点卡片、外联文案与仓库契约表面中需要移除过期库存总数的地方仓库时效快照scripts/repository-freshness-snapshot.json因为最终链接清单与来源位置会变化计划特别强调边界完整的 cookbook 重写、glossary 收敛、更广泛的 README首页文案以及 agent-engineering 章节标题层是独立的 stacked PR本次 PR 在没有用户明确批准前不会合并或清理任何分支。三、官方事实包必须明确的边界条件计划要求在执行前重新核对一组当前主要来源并把以下事实显式写入页面避免读者被过时或误导信息带走modelcontextprotocol/servers包含的是教学用 reference implementations参考实现不是生产服务器目录真正的发现入口指向官方 MCP RegistryNotion 推荐其 hosted OAuth MCP开源notion-mcp-server包已不再积极维护仅作为 headlesstoken 的替代方案保留Google Workspace MCP 目前是Developer Preview状态Linear 暴露了当前的 Streamable HTTP 端点与一个只读端点不要默认推荐过时的社区服务器Slack 与 Atlassian 可能写入真实工作区数据最小权限原则与人工确认必须保持可见Canva 的功能与套餐可用性会变化不要冻结工具数量显示名必须使用Gemini Notebook舊名 NotebookLMnotebooklm仅在作为精确包名、URL、导入名或兼容标识时保留。这些事实在仓库中被进一步固化scripts/test_public_entry_resources.py的START_URLS第 51-57 行、HIGHLIGHT_PAIRS第 59-80 行与INTEGRATION_FACTS第 84-115 行把官方入口 URL、编辑评分与状态词按三语逐一锁定任何回归都会在测试阶段被拦截。四、Task 1先写公开入口的回归测试测试先行计划的第一步是在写任何内容之前先建立回归防线涉及创建scripts/test_public_entry_resources.py与修改scripts/reader-ux-pages.yml。4.1 去除折叠体的测试辅助函数测试的核心机制是_without_details()辅助函数scripts/test_public_entry_resources.py#L175-L187它保留summary文本但移除关闭的折叠正文。计划规定所有「可见性」断言都必须经过该辅助函数这样一条必备资源即使藏在折叠体内也无法蒙混过关。正则rdetails\b(?![^]*\bopen\b)[^]*(.*?)/details配合 DOTALL 模式精确匹配所有未带open属性的折叠块。4.2 锁定RESOURCES可见入口对三个语言版本分别断言五个任务优先的内部选择可见对应TASK_TARGETS第 138-144 行stages/00-foundations、resources/glossary、resources/cli-agents-guide、resources/mcp-skills-catalog、resources/cookbook五个安全起点与五组编辑评分可见START_URLS全部命中且可见文本中 3-5 星评分不少于 26 处MCP、Skill、Plugin 三个词加粗定义且必须出现在长目录之前可见精选表的行组分结构精确为43441且三语 URL评分完全一致test_resources_grouped_highlights_have_exact_trilingual_parity第 272-285 行逐一比对tbody内的tr数量与scoperowgroup rowspanN属性只有更长的补充列表默认关闭。4.3 锁定资源索引与全量目录落点资源索引的七个参考目的地保持可见且不得包含行数、固定总数或阅读时间承诺断言INDEX_TARGETS全部出现在可见文本中至少两个折叠块承载重叠说明、维护细则全量目录的 17 个编号 H2 分类标题全部在折叠块之外目录中恰好 17 个关闭的details markdown1且至少五个带评分的官方安全起点与权限警告保持可见test_catalog_keeps_safe_starts_and_all_category_landings_visible第 340-351 行。4.4 锁定易腐与过时模式测试明确拒绝以下模式test_public_resource_pages_drop_volatile_counts_stars_and_time_promises与VOLATILE_CATALOG_CLAIMS第 161-172 行数字 GitHub star 宣称、8176目录宣称、固定工具数量把社区 LinearSlack 服务器当作默认推荐STALE_DEFAULTS第 156-159 行未加限定词的NotebookLM显示名test_gemini_notebook_is_the_display_name_while_identifiers_stay_exact第 453-467 行出现NotebookLM的行必须同时是包名、URL、导入或兼容标识否则必须写成Gemini Notebookevery GitHub user、most-installed、zero install、free for regular users、Claude is bad等未经验证或贬损性表述。4.5 运行测试并捕获预期的红python -m pytest scripts/test_public_entry_resources.py -q预期结果因缺少任务优先入口、可见内容过载、易腐宣称、旧服务名与缺失折叠块而出现预期失败red——这是「测试先行」的正常节奏为后续内容改写提供精确的验收清单。五、Task 2退役对外宣称的目录总数但不丢失完整性检查5.1 先写失败的单元测试scripts/test_catalog_counts.py要求检查器真实统计条目并对比三个语言版本但不再要求公开文案或索引行对外宣传总数。任何残留的数字规模宣称都必须失败并提示写作者移除该宣称。5.2 简化检查器scripts/check-catalog-counts.py的现有实现第 32-36 行CATALOGS定义、第 95-120 行parse_catalog逐段统计真实###条目保留编号分段与条目解析规则!-- not-an-entry --标记可排除非条目标题。改动要点是移除「标题数字必须等于真实总数」的契约换成限定范围的广告总数禁令ADVERTISED_TOTAL_RE第 50-55 行在CATALOG_CONTEXT_RE命中的语境下拦截「N 条集成」之类的宣称对全仓 Markdown 扫描时跳过CHANGELOG与计划文件真实数量只作为机器输出存在main()末尾输出(total machine-counted entries; no public total claim)第 229-234 行。5.3 运行聚焦测试python -m pytest scripts/test_catalog_counts.py scripts/test_public_entry_resources.py -q python scripts/check-catalog-counts.py --quiet预期检查器测试通过公开入口测试在内容改写完成前保持红。六、Task 3重写繁中资源落地页RESOURCES.md6.1 可见的任务优先表格保留五条可见选择从头学 AI Agent、查一个不懂的词、选一个 CLI Agent、把 Agent 接到外部工具、跟着步骤做一个小作品仓库实际还补充了「分清模型怎么学会与被使用」一行每行带编辑评分。编辑评分是本项目的编辑判断不是 GitHub stars——页面中已显式声明这一区别。6.2 用大白话定义 MCPSkillPlugin仓库RESOURCES.md第 20-29 行的实现提供了标准口径MCPModel Context Protocol让 AI 应用用共同方法连接外部资料与工具的开放协定像一种共用插座连上后能做什么仍由 server、账号权限与用户核准决定Skill一包可重复使用的做事方法通常包含指令也可以附脚本、模板与参考资料不同产品放置与加载 Skill 的方式可能不同Plugin某个 host 提供的安装包可一起带入 Skill、指令、hook 或 MCP 设定Plugin 不是 MCP 规格的一部分各产品格式不一定相同。计划强调不要暗示所有 host 以相同方式实现 plugin。6.3 五个可见的安全起点以官方入口或完整教材开头再挑社群项目官方 MCP Registry发现入口、modelcontextprotocol/servers学协议功能教学用 reference servers不等于 production 推荐、anthropics/skills看 Skill 文件夹与指令资源组合、github-mcp-server学 OAuth、工具组与 repository 权限、Hello-Agents中文教材系统学 Agent 原理与实作。页面同时保留最高优先级的权限警告先少给钥匙read-only 与最小权限先行writesenddelete 前保留人工核准。6.4 可见精选表精确的 43441 行组分RESOURCES.md第 51-81 行给出了落地样例表格包在div classresource-table-scroll roleregion tabindex0 aria-label精選資源表可左右捲動内横向可滚动区域列结构为「分类资源能帮你什么状态限制编辑评分」按 5 个tbody分组rowspan分别为 4、3、4、4、1笔记知识库4Notion MCP官方 hostedOAuth权限跟登录者、mcp-obsidian社群、Gemini Notebook 旧名 NotebookLMGoogle 服务可用性会变、notebooklm-py非官方接口办公文件3anthropics/skills官方示例、claude-office-skills社群、Google Workspace MCP官方Developer Preview每产品独立 serverOAuth 2.0开发协作4GitHub MCP Server官方OAuth 或最小权限 token、Atlassian Rovo MCP官方 hosted remoteOAuth 2.1写入前人工核准、Linear MCP官方 hosted remoteStreamable HTTP另有 read-only 选项、Slack MCP官方传送或改动前人工确认研究工作流4ai-research-skills、research-hub、zotero-skills、codex-delegate均为 WenyuChiou 系列社群项目中文生态1feishu-docx飞书文档与 Markdown 转换。计划强调优先 hosted NotionLinearSlackAtlassian 官方条目而不是过时的社区默认值更长补充清单awesome-lists、课程、Canva MCP 等收进关闭的details。6.5 保持下一站可见Glossary、Cookbook、Model Training Guide 与贡献入口style-guide、CONTRIBUTING保持在折叠块之外。七、Task 4重写繁中资源索引resources/README.md以任务地图开头七个参考目的地glossary、cli-agents-guide、mcp-skills-catalog、schema-design-cheatsheet、cookbook、setup-guide、style-guide以「你现在卡在哪里先打开这一份」的表格呈现没有行数、目录总数或时间估算仓库第 9-25 行即此形态保持新手路线可见明确读者不需要按顺序读完整份参考区Stage 0 是学习起点glossary 与 cookbook 是查询练习工具次要治理细节折进折叠块为什么不分装成一本厚书、以及 Maintainer 的三语覆盖与新增 reference 规则至少两个关闭的details markdown1。规则要点新增 reference 需有既有文件无法取代的工作、至少三个 stagetrackbranch 需要它、名词与安全规则能三语一致、只服务一个章节就留在章节内zh-TW 是 canonical官方来源查证找不到时明写未知不保存会漂移的 stars 与固定总数。八、Task 5MCPSkills 目录的渐进披露与时效化resources/mcp-skills-catalog.md是仓库中体量最大、条目最多的目录三个语言版本合计 80 条目test_catalog_entry_urls_and_editorial_ratings_match_in_all_locales断言len(observed[0]) 80且三语完全一致。8.1 可见的五星起手区块在分类列表前先分清五个词MCP Server、Skill、Plugin、Remote MCP服务商托管通常 OAuth 登录、Permission Boundary权限边界。随后展示五个带编辑评分的可见安全起点与权限警告第 23-33 行。8.2 17 个分类标题全部可见每个编号## N.标题保持在details之外计划规定恰好 17 个关闭折叠体与编号 1-17 一一对应测试第 344-349 行逐项核对标题下紧跟一句「何时使用本类」的说明然后是承载既有条目的折叠正文。8.3 保留锚点与编辑评分不要为缩短页面而重命名###条目标题或删除已评分的项目删除| Stars |行与易变的流行度措辞保留许可证、维护状态、封存标记、Preview、权限与数据写入限制如 Sentry 条目同时锁定 canonical 仓库、License 与三个包名标识见test_sentry_catalog_uses_canonical_repo_and_preserves_mcp_identity。8.4 替换过时默认值hosted Notion、当前 LinearStreamable HTTP、官方 Slack、Atlassian Rovo、GitHub、Google Workspace、Canva 条目更新为当前状态历史或社区替代品只有带明确状态原因说明才可保留Notion条目就注明了旧开源包不再积极维护。8.5 运行繁中测试python -m pytest scripts/test_public_entry_resources.py scripts/test_catalog_counts.py -q python scripts/check-reader-ux.py python scripts/check-catalog-counts.py --quiet九、Task 6委托生成 enzh-Hans 精确镜像三语镜像不手写全部内容而是走「受约束委托」流程冻结事实与结构委托简报必须列出精确 URL、行组分、17 个分类 ID、评分、必需状态词、禁止的过时模式与「不加额外文件」规则对应创建.ai/codex_task_public_resources_locale_mirrors.md与修改六个*.en.md*.zh-Hans.md镜像运行受约束的 Codex 委托先codex --version确认可用再以--brief-file传入简报、以 worktree 作为--repo调用委托代理只能翻译与镜像结构不得做研究、改评分、加项目、改测试、暂存、提交或推送读取结构化结果并拒绝漂移将files_changed与六文件白名单比对逐项复查 URL、状态、评分、折叠边界、标题与锚点后才接受。这套流程体现了「父仓库拥有事实委托代理只做镜像」的分工原则也是后面独立审查步骤的前提。十、Task 7文档、全量门禁、人工审计与 stacked PR10.1 记录设计契约在docs/TESTING_PLAN.md与stages/DESIGN.md中记录可见任务优先选择、可见精选起点、分类标题落点、关闭的长正文、编辑评分与无易腐数字规则CHANGELOG.md使用 API 响应日期与最终 diff不是记忆记录变更。10.2 有序验证命令计划给出完整的门禁顺序若个别脚本暴露不同 CLI以scripts/README.md的正式命令为准git diff --check python -m pytest scripts/test_public_entry_resources.py scripts/test_catalog_counts.py -q python scripts/check-reader-ux.py python scripts/check-catalog-counts.py --quiet python scripts/check-anchors.py --strict python scripts/test_anchor_slug_parity.py python scripts/check-mirror-parity.py python scripts/check-locale-links.py python scripts/zh-hans-localize.py --check python scripts/check-hans-chars.py python scripts/check-image-locale.py --strict python scripts/check-duplicate-repos.py python scripts/check-2026-freshness.py python -m pytest scripts -q python scripts/build-docs-tree.py python -m mkdocs build各门禁对应仓库中已存在的检查器scripts/check-anchors.py、scripts/check-mirror-parity.py、scripts/check-locale-links.py、scripts/zh-hans-localize.py、scripts/check-hans-chars.py、scripts/check-image-locale.py、scripts/check-duplicate-repos.py、scripts/check-2026-freshness.py均有同名测试文件佐证。10.3 人工落地审计新读者不用展开任何折叠块就能选出一个下一步动作必备精选起点与评分可见每个隐藏项都有可见的分类落点与有用的摘要17 个目录分类仍可按标题锚点搜索三个语言版本陈述相同的事实与警告没有重要概念、项目、评分或深层链接消失。10.4 冻结、审查、提交与推送仅暂存明确列出的文件并把暂存数量与冻结白名单比对记录git write-tree因为 diff 超过 50 行、改动超过三个文件且包含委托产出必须运行恰好一次独立的 code-reviewer任何字节变化都会使审查失效。提交信息为content(resources): make the public catalog task-first推送并基于codex/everyday-user-reader-ux-stack打开 PR保持 PR 未合并并在用户明确批准合并与清理前保留所有分支worktree。十一、验收标准计划以八条验收标准收尾前三条聚焦可见性结构后五条聚焦内容纯净度与流程完整性RESOURCES无需展开任何内容即可看到五个任务选择、五个安全起点与当前的 MCPSkillPlugin 定义长精选表保持关闭使用精确43441行组分且三语 URL评分一致资源索引任务优先无固定行数、总数或阅读时间宣称目录保留全部 17 个编号 H2 锚点可见恰好 17 个关闭的分类正文保留所有条目标题与编辑评分数字 GitHub stars、8176营销数字、固定 Canva 工具总数、过时 NotionLinearSlack 默认值、未加限定的 NotebookLM 显示名均从公开页面消失当前官方状态与权限限制陈述准确所有机器门禁、渲染构建、人工落地审计与独立审查在最终暂存指纹上通过PR 保持开放未合并供用户检查。十二、如何在仓库中复现与继续深入想要验证这套改造逻辑可以直接在仓库中运行下列命令并观察输出python -m pytest scripts/test_public_entry_resources.py scripts/test_catalog_counts.py -q python scripts/check-catalog-counts.py --quiet python scripts/check-reader-ux.py想看「可见性断言」如何绕过折叠块阅读 scripts/test_public_entry_resources.py特别是第 175-187 行的_without_details与第 272-285 行的行组分校验想看「机器计数不对外宣传」的实现阅读 scripts/check-catalog-counts.py 与 scripts/test_catalog_counts.py想看读者体验门禁的配置形态禁止出现在折叠摘要中的词汇、每页可见字符上限、锚点对齐阅读 scripts/reader-ux-pages.yml三个被改造的页面样本RESOURCES.md、resources/README.md、resources/mcp-skills-catalog.md以及各自的三语镜像完整流程契约与测试计划见 docs/TESTING_PLAN.md、stages/DESIGN.md 与 CHANGELOG.md。这套「测试先行锁定可见性 → 退役易腐数字 → 渐进披露重写 → 受约束委托镜像 → 全量门禁与独立审查」的流程不依赖任何具体框架可作为任何多语言、多分类的公开资源型仓库做入口体验改造时的直接参照。赞分享教程文档AI Agent人工智能大模型【免费下载链接】awesome-agentic-ai-zhA trilingual (繁中 / English / 简中) learning roadmap for agentic AI: from LLM basics to multi-agent systems, with 240 curated resources and hands-on examples. 中文 AI agent 學習地圖。项目地址https://gitcode.com/gh_mirrors/aw/awesome-agentic-ai-zh点击查看免费下载相关推荐awesome-agentic-ai-zh Track A2 渐进式披露改造让 CLI 规则卡与 Skill 一次看懂的可复现工作流设计awesome agentic ai zh Track A2 渐进式披露改造让 CLI 规则卡与 Skill 一次看懂的可复现工作流设计 本文聚焦该开源学习地教程文档AI Agent人工智能大模型awesome-agentic-ai-zh Stage 02 渐进式披露设计四格 Prompt、Eval 回路与精选资源重构提示工程入门awesome agentic ai zh Stage 02 渐进式披露设计四格 Prompt、Eval 回路与精选资源重构提示工程入门 导读 本文以 do教程文档AI Agent人工智能大模型awesome-agentic-ai-zh 相关资源导航从任务入口、核心术语到 MCP 与 Skills 精选集成awesome agentic ai zh 相关资源导航从任务入口、核心术语到 MCP 与 Skills 精选集成 本文是 awesome agentic a教程文档AI Agent人工智能大模型上一篇如何永久保存微信聊天记录3步实现数据掌控与深度分析下一篇MSBuild 二进制日志binlog生成实战指南用 /bl:{} 为每次 .NET 构建捕获完整执行轨迹创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考