【5】 7 天上手计划与 FAQ

## 7 天学习计划

按天执行，每天 1–2 小时即可。有 Vue/TS 基础的同学可压缩到 5 天。

| 天 | 主题 | 做什么 | 产出物 |

|:--:|------|--------|--------|

| **1** | 观念 | 读系列第 1 篇；笔记「人 vs AI 分工」 | 1 页笔记 |

| **2** | 工具 | clone `ai-native`；熟悉 Rules/Skills | Agent 能列出项目 Skill |

| **3** | 规划 | 练 planning-with-files | `task_plan.md` 一份 |

| **4** | 流程 | brainstorming → writing-plans（可不真写代码） | 实现计划一份 |

| **5** | 规范 | 读 fullstack-dev-standards；做列表 CRUD 练习 | 通过第 4 篇验收清单 |

| **6** | 质量 | 对自己 diff 跑 code-review；补 1 个单测 | Review 记录 |

| **7** | 沉淀 | 把踩坑写进 Skill 或团队文档 | 1 条可合并改进 |

### 第 5 天练习建议（文件列表 CRUD）

不依赖特定后端时，可用 Mock 数据，但须：

- 列表：loading / error / empty / 分页  

- 新增/编辑：表单校验 + submitting 防重  

- 删除：二次确认  

- 代码分层：views / components / composables / services / types  

**毕业标准**：能独立用 Spec + Skill 完成上述模块，并口头说明「哪些决定不能交给 AI」。

---

## 本仓库 Skill 速查

| Skill | 何时用 |

|-------|--------|

| **fullstack-dev-standards** | 写/审前后端页面与接口 |

| **planning-with-files** | 多步骤、研究型任务 |

| **superpowers** | 流程总控（见下表） |

| ↳ brainstorming | 动手前对齐设计 |

| ↳ writing-plans | 写实现计划 |

| ↳ test-driven-development | 功能/修复前先写测试 |

| ↳ systematic-debugging | 遇 bug 先查根因 |

| ↳ verification-before-completion | 声称完成前 |

| ↳ requesting/receiving-code-review | 合并前后 |

| **code-review** | PR 审查 |

| **code-simplifier** | 提交前简化刚写的代码 |

| **webapp-testing** | Playwright 测本地 Web |

| **ralph-loop** | 长任务迭代直到完成 |

| **ui-ux-pro-max** | 提升 AI 生成 UI 审美 |

| **mcp-builder** | 自建 MCP 服务 |

| **skill-creator** | 编写团队自有 Skill |

安装更多社区 Skill：

```powershell

# 在 ai-native 仓库根目录，需可访问 GitHub

.\scripts\install-claude-top10-skills.ps1

```

---

## 常见问题 FAQ

**Q：AI 写的代码要不要全接受？**  

A：不要。你是合并闸门：审范围、审规范、跑测试。用 `verification-before-completion` 约束「完成」的定义。

**Q：Rules 和 Skill 放项目还是用户目录？**  

A：团队统一规范 → 项目 `.cursor/`（随 Git 共享）；个人习惯 → `~/.cursor/`。

**Q：一句话让 AI 做整页行不行？**  

A：改文案、调样式可以；新功能不行。大需求必拆 Spec + Plan。

**Q：Chat 和 Agent 怎么选？**  

A：单文件小改 → Chat；多文件、要跑命令、按 Plan 执行 → Agent。

**Q：Skill 从哪来？**  

A：官方 [anthropics/skills](https://github.com/anthropics/skills)、社区 [superpowers](https://github.com/obra/superpowers)、团队自建（skill-creator）。

**Q：和 Copilot / 其他 IDE 通用吗？**  

A：理念通用（Spec、清单、分层）；Rules/Skills 格式以 Cursor 为主，其他工具可移植为自定义指令或 AGENTS.md。

**Q：内网环境用不了 GitHub 怎么办？**  

A：Skill 可内网 Git 镜像；核心规范在 `fullstack-dev-standards`，不依赖外网即可用。

**Q：如何贡献？**  

A：向 `ai-native` 提 PR：更新 `docs/`、`.cursor/skills/` 或培训文档；规范变更注明版本。

---

## 延伸阅读

### 仓库内

| 文档 | 说明 |

|------|------|

| `docs/AINative入门手册.md` | 系列合并版 |

| `T型人才-前端培训文档.md` | 环境、模板、部署详版 |

| `.cursor/skills/fullstack-dev-standards/SKILL.md` | 50 题规范全文 |

### 外部

- [Cursor 文档](https://docs.cursor.com/)  

- [OpenSpec](https://github.com/Fission-AI/OpenSpec)  

- [Superpowers](https://github.com/obra/superpowers)  

- [Anthropic Skills](https://github.com/anthropics/skills)  

- [shadcn-vue](https://www.shadcn-vue.com/) · [Tailwind CSS](https://tailwindcss.com/)  

---

## 系列回顾

| 篇 | 标题 | 你应带走的一句话 |

|:--:|------|----------------|

| 1 | AI-Native 是什么 | 能跑 ≠ 能上线 |

| 2 | 工具链入门 | Rules 常开，Skills 按需 |

| 3 | 第一条工作流 | Spec 先行，分步交付 |

| 4 | 交付标准 | 清单挡在合并前 |

| 5 | 7 天计划与 FAQ | 跟练仓库，沉淀 Skill |

---

## 下一步行动

1. **Clone** `ai-native`，用 Cursor 打开。  

2. **第 3 篇工作流** 跑一遍最小练习（planning-with-files）。  

3. 在业务项目 `.cursor/rules` 写入你们栈的硬约束。  

4. 把本次踩坑 **回写 Skill**，缩短团队下一轮试错。

---

*感谢阅读「AI-Native 开发入门」全系列。欢迎评论交流实践中的踩坑与改进。*