# AGENTS.md

本文件用于约束本项目中的协作式开发行为，尤其是前端页面内容生成与文案表达。

## 一、前台页面文案总原则

前台页面是直接面向最终用户的，不是面向开发者的。

因此，在所有前台展示内容中，必须严格遵守以下规则：

1. 不要出现解释性词语
   - 禁止出现类似：
     - “这里先提供……”
     - “方便你确认……”
     - “后续再补……”
     - “当前状态……”
     - “首版……”
     - “目录入口页面……”
     - “样式展示……”
   - 页面文案只能表达用户真正需要看到的信息，不得解释页面是怎么做的、为什么这样做、现在做到哪一步。

2. 不要出现程序开发过程中的逻辑性话术
   - 禁止出现类似：
     - “入口页”
     - “详情页后续再补”
     - “左侧菜单未加入”
     - “页面阶段”
     - “开发中”
     - “占位内容”
     - “待完善”
   - 不要把研发过程、实现阶段、功能规划暴露给用户。

3. 前台页面文案必须自然、直接、面向用户
   - 用户看到的应该是业务信息、学习内容、导航信息。
   - 文案应简洁、稳定、可阅读，不带“给开发者看的说明”。

4. 页面标题、副标题、说明文案要贴近现有页面风格
   - 优先参考：
     - `knowledge-areas`
     - `process-groups`
     - `principles`
   - 保持简洁、克制、信息明确。

## 二、前端实现约束

1. 新增页面前，优先参考现有同类页面结构与视觉层级。
2. 若用户明确要求“仿照某页面”，应优先复用该页面的信息组织方式，而不是自行发挥。
3. 若只是为了后续扩展而暂时占位，也不能在前台页面展示“占位式说明文案”；应展示为正常页面。
4. 开发说明、阶段说明、技术备注，只能出现在：
   - 对用户的回复中
   - 提交说明中
   - 代码注释中
   - 文档中
   不得出现在前台页面正文中。

## 三、执行优先级

当“开发便利”与“前台用户体验”冲突时，优先保证前台用户体验。