القائمة
将大型需求拆分为多阶段任务文档并分步交付。当用户说「拆分任务」「分阶段执行」「按需求文档实现」「分部交付」，或提供分析报告要求逐步实现时使用。自动在 docs/demand/<主题>/ 下建立 phases/ 目录，生成带状态标注的阶段文档，每阶段完成后更新状态、提供后续步骤，并询问是否 push。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
回答 PetConnect 生态任务的设计规范、完成进度时间轴、交付验证。当用户问设计规格、spec、验收标准、进度、时间轴、交付情况、任务状态、认领情况时使用。按统一模板凝练输出，数据来自 tasks/、docs/demand/。
Guides AI agent features in petconnect-app including LLM providers (DeepSeek, Doubao, Gemini), anti-abuse constraints, prompt design, and keyword-based human simulation. Use when adding AI agents, changing LLM providers, adjusting rate limits, or modifying agent prompts.
Guides Vercel deployment and PWA setup for petconnect-app. Use when deploying to Vercel, configuring PWA, adding to home screen, or troubleshooting deployment/auth/AI issues.
Analyzes staged and modified files, groups them by feature, and guides batch commits. Use when the user says "提交到Github", "提交到 GitHub", "push to GitHub", or has many staged files from multiple features and wants to commit by feature.
按需开启/关闭 MCP 服务。当用户说"开启 xxx MCP"、"关闭 yyy MCP"、"MCP 太多了"、"管理 MCP"、"禁用 MCP"时触发。
专业处理 README 与部署文档。Use when writing README, deployment guides, environment variable docs, or project structure documentation. 约定：README 必须包含环境变量表、获取 API Key 的链接、部署步骤、项目结构。
| name | phased-task-delivery |
| description | 将大型需求拆分为多阶段任务文档并分步交付。当用户说「拆分任务」「分阶段执行」「按需求文档实现」「分部交付」，或提供分析报告要求逐步实现时使用。自动在 docs/demand/<主题>/ 下建立 phases/ 目录，生成带状态标注的阶段文档，每阶段完成后更新状态、提供后续步骤，并询问是否 push。 |
docs/demand/
└── <主题名>/ # 每个主题一个文件夹（kebab-case）
├── 00-overview.md # 总览与阶段索引（必须第一个创建）
├── 00-foundation.md # 前置基础（如有）
├── phase-1-xxx.md
├── phase-2-xxx.md
└── phase-N-xxx.md
主题名示例：
blog-system、auth-module、dashboard-v2
阅读用户提供的文档，按以下原则划分阶段：
在回复中先输出阶段规划（文字形式），等用户确认后再生成文档。
# 目录结构示例
docs/demand/<主题>/
每份文档的统一模板（见 reference.md）：
# Phase N：<标题>
> **状态**：⬜ 待执行
> **预计工时**：Xh
> **前置条件**：[Phase N-1](./phase-N-1.md) 完成
> **目标**：一句话描述
## 核心交付物
## 新增依赖
## 数据库变更（如有）
## 新增/修改文件清单
## 核心实现（关键代码片段）
## 验收标准
- [ ] 可测试的验收条目
每次执行一个阶段：
🔄 执行中✅ 已完成，填写实际完成时间状态标注位置（文档第2行）：
| 状态值 | 含义 |
|---|---|
⬜ 待执行 | 尚未开始 |
🔄 执行中 | 当前 session 正在做 |
✅ 已完成 | 验收通过 |
⏸ 暂停 | 外部依赖阻塞（如等待 API Key） |
每个阶段执行完成后，必须按以下格式输出：
## 本阶段交付总结
| 文件/操作 | 状态 |
|-----------|------|
| src/xxx | ✅ |
| ... | ... |
## 验证结果
- TypeScript: ✅ 零报错
- Build: ✅ 成功
## 后续步骤（下一个 Agent 请从这里接手）
**当前状态**：Phase N 已完成，Phase N+1 待执行
**下一步**：
1. 阅读 [phase-N+1 文档](../phases/phase-N+1.md)
2. 确认前置条件满足（列出具体条件）
3. 执行 Phase N+1
**需要用户操作**（如有）：
- [ ] 在 Supabase 控制台执行 DDL（参见 phase-1 第X节）
- [ ] 配置 .env.local（复制 .env.example）
---
是否将本次变更 push 到远端？（y/n）
所有阶段完成后额外输出：
## 🎉 项目交付完成
### 总交付物
- N 个阶段，共 X 个文件
- 验收覆盖：XX 条通过
### 建议后续操作
1. 在 Supabase 控制台补全环境配置
2. 运行 `npm run build` 最终验证
3. 部署：参见 .cursor/skills/deploy/SKILL.md
是否将所有变更 push 到远端？
在 00-overview.md 末尾维护一个「当前进度」区块，每次更新：
## 📍 当前进度（Agent 接手请读此处）
- **最后更新**：2026-02-19
- **已完成**：Foundation、Phase 1
- **进行中**：Phase 2（src/components/article/ 实现到一半）
- **待执行**：Phase 3 ~ Phase 6
**下一步**：打开 [phase-2-interaction.md](./phase-2-interaction.md)
从「CommentSection 组件」处继续。