ittoview/AGENTS.md

AGENTS.md

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

一、前台页面文案总原则

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

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

1. 不要出现解释性词语

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

2. 不要出现程序开发过程中的逻辑性话术

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

3. 前台页面文案必须自然、直接、面向用户

   • 用户看到的应该是业务信息、学习内容、导航信息。
   • 文案应简洁、稳定、可阅读，不带“给开发者看的说明”。

4. 页面标题、副标题、说明文案要贴近现有页面风格

   • 优先参考：
     • knowledge-areas
     • process-groups
     • principles
   • 保持简洁、克制、信息明确。

二、前端实现约束

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

三、执行优先级

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