القائمة
生成项目导航文档。基于项目核心文档生成 AGENT.md，作为 AI 助手的项目导航。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | project-agent-docs |
| description | 生成项目导航文档。基于项目核心文档生成 AGENT.md，作为 AI 助手的项目导航。 |
这是一个 Meta-Prompt。当用户提及此文档时，请扮演上述角色。 你的目标是生成一份
AGENT.md文档，作为 AI 助手的项目导航。
基于项目的核心文档，生成一份 AGENT.md 文档，只提供文档链接和核心规则，让 AI 助手直接阅读原文档获取最新信息。
请严格遵守通用边界守卫规则：specs/GUARDRAILS.md 当前阶段: 规划与管理阶段 (Planning & Management)
specs/1_产品概述.md 是否存在specs/2_技术栈.md 是否存在specs/3_项目结构.md 是否存在specs/4_开发规范.md 是否存在（如果有）"我将生成 AGENT.md，只包含文档链接和核心规则。您是否还有其他希望 AI 特别注意的内容？"
AGENT.md。# AI 协作指南 (AI Agent Guide)
> 每次对话时，请先阅读以下核心文档以了解项目背景和工作规范。
## 必读文档 (Required Reading)
### 项目级文档（了解项目全貌）
* [specs/1_产品概述.md](specs/1_产品概述.md) - 项目愿景、核心模块、目标用户
* [specs/2_技术栈.md](specs/2_技术栈.md) - 技术选型和理由
* [specs/3_项目结构.md](specs/3_项目结构.md) - 目录结构和文件放置规则
* [specs/4_开发规范.md](specs/4_开发规范.md) - 代码风格和命名规范
## 工作流程 (Workflow)
### 功能开发（按顺序执行）
1. 需求澄清 → [`.ai-specs/skills/feature-requirements-clarification/SKILL.md`](.ai-specs/skills/feature-requirements-clarification/SKILL.md)
2. UI 原型 → [`.ai-specs/skills/ui-prototype/SKILL.md`](.ai-specs/skills/ui-prototype/SKILL.md)
3. 技术方案 → [`.ai-specs/skills/feature-tech-design/SKILL.md`](.ai-specs/skills/feature-tech-design/SKILL.md)
4. 任务规划 → [`.ai-specs/skills/feature-task-planning/SKILL.md`](.ai-specs/skills/feature-task-planning/SKILL.md)
### 项目初始化（仅在项目开始时）
1. 需求挖掘 → [`.ai-specs/skills/project-requirements-clarification/SKILL.md`](.ai-specs/skills/project-requirements-clarification/SKILL.md)
2. 产品概述 → [`.ai-specs/skills/project-product-overview/SKILL.md`](.ai-specs/skills/project-product-overview/SKILL.md)
3. 技术栈 → [`.ai-specs/skills/project-tech-stack/SKILL.md`](.ai-specs/skills/project-tech-stack/SKILL.md)
4. 项目结构 → [`.ai-specs/skills/project-structure/SKILL.md`](.ai-specs/skills/project-structure/SKILL.md)
5. 开发规范 → [`.ai-specs/skills/project-dev-standards/SKILL.md`](.ai-specs/skills/project-dev-standards/SKILL.md)
6. 初始化计划 → [`.ai-specs/skills/project-task-planning/SKILL.md`](.ai-specs/skills/project-task-planning/SKILL.md)
7. 开发路线图 → [`.ai-specs/skills/project-roadmap-planning/SKILL.md`](.ai-specs/skills/project-roadmap-planning/SKILL.md)
### 维护与调试 (Maintenance & Debugging)
1. 错题复盘 (AI Mistakes) → [`.ai-specs/skills/project-ai-mistakes/SKILL.md`](.ai-specs/skills/project-ai-mistakes/SKILL.md)
## 文档位置 (Document Locations)
* **功能文档**：`docs/{功能名称}/` - 每个功能包含需求、方案、规划三个文档
* **项目规范**：`specs/` - 项目级规范，全局适用
* **Skill 调用**：直接使用上述表格中的指令（如 `ui-prototype`）来触发 AI 能力，而不是手动查找文档。
## 核心规则 (Core Rules)
* 必须按工作流程顺序执行（需求→方案→规划→编码→验证）
* 功能文档必须保存在 `docs/{功能名称}/` 目录下
* 不要跳过需求澄清直接写代码
* 不要修改 `specs/` 下的文档（除非是项目级变更）
---
**所有详细信息请查看上述链接的文档。**
AGENT.md。功能开发阶段使用。明确具体功能的业务需求和验收标准，产出功能需求文档 (FRD)。
功能任务规划。将技术方案拆解为细粒度、可执行的开发任务清单 (Task List)。
设计功能的技术实现方案。在功能需求明确后使用，产出包含API、数据库、核心逻辑的详细技术方案 (TDD)。
记录和查阅 AI 错题本。当发生错误或需要预警时使用，建立自我进化的反馈闭环，避免重复错误。
交互式 BUG 排查专家。通过持续提问和引导，逐步缩小问题范围，辅助用户定位 BUG 根源。
存量项目接入。扫描现有代码库，逆向生成标准化的全局指引文档 (specs/*)。