📑 小白指导手册 — 目录索引

从零开始，跟着编号走，一步步学会用 Agent 写代码。

---

🧭 新手入口（从这里开始）

编号	章节	你能学到什么
01	Agent 是什么？	Agent 跟豆包有什么区别（类比+例子）
02	我为什么要用？	Agent 能帮我做什么事？值不值得学？
03	3 分钟第一次实战	亲自指挥 Agent 做一个网页！
04	怎么跟 Agent 说话	万能公式，让 Agent 更懂你
05	术语大白话词典	Git、Token、CLI... 遇到不懂来查

🚀 快速上手（装工具 + 学流程）

编号	章节	你能学到什么
06	认识 CLI：AI 的手脚	CLI 是什么、为什么 AI 离不了它、GitLab/GitHub/飞书三个 CLI 各管什么
07	环境自检	30 秒检查你的电脑准备好了没
08	安装工具	装 Git、GitLab CLI、GitHub CLI
09	登录配置	Token 申请 + 安全存储
10	Git 工作流	每天怎么用 Git 干活

🛠️ 进阶技能

编号	章节	你能学到什么
11	从零到上线：一条完整心智链	Agent 是什么 · GitLab/GitHub 区别 · 提交代码 · 认识代码 · Web/代码工程 · 开发循环 · 说命令
12	怎么把需求讲清楚	⭐ 最重要：背景+目标+范围+验收，填空模板 + 自检清单
13	Agent 邮箱	申请 Agent 邮箱 + 收发邮件
14	Agent 配合手册	Agent 怎么读 AGENTS.md 执行任务
15	自动化部署	代码推上去自动上线

🧰 配套工具

工具	用途	地址
kyvault	安全管理密码 / Token	webkubor/kyvault
Agent Eyes	Agent 实时监控前端报错	webkubor/vite-plugin-agent-eyes
contrast-guard	配色对比度 + 视觉质量护栏	webkubor/contrast-guard
VoxFlow	AI 声音到 AI 音乐	webkubor/voxflow
scorecard	开源项目八维度质检	scorecard.webkubor.online

完整工具箱与「把这些仓库当上游」的维护规则见 README。

🧑‍💼 角色指南

角色	入口	说明
👤 小白用户	README.md	从头开始看，跟着步骤走
🤖 AI Agent	AGENTS.md	Agent 读这个，知道怎么干活

📁 仓库结构

xiaobai-kanban/
├── index.md           🏠 站点首页（两条入口：小白 / Agent）
├── README.md          👤 小白入口（学习路径 + 工具箱 + 安装步骤）
├── AGENTS.md          🤖 Agent 入口（操作手册 + 平台指引）
├── catalog.md         📑 本文件（目录索引）
├── LICENSE            📄 MIT 开源协议
├── .vitepress/        ⚙️ 站点配置（VitePress）
├── public/llms.txt    🤖 给 LLM 的站点索引
├── scripts/           🔧 构建辅助（把原文复制进产物）
└── docs/              📝 教程文档
    ├── what-is-agent.md         Agent 是什么（跟豆包的区别）
    ├── why-agent.md             我为什么要用 Agent
    ├── first-project.md         3 分钟第一次实战
    ├── how-to-speak-to-agent.md 怎么跟 Agent 说话
    ├── about-cli.md            认识 CLI：AI 的手脚（CLI vs MCP、GitLab/GitHub/飞书三个 CLI）
    ├── from-zero-to-shipped.md  从零到上线（Agent 是什么、GitLab/GitHub 区别、提交、读代码、Web/代码工程、开发、说命令）
    ├── how-to-write-requirements.md 怎么把需求讲清楚（最重要的一课）
    ├── glossary.md              术语大白话词典
    └── mail.md                  邮件能力配置指南

---

💡 想加新章节？直接对 Agent 说「帮我在小白看板加一篇 xxx 的教程」。