Web 实践
Web 实践
Web 项目的 AI Coding 实践
概述
本节介绍在 Web 项目中应用 AI Coding 的具体实践，基于 Next.js / TanStack Start 项目的实际经验。
实践内容
| 文档 | 说明 |
|---|---|
| AGENTS.md 规范 | 项目协作规范入口文件 |
| 项目配置 | PROJECT_STATE、Git 策略、上下文管理 |
| 代码审查 | 质量审查、对话评审、工作流阶段 |
| Skills 实践 | biome 等具体 Skill 实践 |
快速开始
方式一：使用脚手架（推荐）
安装 agents-markdown 后，在 Agent 对话中输入：
请从 .ai-coding/ENTRY.md 开始，按其中流程初始化这个项目的 AI Coding 脚手架。Agent 会通过问答自动生成所有配置文件。
方式二：手动创建
- 在项目根目录创建
AGENTS.md - 若使用 Claude Code，再创建
CLAUDE.md（0.1.4 起建议作为跳转壳） - 参考 项目配置 填写内容
生成的文件
| 文件 | 作用 |
|---|---|
AGENTS.md | 协作规则主入口 |
CLAUDE.md | Claude Code 兼容入口（跳转壳） |
docs/WORKFLOW_TEMPLATES.md | 工作流 SOP |
docs/PROJECT_STATE_TEMPLATE.md | PROJECT_STATE 模板 |
docs/REVIEW_TEMPLATES.md | 评审标准 |
docs/ARCHITECTURE.md | 项目架构详解 |
PROJECT_STATE.md | 任务状态记录（执行时自动创建） |
适用项目
- Next.js App Router
- TanStack Start / Router
- React + Vite
- 其他现代 Web 项目