docs: require confirmed prototypes for major UI work (#19)

This commit is contained in:
QiuSW
2026-08-17 10:19:34 +08:00
parent 85e6ef409f
commit 6435579e09
6 changed files with 134 additions and 6 deletions
+17
View File
@@ -53,6 +53,10 @@ CORE_DOCUMENT_REQUIREMENTS = {
"## 环境、配置与凭据",
),
"docs/01-workflow.md": (
"## 工单与设计证据双门禁",
"### 先判断是否需要工单",
"### 再判断设计证据",
"### 记录和重新确认",
"## 面向初级维护者的修改边界",
"## 每个任务的文档影响",
"## 需求记录与流转",
@@ -126,6 +130,8 @@ CORE_DOCUMENT_REQUIREMENTS = {
"## 当前需求索引",
"## 登记规则",
"## 原型与设计资产",
"### 原型门禁",
"### 原型确认记录",
"## 状态规则",
"## 更新时机",
"## 最小验收清单",
@@ -253,6 +259,14 @@ def check_task_template(errors: list[str], root: Path = ROOT) -> None:
"- 关键原话或脱敏摘要:",
"## 需求变化记录",
"| 日期 | 变化内容 | 原因 | 用户确认 |",
"## 设计与原型门禁",
"- 修改类型:纯显示文案 / 小范围 UI / 新组件 / 新页面或独立用户功能 / 重大交互或导航 / 非 UI / 恢复既有行为的 Bug",
"- 所需设计证据:无 / 标注截图 / 低保真图 / 已确认原型 / 架构、API、数据、状态或流程设计 / 原设计或复现证据",
"- 证据链接、Git 路径或事实来源:",
"- 版本、revision 或确认日期:",
"- 状态:无 / 草稿 / 已确认 / 已废弃",
"- 确认人、确认时间和覆盖范围:",
"- 无需 UI 原型或无需任何原型的原因:",
"## 文档影响",
"- [ ] 不影响长期文档,原因:",
"- [ ] 更新架构与代码地图",
@@ -284,6 +298,9 @@ def check_agent_efficiency_rules(errors: list[str], root: Path = ROOT) -> None:
"用户没有明确验收通过前不得关闭",
"长期核心文档必须先修改 Wiki",
"提交只包含当前工单相关文件",
"### 工单与设计证据双门禁",
"新页面、独立用户功能、重大交互或导航变化",
"代码组件名、类名、变量、国际化键、API 字段和数据库字段不是显示文案",
"### 自然语言快捷指令",
"`只分析`",
"`建工单`",