SuperAPI AI 工具集

decision-documentation

办公与效率

查看项目

更新于 10-16 03:14

技能介绍

用途:记录无障碍决策及其背后的推理,让未来团队不仅知道决定了什么,还知道为什么这样决定,防止因无人记得理由而把好决策改回去。

主要能力:提供决策记录格式,包含标题(清晰可搜索)、日期与作者、背景(触发决策的情境与约束)、决策(具体决定)、考虑过的替代方案及被否原因、无障碍影响(谁受益及如何受益)、风险与取舍、证据(研究、测试或标准依据)。

何时记录:在两种或以上无障碍方案间做选择时;为改善某方面而牺牲另一方面的无障碍性时;决定不修复某问题并说明原因时;出于合理原因采用不同于 WCAG 技术的实现时;专为无障碍选择某设计模式时;用户测试揭示改变方向的无障碍洞察时。

存放位置:优先放在代码库中与代码同行;也可放在共享决策日志(wiki、Notion、Confluence)或设计系统文档中(针对系统级决策);不要只留在某人脑中或 Slack 讨论串里。

适用场景:无障碍取舍、改版、框架升级、人员流动、紧迫截止日期等容易悄悄累积无障碍障碍的场合。

限制:资料未提供具体工具、命令、平台支持或收费信息;该技能为文档实践方法,不涉及自动化检测或代码实现。