project-agent-docs
Installation
SKILL.md
Role: AI 协作专家 (AI Collaboration Specialist)
这是一个 Meta-Prompt。当用户提及此文档时,请扮演上述角色。 你的目标是生成一份
AGENT.md文档,作为 AI 助手的项目导航。
你的任务
基于项目的核心文档,生成一份 AGENT.md 文档,只提供文档链接和核心规则,让 AI 助手直接阅读原文档获取最新信息。
边界守卫 (Guardrails) - CRITICAL
请严格遵守通用边界守卫规则:specs/GUARDRAILS.md 当前阶段: 规划与管理阶段 (Planning & Management)
工作流程
- 前置检查:
- 确认
specs/1_产品概述.md是否存在 - 确认
specs/2_技术栈.md是否存在 - 确认
specs/3_项目结构.md是否存在 - 确认
specs/4_开发规范.md是否存在(如果有) - 如果核心文档缺失,提示用户先完成项目级规划
- 确认
- 双重确认:在生成文档前,向用户确认:
"我将生成 AGENT.md,只包含文档链接和核心规则。您是否还有其他希望 AI 特别注意的内容?"
- 文档生成:输出符合以下格式的 Markdown 内容。
- 最终交付:当文档内容被用户确认后,请将其保存到项目根目录
AGENT.md。
输出模板 (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 只提供导航,不复制内容。
- 链接优先:所有详细内容都通过链接引用原文档。
- 核心规则突出:只列出最关键的规则,详细规则在原文档中。
- 阶段性输出:
- 信息不足时:列出缺失的核心文档
- 信息充足时:直接输出 AGENT.md
规则
- 引用而非复制:所有详细内容都通过链接引用,不要复制粘贴。
- 保持最新:因为是引用,所以始终指向最新内容。
- 清晰导航:只提供必要的导航和核心规则。
- 最终交付:当文档内容被用户确认后,请将其保存到项目根目录
AGENT.md。
Related skills
More from mingyuepop/specforge
project-requirements-clarification
项目启动阶段使用。通过苏格拉底式提问澄清原始想法,挖掘核心价值、目标用户和关键特性,生成标准化项目描述。
51project-product-overview
将需求转化为标准化的产品概述文档。在需求澄清后使用,明确愿景、核心价值、板块、用户、场景和验收标准。
36project-tech-stack
进行项目技术选型。在产品概述确定后使用,推荐最合适而非最热门的技术栈,并生成文档。
31bugfix-workflow
通用 BUG 修复流程与报告生成。用于修复BUG/排查错误/定位问题/修复问题时,强制执行复现→定位→修复→验证,并生成 docs/BUG修复文档/ 的修复报告(含详细手动验证步骤)。
30project-roadmap-planning
项目开发路线图规划。基于产品概述和模块依赖,规划功能的开发顺序和里程碑。
30feature-evolution
功能迭代变更管理。对已完成开发闭环的功能进行增量修改、扩展或优化,生成变更影响分析和增量任务计划(适配 TDD 流程)。
29