Explorar el Código

docs(产品): 定义真实执行观察器的业务设计原则

明确目标用户、产品用途、品牌性格、反例和无障碍要求。默认视图以创作任务与业务因果为主线,技术字段通过渐进披露保留,避免把动态 Agent 系统误画成固定流水线。
SamLee hace 18 horas
padre
commit
d4b6dccf9b
Se han modificado 1 ficheros con 36 adiciones y 0 borrados
  1. 36 0
      PRODUCT.md

+ 36 - 0
PRODUCT.md

@@ -0,0 +1,36 @@
+# Product
+
+## Register
+
+product
+
+## Users
+
+内容运营、产品负责人和业务管理者。他们不需要理解 Agent、TaskContract、数据库事务或模型运行细节,需要快速看懂一次智能创作为什么产生某个任务、依据了什么、评估发现了什么,以及 Planner 最后采取了什么行动。
+
+## Product Purpose
+
+用可追溯的动态业务图解释智能创作全过程。系统应让业务人员一眼识别当前目标、正在处理的问题、已采用与被替换的内容、评估依据、调整决策、完整成稿和发布结果,同时为开发人员保留可切换的技术追踪视图。
+
+## Brand Personality
+
+清楚、克制、可信。界面以业务事实和因果关系建立信任,不用装饰性复杂度制造“智能感”。
+
+## Anti-references
+
+- 不把动态 Agent 系统画成固定的 Phase 或模块流水线。
+- 不让 Worker、digest、fencing、数据库物理行占据默认业务视图。
+- 不用无法回到真实冻结记录的临时总结解释依据或决策。
+- 不用同样大小、同样结构的大量技术卡片淹没当前任务和关键问题。
+
+## Design Principles
+
+- 以创作任务和业务因果为主线,而不是以系统阶段为主线。
+- 每个关键环节都回答“做了什么、依据什么、结果如何、随后怎么处理”。
+- 评估只报告问题,Planner 决策单独展示,避免混淆判断权。
+- 默认突出当前焦点和最终采用路径,被替换与未采用结果保留但降级显示。
+- 使用渐进披露:业务事实优先,技术字段和原始 JSON 在高级视图中查看。
+
+## Accessibility & Inclusion
+
+以 WCAG AA 为基本目标;状态不能只依赖颜色;所有交互支持键盘焦点;重要文字保持足够对比度;动效尊重 reduced-motion;窄屏仍保留查看业务详情和决策依据的能力。