product-design-and-ux

产品设计与 UX

将经过验证的证据和选定范围转化为用户能够完成并在遇到问题时恢复的可观察行为。设计交互，而非品牌、像素、CSS、组件实现或特定工具。

入门检查

确认已批准的范围、目标结果、用户或角色、证据链接、约束、可衡量的体验目标和待定的产品决策。记录缺失的输入，而不要凭空补充。

• 需要利益相关者证据、验证或原始研究？使用 product-discovery。
• 需要优先级排序、范围，或了解功能的构建原因？使用 product-methodology。
• 需要深入了解 WCAG、ARIA、原生语义或无障碍测试？使用 web-accessibility。
• 需要将已批准的交互契约转化为软件规范和交付门槛？使用 spec-driven-development。
• 需要设计 AI 辅助、生成式、预测式、推荐式或可调用工具的交互？阅读 AI interaction and uncertainty，并将 the AI interaction contract 与通用契约配合使用。将模型评估与可观测性设计交由 agent-evals-and-observability，治理交由 ai-governance，运行时权限交由 agent-production-operations，产品度量交由 product-analytics-and-measurement，无障碍交由 web-accessibility，成本与价值决策交由 ai-operating-economics。
• 需要让用户将任务委派给他们在产品之外使用的 Agent，并能跨应用检查或继续任务？阅读 external agent interactions，并填写 the external agent handoff，同时配合 AI 交互契约和任务流契约使用。不要假设产品托管该 Agent，或能够查看其私密对话。

工作流

1. 使用 templates/outcomes-to-design.md，将每项结果和设计决策追溯到证据。可选的用户画像或工作任务必须改变某项决策并引用证据；不要创建装饰性的人口统计资料。
2. 根据目标、内容对象、术语、权限、可查找性和服务情境，建立信息架构。阅读 references/information-architecture.md。
3. 定义关键标签、说明、状态、错误和完成内容；评估任务对记忆、选择、切换、中断和恢复的要求。使用启发式方法生成可测试的问题，而非下结论。阅读 references/content-and-cognitive-demand.md。
4. 为所有参与角色的重要任务建模，包括交接后的接收方工作。以预期的用户结果为终点，而不只是提交、送达或中间状态。纳入决策、备选方案、中断、重新进入、取消、恢复、不可逆操作、副作用、权限变更和完成证据。阅读 references/task-flows-and-state-models.md 并使用 templates/task-flow-state-model.md。
5. 仅盘点由流程、数据、权限、连接状态和风险所要求的状态。记录风险较高的遗漏。使用 templates/screen-state-inventory.md。
6. 编写与框架无关的契约，涵盖内容、控件、无障碍交互要求、操作、状态转换、持久化、权限、响应式／重排行为、遥测和未决决策。阅读 references/interface-contracts-and-responsive-behavior.md 并使用 templates/interface-contract.md。
7. 将模式视为假设。使用 references/interaction-pattern-selection.md 比较备选方案、权衡、证据和可证伪条件。
8. 仅规划或综合获准开展的可用性工作。阅读 references/usability-testing-and-privacy.md；使用 templates/usability-study.md。绝不可编造参与者、同意、观察、引语或结果。
9. 产出工程交接材料，包含可观察的验收证据、依赖项、负责人、关卡和已部署边界验证。阅读 references/engineering-handoff.md；使用 templates/engineering-handoff.md。将已批准的行为交给 spec-driven-development。

按需加载

需求	加载内容
范围边界、可追溯性或相邻技能的路由	references/boundaries-and-traceability.md
目标、标签、导航、可查找性、权限	references/information-architecture.md
浅白易懂的内容、启发式评审、认知负荷	references/content-and-cognitive-demand.md
任务路径、状态适用性、恢复、副作用	references/task-flows-and-state-models.md
交互契约或包容性的响应式行为	references/interface-contracts-and-responsive-behavior.md
模式备选方案和决策证据	references/interaction-pattern-selection.md
可用性测试方案、综合分析、同意或隐私	references/usability-testing-and-privacy.md
交接、验收标准或已部署验证	references/engineering-handoff.md
AI 不确定性、依据、人类控制、反馈或模型变更验收	references/ai-interaction-and-uncertainty.md
某人将工作委托给产品之外的自己的 Agent，并在跨应用边界后返回	references/external-agent-interactions.md; templates/external-agent-handoff.md
使用合成夹具进行方法论自检	references/scenario-probes.md
来源权威性、状态和示例	references/source-index.md

防护措施

• 设计时应全面考虑无障碍，但 WCAG/ARIA/原生语义和测试深度仍由 web-accessibility 负责。
• 明确说明相关宽度、缩放/重排、文本扩展/本地化、方向、输入模式、减少动态效果、连接降级、中断和重新进入时的行为。不要以设备断点作为模型。
• 使用合成测试数据，例如 [email protected] 和 INV-DEMO-042；对于不安全的原型，绝不索取真实凭据、付款信息、金融访问权限或密钥。
• 可用性研究的发现只是有边界的证据，不能证明无障碍合规性、总体普遍程度、分析结论或结果。
• AI 输出、置信度、解释、引用或用户反馈本身都不能证明正确性。记录证据边界，并将模型质量和统计问题交由相应的专业负责人处理。

完成标准

当所有范围内的行为都有可追溯的证据、适用的状态/恢复模型、可观察的验收标准，且决策已解决或已明确负责人和解决关卡时，即可停止。报告局限和未经测试的风险，而不要用假设填补空白。

嵌入式业务应用示例

在现有任务界面中设计 Agent 时，请阅读设备借用完整示例。该示例从建议到效果确认与恢复，补全了现有的 AI 交互、任务流程和工程交接约定；请将其中的验收探测视为合成设计测试数据，而非观察到的可用性结果。

对于可执行的 AI 建议，执行时应重新核验当前权限、记录修订版本、策略、库存和经批准的操作摘要。仅在审批时核验并不足够。命令结果不确定后，在重试前应查询已持久化的命令 ID；不要创建新的预留 ID，也不要重复已确认的副作用。应分别显示部分效果。