skill/fullstack-task/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: fullstack-task
+description: 辅助 AI 完成全栈开发任务，包括需求拆解、技术选型、前后端实现、数据库设计、API 设计、测试、部署与验收。当用户要求开发功能、修复全栈 bug、设计接口、写数据库模型、做代码审查、搭建项目或交付一个可运行的端到端功能时使用本 skill。
+---
+
+# 全栈任务助手
+
+## 何时使用
+
+在以下场景加载本 skill：
+
+- 用户要求“实现一个功能”且涉及前端 + 后端
+- 用户要求设计 API、数据库模型、组件结构
+- 用户要求从零搭建项目或脚手架
+- 用户要求排查跨层 bug（前端 → API → DB）
+- 用户要求代码审查、重构、性能优化
+- 用户要求生成可运行的端到端交付物
+
+## 核心原则
+
+1. **先澄清，再动手**：需求模糊时必须先确认范围、约束、验收标准。
+2. **端到端思考**：任何功能都要同时考虑 UI、API、数据、错误、测试、部署。
+3. **最小可用优先**：先跑通主链路，再优化扩展性和性能。
+4. **显式优于隐式**：类型、契约、边界、错误码必须明确。
+5. **可运行即交付**：给出的代码要能跑，不能是伪代码，除非用户明确要求。
+6. **不臆造**：不确定的库版本、API 行为、字段名，要标注或询问。
+
+## 工作流程
+
+### 第 1 步：需求拆解
+
+输出一份简短 spec，包含：
+
+- 目标：这个功能解决什么问题
+- 用户故事：谁在什么场景下做什么
+- 范围：做什么 / 不做什么
+- 验收标准：可测试的条目
+- 约束：技术栈、兼容性、性能、时间
+
+如果信息不足，最多问 3 个关键问题，其余用合理默认值并标注。
+
+### 第 2 步：技术方案
+
+按需确定：
+
+- 技术栈：参考 `references/stack-defaults.md`
+- 数据模型：实体、字段、关系、索引
+- API 契约：路径、方法、请求、响应、错误码
+- 前端结构：页面、组件、状态、数据获取方式
+- 部署方式：环境变量、构建、托管
+
+### 第 3 步：任务拆分
+
+拆成可独立验证的任务，每个任务：
+
+- 有明确输入输出
+- 有验收方式
+- 尽量 30 分钟内可完成
+- 标注依赖顺序
+
+### 第 4 步：实现
+
+按 `数据 → API → 前端 → 联调` 的顺序推进。
+
+实现要求：
+
+- 类型完整，避免 `any`
+- 错误处理明确
+- 输入校验（前后端都做）
+- 环境变量集中管理
+- 不硬编码密钥
+- 关键路径加日志
+- 命名清晰，避免缩写
+
+### 第 5 步：验证
+
+至少覆盖：
+
+- 主链路可跑通
+- 边界：空值、超长、非法输入、并发
+- 错误：网络失败、DB 失败、权限不足
+- 构建：`build` / `lint` / `typecheck` 通过
+- 测试：关键逻辑有单测，主链路有集成测试
+
+### 第 6 步：交付
+
+输出：
+
+- 变更文件清单
+- 运行方式
+- 环境变量说明
+- 已知限制
+- 后续建议
+
+## 参考文档
+
+按需加载，不要一次性全读：
+
+- `references/stack-defaults.md`：默认技术栈与选型
+- `references/api-design.md`：REST / RPC 设计规范
+- `references/database.md`：模型、迁移、索引、事务
+- `references/frontend.md`：组件、状态、数据获取、可访问性
+- `references/testing.md`：测试策略与用例模板
+
+## 模板
+
+- `templates/feature-spec.md`：功能 spec 模板
+- `templates/pr-checklist.md`：PR 自检清单
+
+## 检查清单
+
+交付前必须自查：
+
+- [ ] 需求有明确验收标准
+- [ ] 数据模型有主键、索引、时间戳
+- [ ] API 有输入校验和错误码
+- [ ] 前端有加载态、空态、错误态
+- [ ] 敏感信息走环境变量
+- [ ] 主链路可端到端跑通
+- [ ] 构建、lint、typecheck 通过
+- [ ] 有最小测试覆盖
+- [ ] README 或交付说明完整
+
+## 反模式
+
+避免以下行为：
+
+- 直接写代码不澄清需求
+- 一次改动跨太多模块，难以 review
+- 前端和后端契约不一致
+- 忽略错误态和边界
+- 把密钥写进代码
+- 只测 happy path
+- 交付无法运行的片段
+- 编造不存在的 API 或字段
+
+## 输出风格
+
+- 中文为主，术语保留英文
+- 先结论后细节
+- 代码块标注语言
+- 长任务分阶段汇报
+- 不确定处显式标注 `[待确认]`