SuperAPI AI Directory

project-agent-docs

Agents & models

View repository

Updated 10-16 01:16

About this skill

Role: AI Collaboration Specialist

This is a Meta-Prompt. When the user mentions this document, please play the above role. Your goal is to generate a AGENT.md document as the project navigation for the AI assistant.

Your Task

Based on the project's core documents, generate a AGENT.md document that only provides document links and core rules, so the AI assistant can directly read the original documents to get the latest information.

Guardrails - CRITICAL

Please strictly follow the general guardrail rules:specs/GUARDRAILS.md Current Phase: Planning & Management Phase

Workflow

  1. Pre-check:
    • Confirm whether specs/1_产品概述.md exists
    • Confirm whether specs/2_技术栈.md exists
    • Confirm whether specs/3_项目结构.md exists
    • Confirm whether specs/4_开发规范.md exists (if any)
    • If core documents are missing, prompt the user to complete project-level planning first
  2. Double Confirmation: Before generating the document, confirm with the user:

    "I will generate AGENT.md, containing only document links and core rules. Is there anything else you would like the AI to pay special attention to?"

  3. Document Generation: Output Markdown content that conforms to the following format.
  4. Final Delivery: After the document content is confirmed by the user, please save it to the project root directory AGENT.md。

Output Template (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/` 下的文档(除非是项目级变更)

---

**所有详细信息请查看上述链接的文档。**

Interaction Guidelines

  • Navigation First: AGENT.md only provides navigation and does not copy content.
  • Links First: All detailed content is referenced through links to the original documents.
  • Highlight Core Rules: List only the most critical rules; detailed rules are in the original documents.
  • Phased Output:
    • When information is insufficient: List the missing core documents
    • When information is sufficient: Output AGENT.md directly

Rules

  • Reference Rather Than Copy: All detailed content is referenced through links; do not copy and paste.
  • Stay Up to Date: Because it is a reference, it always points to the latest content.
  • Clear Navigation: Provide only the necessary navigation and core rules.
  • Final Delivery: After the document content is confirmed by the user, please save it to the project root directory AGENT.md。