教程文档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点击查看免费下载本篇文章基于本仓库的 Track A 渐进式披露重整计划docs/plans/2026-08-27-track-a-progressive-disclosure.md并结合 tracks/cli/ 下 A1–A3 三站的实际改造成果与 scripts/check-reader-ux.py 的源码实现完整还原如何让一份 CLI agent 学习路径做到『不展开任何菜单也能开始动手』并讲解配套的自动化质量门禁reader-UX ratchet如何在三语仓库中防止页面悄悄退化。读者读完本文能掌握渐进式披露progressive disclosure在技术文档/学习路径中的具体落地方法——包括可见主线的七要素编排、details默认收合的取舍原则、语义化 HTML 表格tbody/scoperowgroup/ 真实rowspan的正确写法以及如何用源码级检查器把可读性变成可以回归测试的契约。1. 背景CLI 学习路径为什么需要一次披露重构Track AA1–A3是本仓库面向终端 CLI 用户的主线路径A1 负责选一个 CLI agent 安全完成第一个小任务A2 负责把重复交代变成规则卡与 SkillA3 负责把 agent 接进安全的团队流程MCP / CI / observability。2026-08-27 的重整计划发现这套路径最大的问题不是内容不够而是信息全部摊开在页面上读者第一次打开页面时时间、费用、先备条件、完整工具表、所有练习步骤、全部资源一涌而出反而找不到我此刻只要做哪一件事。计划把问题表述为三个不展开也能回答的问题作为全站重构的成功标准这一章要帮读者做什么读者现在只要做哪一件事做对了会看到什么原文特别强调五岁也看得懂是清楚度标准不是幼儿语气第一次出现的名词先用一句白话说明再保留正确的术语、命令、文件名、安全限制与官方来源。所有完整工具表与资源表都改用语义化 HTML table相同分类只显示一次使用tbody、scoperowgroup与真正的rowspan不以空白单元格假装合并。2. 现状诊断四个页面、三个数字、一批事实缺陷计划用未展开可见字符数与details数量两个指标给四个页面做了术前测量页面未展开可见字符details核心问题A14,2430工具身份混在一起四个练习与完整排行一次摊开A25,2850旧 command 格式、错误的截断说法、资源与主练习混在一起A311,6670四个练习、七个 playbook、九个项目全部可见CLI 指南5,5550主观排行、易变 stars、旧 repo 路径与未证实精确数字太多重构同时纠正了一批会自然变旧的事实缺陷这些在正文落地时都改成了可验证的表述OpenCode的 canonical repo 是anomalyco/opencode现行 V2 项目规则只使用AGENTS.md不再使用旧版CLAUDE.mdfallback也不是OPENCODE.md详见 resources/cli-agents-guide.md 中 OpenCode 一行。goose的 canonical repo 是aaif-goose/goose不再链接搬迁前路径。Claude Code已把 custom commands 并入 Skills.claude/commands/仍兼容但新教学应使用.claude/skills/name/SKILL.md。CLAUDE.md不存在超过 100 行就截断的规则官方目前建议每份维持在 200 行以内并强调具体、简短、可验证。Pi是可扩展的 terminal coding harness不是模型、API provider 或 OpenRouter 的别名它的 project trust 只控制项目资源加载不是 sandbox。examples/README.*曾宣称 Track A 有 CLI-9CLI-10 两个资料夹但仓库实际没有examples/track-a/必须改成Track A 是 12 个 inline 练习、没有独立资料夹的事实。A2、A3 的英语与简体中文缺少完整进入条件现有 mirror 不是语义等价——三语必须逐项对齐。3. 先把五种东西分清楚全站共用心智模型A1 用同一张短表建立全站共用心智模型防止OpenRouter 是 CLI、Ollama 是 agent这类身份混淆种类白话说法例子canonical homeLLM会生成答案的脑Claude、GPT、GeminiStage 01Provider API直接通往模型公司的门Anthropic API、OpenAI API、Gemini APIStage 01setup guideRouter一个入口替你转接多家模型OpenRouterA1Stage 07 讲 production routingCoding agent / harness在终端读文件、改文件、跑命令的工作台Claude Code、Codex、OpenCode、PiA1–A3Local runtime在自己电脑上把模型跑起来的引擎OllamaStage 01这张身份表保持可见各产品的安装、计费、provider、sandbox 与限制则放进默认收合的详情表。落地后的 tracks/cli/A1-cli-intro.md 把同一张表扩展成它是/像什么、A1 怎么用、不是什么三列并明确写出边界LLM 不会自己管理 repo、文件权限或账单Router 不是 LLM 也不管理文件权限Local runtime 不会自己读 repo——不确定时只问三句谁执行模型谁转送请求谁能读写我的文件4. A1先认东西再安全地跑一次4.1 不展开时看见什么七要素A1 重构后未展开的页面上依次出现适合谁 → 三个学习目标 → 五种身份短表 → 依你已经有什么的短选择表不做总排名→ CLI-1在测试文件夹或 demo repo 内完成一次只读型任务→ CLI-2 的标题、锚点与一句话成果 → 三项成功检查与 A2 入口。关键设计决策CLI-1 不再用整理 Downloads 并移动文件当第一个任务。第一步改成让工具说明 demo repo、找出测试指令、提出计划读者确认后才做一个可由git diff看见、可复原的小改动。A1 页面上直接给出可复制请求请只读取目前的 demo repo说明它的用途、找出测试指令并提出一个小型文件改动计划。先不要修改文件、不要删除文件也不要执行会改变数据的命令。完成后的可验证成果是repo 摘要、测试指令、待确认计划以及工具要求权限时的提示。4.2 默认收合什么时间、先备条件、费用与账号CLI-2 详细步骤CLI-3 第二工具比较与 CLI-4 认证错误实验指向 CLI 指南完整九工具事实表的阅读入口完整学习资源与疑难排解。CLI-1 至 CLI-4 的标题、锚点与一句话成果都留在details外避免既有深链接如a idcli-1失去落脚点——这一点在 tracks/cli/A1-cli-intro.md 中由四个a idcli-1…a idcli-4锚点可见地实现。4.3 工具表规则把易变事实与编辑评分分开不显示 stars也不用五颗星做人气评分状态只描述官方可证实现况不把最新最强社区最快当事实。A1 只保留短选择表与身份识别9 个现行 CLI 的完整事实表只在 resources/cli-agents-guide.md 维护含安装、认证、provider、安全起手式、状态与官方来源 8 个固定栏位避免两页同步漂移。完整表只保留两个真正共用的分类并用rowspan合并官方模型生态4 行、可换 provider5 行Pi 的 minimal 特性与 Hermes 的多界面特性写进各自内容栏不再为单笔数据制造分类单元格。Pi 列为 minimalextensibleOpenRouter 放在 Router、Ollama 放在 local runtime两者都不列成 CLI agent。4.4 直接一致性范围A1 三语、CLI 指南三语、glossary 的五种身份三语同步把写死旧 OpenCodegoose 路径或固定8 家的入口文字改成不易漂移的CLI 工具比较examples/README.*的 Track A 现状改成 12 个 inline 练习CLAUDE.md与 docs/TESTING_PLAN.md 的 Track A 现状列移除失真的行数与 8-CLI 说法。5. A2把重复交代变成一张规则卡5.1 不展开时看见什么一句目标让工具每次进 repo 都先知道同一套规则→ 三个核心词project instructions、Skill、单次 prompt→ CLI-5写一份最小规则文件→ CLI-6用SKILL.md格式做一个可重复 review Skill→ 成功检查与 A3 入口。三个核心词在 tracks/cli/A2-cli-workflow.md 中被这样区分核心词它是/像什么A2 怎么用不适合放什么Project instructions项目规则每次进工作室都要看的共同守则放项目用途、禁止事项、测试指令与交付格式不放只用一次的任务或长篇参考资料Skill操作卡有需要时才拿出的可重用操作卡放 review、release、整理文件等重复流程不是每家 CLI 都使用相同路径、权限或 frontmatterOne-off prompt单次提示只交代今天这一件事的便条放本次任务、范围、输入与成功条件不用它重复贴上每次都相同的项目规则5.2 CLI-5最小项目规则卡可直接复制# 项目规则 - 用途这是一个练习用文件 repo。 - 不可做不要删文件、不要读取秘密、不要自动 commit 或 push。 - 验证修改后执行 git diff --check。 - 回报说明改了什么、验证结果以及仍未处理的事。验证路径同样被要求看得见开新 session 请 agent 只读规则并用自己的话复述给一个会碰到禁止事项的测试如直接 commit 这个改动正确结果是 agent 停下来或先询问。规则文件若为新文件Git 显示??git restore无法移除可保留为练习成果。没有任何行数能保证规则一定好——只保留会改变行为的内容某段只在特定任务使用时移到 Skill。5.3 CLI-6把重复 review 做成 SkillClaude Code 使用.claude/skills/review-changes/SKILL.mdCodex、Gemini CLI、OpenCode 可使用.agents/skills/review-changes/SKILL.md--- name: review-changes description: Review the current git diff and report concrete risks. Use when the user asks to review local changes. --- 1. Read git diff --no-ext-diff HEAD without changing files. 2. Check for secrets, unsafe commands, broken links, and missing verification. 3. Report PASS when no problem is found; otherwise list each problem with its file and reason. 4. Do not edit, commit, push, deploy, or send messages.name是操作卡名称description告诉 agent 何时拿这张卡。各工具的规则文件与 Skill 位置对照官方查核日 2026-08-30 UTC工具项目规则Project Skill要注意什么CodexAGENTS.md.agents/skills/name/SKILL.md规则会依目录分层较近的规则较晚加载Claude CodeCLAUDE.md.claude/skills/name/SKILL.md旧.claude/commands/仍兼容但新流程优先用 SkillGemini CLIGEMINI.md.agents/skills/name/SKILL.md或.gemini/skills/…Skill 启用时会要求同意不要把秘密放进 SkillOpenCodeAGENTS.md优先无此文件时用CLAUDE.md.opencode/skills/…、.agents/skills/…或.claude/skills/…先查 rules、skills 与 permission 设定共同的是要交代哪些事不同的是文件名、搜索位置、权限与额外设置——不要把某个工具专属功能当成所有 CLI 都有。5.4 事实修正与边界移除 30–50、50、100 行等无官方依据的硬门槛只保留官方每份建议低于 200 行与只留下会改变行为的规则。不再教新手先做 legacy command改教 Skill并用一句话说明旧 command 仍可运作。不宣称一份文字可原封不动跨所有 CLI清楚区分共用内容与工具专属文件名权限。本层仍不新增examples/track-a/现有 repository contract 明确 Track A 保持 inline若 Stage 05 重整后要新增静态示例包须另作设计决定不在 A2 偷渡。6. A3先完成一个小而安全的 production loop6.1 三个核心词与安全阶梯A3 的三个核心词在 tracks/cli/A3-cli-production.md 中被定义为MCPModel Context Protocol让 agent 连外部工具或数据的标准转接头CIContinuous Integrationpush 或 PR 出现时自动工作的检查站Observability像收据加行车记录留下发生过的事。三个词会一起出现但不是同一件事MCP 负责接工具CI 负责何时自动跑observability 负责跑完留下什么证据。可见的安全阶梯安全底线只读先让 agent 看数据不让它改数据。最小权限只开这次需要的文件夹、repo、tool 或 token scope。demo repo先在可丢弃的练习环境测试。人工 review人决定要不要采用 agent 的建议。最后才考虑写入auto-merge、push、deploy 不属于这一站。6.2 CLI-9只连一个 MCP server可复制命令先建一个 demo 文件夹PowerShell 与 macOSLinux 两套命令都提供New-Item -ItemType Directory -Force -Path a3-mcp-demo | Out-Null Set-Content -LiteralPath a3-mcp-demo/hello.txt -Value hello from A3mkdir -p a3-mcp-demo printf hello from A3\n a3-mcp-demo/hello.txt把官方 filesystem reference servermodelcontextprotocol/server-filesystem接到 CLI 时只传入这个文件夹的绝对路径成功时 agent 能读出hello.txt要求读范围外的文件应失败或要求重新授权。若需读 GitHub PRissue改用github/github-mcp-server先--read-only再用 toolsetstools allow-list 只开需要的能力官方 reference servers 明确不是 production-ready旧githubreference server 已移入历史集合。6.3 CLI-10让 PR 多一个只读检查员选官方 actionAnthropic 的claude-code-action或 OpenAI 的codex-action沿用 A2 的review-changesSkill。安全设定要点API key 放入 GitHub Actions secretGITHUB_TOKEN从contents: read起步Codex 只读工作使用官方 action 支持的permission-profile: :read-onlyprompt 明写不得 editcommitpushmergedeploy先用自己建立的 same-repo test branch不用pull_request_targetcheckout 不可信 PR code。成功标准不是几分钟内完成而是 workflow 成功结束并留下可阅读的 PR comment、job summary 或 artifact。正式落地时第三方 Action 应 pin 到完整 commit SHA。6.4 CLI-11看一次执行的收据分清订阅方案与按 API usage 计费只有官方提供 token 与单价时才计算input tokens × input price output tokens × output price记录卡字段Task、Providermodel拿不到就写未确认、Usageinputoutput不写模糊的总 token、时间、结果、成本。停止规则必须是工具真正支持的job timeout、最大重试、provider spend limit、付费前人工确认不要发明工具不会读的通用成本设置制造安心感。plan.ymlmax_cost_usd没有跨 Codex、Claude Code、Gemini CLI、OpenCode 的通用规格Prompt caching 的 TTL、资格与价格依 providermodel 而变Anthropic 同时提供默认 5 分钟与可选 1 小时 TTL不能写成永久规则。6.5 CLI-12把 Skill 安全交给队友放可版本控制的 team repo附上四件事安装位置、需要的权限、测试方法、移除方法。分享前读完SKILL.md与附带 scripts保留 plugin 根目录的skills/review-changes/SKILL.md不要把项目自己的CLAUDE.mdAGENTS.md或 secrets 一起打包在第二个干净 demo repo 安装后做一个小 diff执行 Skill再用git status --short确认它只 review 没有改档。6.6 A3b把七个 playbook 变成查问题工具不把七个 playbook 连续摊开可见区只留一张你遇到什么问题表问题先看哪个 playbook任务越做越大Scope多个 agent 互相撞文件Isolationreconciliation不敢相信输出ReviewevalCI 太自由Approvalsandbox账单失控Budgetcache规则慢慢失效Driftfailure injection完整 playbook、来源与项目表放进默认收合区相同来源类别合并第三方文章只作延伸阅读不用来证明工具当前的认证、价格、权限或功能状态。唯一保留可见的 Playbook 4派遣 subagent 跑独立任务是为了避免既有 cookbook 深链接落入收合区——code-reviewer是官方文档中的自定义示例不是每个安装都固定存在内置 subagentExplore、Plan、general-purpose清单会随版本与 session 改变先执行工具自己的 agent list 再选用。7. PR 切法不用一条跨 A1–A3 的长 stack重构计划明确 PR 边界A1、A2 各自合并并验证 main CIA3 因内容量与安全风险较高拆成两层短 stackA1 身份与第一次安全操作 ↓ main CI 绿 A2 可重复规则与第一个 Skill ↓ main CI 绿 A3a MCPCI成本的最小安全主线 ↓ dependent PR A3b playbook、资源与进阶查证每个 PR 都能单独 revert。下层 merge 后dependent branch 重新基于最新origin/main以--force-with-lease更新并重跑全部 gate。8. 源码纵深reader-UX 门禁如何把可读性变成可回归的契约计划中反复出现的reader-UX ratchet不是口号而是一套真实运行的检查器scripts/check-reader-ux.py 配合配置清单 scripts/reader-ux-pages.yml其中track-a1、track-a2、track-a3均已注册入册。它故意只覆盖 manifest 中列出的页面一章只有在三语初学路径都 review 过后才入册从而让旧页面保持可见的同时防止已完成页面悄悄再长出一堵文字墙。8.1 可见度测量analyze_markdownanalyze_markdownscripts/check-reader-ux.py是整套机制的地基它逐行扫描 Markdown 源并维护一个details栈遇到details入栈、/details出栈未闭合的块直接报错N unclosed details block(s)。只有所有祖先 disclosure 都打开的内容才计入可见正文fenced code 内的 HTML 标签是代码而非真实 disclosure不会误开合。输出PageMetricsvisible_chars去掉空白后的可见字符数、details_count、open_details_count、open_summariesclosed_summaries、visible_headings_outside_details。配套正则DETAILS_START_REOPEN_ATTR_RE用于识别默认打开的details open并统计open_details_count max_open即失败——正是所有details默认关闭这一验收标准的机器实现。8.2 核心词契约_core_term_errors_core_term_errorsscripts/check-reader-ux.py实现了计划中的核心词契约三语使用相同 ID、顺序、用途与限制每个词第一次出现在可见正文时必须粗体并在第一个练习前回答它是/像什么、本章怎么用、不是什么。检查器会验证核心词区块必须出现在第一个练习之前每个核心词的首次可见出现必须被**粗体**包裹同时支持strong定义标签如**LLM大型语言模型**必须存在且按配置顺序排列每个定义的纯文本解释长度不得低于min_definition_chars配置中为 20 字符防止只有标签没有解释的偷懒写法H1 页面标题被排除在首次出现检查之外避免标题中的术语误伤。8.3 资源表结构_resource_table_errors_resource_table_errorsscripts/check-reader-ux.py用正则抽取所有table逐组校验每个tbody必须恰好拥有一个scoperowgroup的表头且在首行rowspan必须等于该组实际行数所有列头必须使用scopecol。配置中的resource_group_rowspans如 A1 的[4, 5, 2]、A2 的[4, 4, 4, 2, 2]、A3 的[4, 5, 4, 3, 2]就是同类型只显示一次分类栏、没有空白分类格的机器断言。在此基础上_resource_url_rating_pairsscripts/check-reader-ux.py进一步要求每一行恰好一个外部 URL 与恰好一个 1–5 星编辑评分并以URL→评分成对做三语镜像比对——防止两语悄悄互换评分。8.4 三语 parity 与配置校验checkscripts/check-reader-ux.py按 localezh-TW、en、zh-Hans逐页执行上述检查再做跨语言比对ordered_external_urls要求三语外部 URL 顺序完全一致literals要求特定字面量命令、版本号、日期在三语中出现次数一致。_load_configscripts/check-reader-ux.py对 manifest 做完整 schema 校验schema_version: 1、三语键齐全、路径唯一等从源头拒绝坏配置。注意 manifest 的forbidden_open_summary_termsforbidden_closed_summary_terms分别禁止时间、先备、环境、费用、预算、必修阅读、资源等关键词出现在默认打开的detailssummary 或收合后的 summary 中——学习主线的关键内容不允许藏在收合区。配套测试见 scripts/test_reader_ux.py运行方式python scripts/check-reader-ux.py python -m pytest scripts/test_reader_ux.py -q9. 每个 PR 的查核流程与验收标准计划为每个 PR 固定了八步查核流程编辑前重查官方文件与 GitHub API UTC 日期全量 repo snapshot 以整批扫描完成后取得的官方时间作checked_at不能把扫描期间的新数据标成更早已确认。繁体中文先完成主线、事实、锚点、表格与details。主代理检查不展开也能开始后才同步英语与简体中文。三语逐项比对工具名称、命令、路径、数字、状态、警告与 URL。跑 reader-UX、template、anchor、mirror、locale、Hans、freshness、docs tree 与 MkDocs gates。逐文件 stage记录文件数与 staged fingerprint。最终稳定 diff 只跑一次独立code-reviewer任何修改都让 ack 失效。commit、PR、全绿后安全 merge再验证 main 对应 SHA 的 CI。对应验收标准机器可查 人工确认A1、A2、A3 三语都加入 reader-UX ratchet所有details默认关闭。不展开仍看得到本章目的、第一个行动、完成条件与下一章入口。CLI-1 至 CLI-12 与七个 playbook 的既有深链接仍有可见落脚点。OpenRouter、OpenCode、Pi、Ollama 不再被放在同一产品类型。所有资源表同类字段真正合并没有空白分类格与重复分类字样。Stage pages 不再维护 stars完整表每列有官方来源与 2026-08-27 查核日。三语没有不同的登录、sandbox、secret、费用或安全指引。examples/README.*不再宣称不存在的 Track A 文件夹。10. 官方事实来源与维护原则计划列出了重构所依据的官方查核入口OpenRouter FAQ、OpenCode documentation、Pi documentation、Claude Code documentation、OpenAI Codex documentation、Gemini CLI documentation、goose documentation、Aider documentation、Hermes Agent documentation、Grok Build repository并配套两条维护原则事实字段与热度字段分离工具、登录、价格、sandbox 与 provider 都会变动每次改表前重查官方文件并更新查核日。完整事实表只保留事实栏位安装、认证、provider、安全起手式、状态、官方来源不维护热度或主观评分编辑推荐度⭐⭐⭐⭐⭐表示选这条工具路径时必读必做是学习地图的编辑建议不是 GitHub stars 或总排名。同类数据只维护一份9 个 CLI 的完整事实表只存在于 resources/cli-agents-guide.mdA1 只保留短选择表与身份识别页面之间通过链接互指回到 Track A从结构上杜绝两页同步漂移。11. 总结这套方法可复用到任何长文档学习路径从本仓库的 Track A 重整可以提炼出一套可迁移的做法先定义不展开也能开始的三问成功标准用可见字符数与details数量做术前测量把学习主线目标、核心词、第一个可复制动作、成果、检查、下一站入口留在可见区其余时间费用细节资源默认收合用语义化表格承载完整数据并做三语镜像最后写一个像check-reader-ux.py这样的检查器把可读性锁进 CI——从此每一次编辑都会在合并前被机器审问这一页读者不点任何东西还能不能开始赞分享教程文档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点击查看免费下载相关推荐Track A3 渐进式披露重整全解析如何把 CLI Agent 以只读安全边界接进团队 CI——来自 awesome-agentic-ai-zh 的实战方案Track A3 渐进式披露重整全解析如何把 CLI Agent 以只读安全边界接进团队 CI——来自 awesome agentic ai zh 的实战方案教程文档AI Agent人工智能大模型/eval命令实战用everything-claude-code搭建AI代码质量评估体系的完整指南/eval命令实战用everything claude code搭建AI代码质量评估体系的完整指南 一、为什么你需要 /eval 命令 AI 写代码很快但教程文档AI Agent人工智能大模型TanStack Svelte Form 基础概念与术语完全指南从 Form Options 到 Array FieldsTanStack Svelte Form 基础概念与术语完全指南从 Form Options 到 Array Fields tanstack/svelte教程文档AI Agent人工智能大模型上一篇Omegle Traffic Bot错误处理与日志系统故障排除与性能监控终极指南下一篇内存管理vmalloc与kmalloc的实现差异创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考