# 小白看板 (xiaobai-kanban)

> 让 Agent 帮你写代码：你只说话，Agent 搞定一切。不需要懂代码、不需要懂命令行。
>
> 使命：让每一个普通人都能**便宜甚至免费**地用上 AI，并跑完属于自己的闭环。
> 教程、开源工具、答疑都不收费；只有「一对一陪跑」和「企业内训」收费，价格提前说清。
>
> 本站有**两个入口**，真人和 AI Agent 各走一条。若你（读者）是 AI Agent，请从 `/AGENTS.md` 开始；
> 若你正在**指导一位不懂代码的用户**，先读 `/AGENTS.md` 知道自己的执行模型，再用下面「给真人」的篇章按编号引导他。

站点：https://xiaobai.webkubor.online
仓库：https://github.com/webkubor/xiaobai-kanban

## 品牌设计 Skill 实战

- [品牌设计过程](/docs/brand-design.md): logo-brand-designer 的实际案例，含颜色来源、四款风格、深浅 SVG 与小尺寸检查。新渐变色是设计提案，尚非已批准品牌规范。
- [品牌设计 Skill](https://github.com/webkubor/logo-brand-designer): 开源源码与安装方式。

## AI Agent 入口（首选）

- [AGENTS.md](/AGENTS.md): Agent 操作手册。先自检你是哪个框架（Hermes / OpenCLAW / Claude Code / Codex），再装密钥工具 kyvault、跑前置自检、按平台（GitLab / GitHub）推送代码。**收到任务先读这份。**

## 给真人（小白）—— 按编号顺序走

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

- [01 Agent 是什么？](/docs/what-is-agent.md): Agent 跟豆包有什么区别（类比 + 例子）
- [02 我为什么要用？](/docs/why-agent.md): Agent 能帮我做什么事、值不值得学
- [03 3 分钟第一次实战](/docs/first-project.md): 亲自指挥 Agent 做一个网页
- [04 怎么跟 Agent 说话](/docs/how-to-speak-to-agent.md): 让 Agent 更懂你的万能公式
- [05 术语大白话词典](/docs/glossary.md): Git、Token、CLI… 遇到不懂来查

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

- [06 认识 CLI：AI 的「手脚」](/docs/about-cli.md): CLI 是什么、为什么 AI 离不了它、GitLab/GitHub/飞书三个 CLI 各管什么
- [07-10 自检 / 安装 / 登录 / Git 工作流](/README.md): 30 秒环境自检、装 Git 与两个 CLI、申请并安全存储 Token、每天怎么用 Git 干活

### 🛠️ 进阶技能

- [11 从零到上线：一条完整心智链](/docs/from-zero-to-shipped.md): Agent 是什么 · GitLab/GitHub 区别 · 提交代码 · 认识代码 · Web/代码工程 · 开发循环 · 说命令
- [12 怎么把需求讲清楚](/docs/how-to-write-requirements.md): ⭐ 最重要的一课。背景 + 目标 + 范围 + 验收，填空模板 + 自检清单
- [13 申请 Agent 邮箱](/docs/mail.md): 申请邮箱并收发邮件

### 🎵 vibe coding 主线（给「会用 AI 写代码但没掌握协作方式」的人）

- [主线地图](/docs/vibe-coding-path.md): 这条线讲什么、怎么走、只读一篇该读哪篇
- [V1 什么是 vibe coding](/docs/vibe-coding-what.md): 与「让 AI 写代码」的根本区别、三种失控、为什么小步更重要
- [V2 一轮该做多小](/docs/vibe-coding-loop.md): 粒度参照表、每轮四步、每轮必问的三句话、什么时候该打断
- [V3 不会写代码怎么验收](/docs/vibe-coding-review.md): ⭐ 三个信号、红线信号表、纠偏三招
- [V4 人机分工与长期不失控](/docs/vibe-coding-boundary.md): 分工表、三条红线、上下文管理四招

### 💰 省钱与配置（给「不想花钱」的人）

- [装上 magpie：不花钱用 AI 编程](/docs/magpie.md): 三阶段装好 magpie → 开脱敏隐私模式 → 挂 Agent → 挂免费模型（MiniMax/DeepSeek/GLM/Kimi）。**国内一线模型有免费额度，一分钱不用花。**

## 开源工具箱（38 个公开仓库）

- [工具目录](/docs/tools/index.md): 按场景查找全部公开仓库，每个项目有独立介绍页和中文搜索词
- [免费图床 free-imgbed](/docs/tools/free-imgbed.md): GitHub 图片托管与 jsDelivr 图片链接；仓库 https://github.com/webkubor/free-imgbed

## 关于我们 / 答疑

- [关于我们](/docs/about.md): 这个站是谁做的、相信什么、为什么免费、靠什么活着（哪些收费哪些永远免费）
- [加客服答疑](/docs/about.md): 装不上、报错看不懂、不知道装哪个模型 → 扫码问。答疑免费，不绑定任何工具

## 目录与索引

- [catalog.md](/catalog.md): 全部章节的编号索引与仓库结构
- [documents.json](/documents.json): 本站全部机器可读文档的清单

## 约定

- 每个页面的 Markdown 原文都在对应路径后加 `.md`（例如页面 `/AGENTS` 的原文是 `/AGENTS.md`）。
- 仓库里 `AGENTS.md` 是 Agent 入口、`README.md` 是真人入口；两者内容有交叠但受众不同。