docs: define go-admin UI reuse rules (#3)

This commit is contained in:
QiuSW
2026-08-12 08:48:07 +08:00
parent 6aaebc3bc6
commit 6ff12e6a27
6 changed files with 116 additions and 2 deletions
+41
View File
@@ -50,6 +50,7 @@ CORE_DOCUMENT_REQUIREMENTS = {
),
"docs/01-workflow.md": (
"## 面向初级维护者的修改边界",
"## go-admin / go-admin-ui 开发约束",
"## 每个任务的文档影响",
"## 需求记录与流转",
"## 稳定文档与任务归档",
@@ -286,6 +287,45 @@ def check_agent_efficiency_rules(errors: list[str], root: Path = ROOT) -> None:
errors.append(f"AGENTS.md 缺少:{section}")
def check_go_admin_ui_rules(errors: list[str], root: Path = ROOT) -> None:
"""检查 Sense、Bell 共用的框架精简和组件复用规则。"""
requirements = {
"AGENTS.md": (
"### go-admin / go-admin-ui 精简与复用",
"最小可见、最小启用",
"隐藏只移除用户入口,不等于禁用",
"永久删除默认模块必须单独建立清理工单",
"新页面优先复用现有布局",
"不得引入与整体风格冲突的独立视觉体系",
"跨产品影响按协同工单处理",
"没有可见但不可用的失效入口",
),
"Sense/AGENTS.md": (
"## go-admin / go-admin-ui 约束",
"菜单权限或路由开关隐藏",
"不能只隐藏菜单",
"新增组件前在工单中说明",
"同时影响 Bell 或共享基线时升级为协同工单",
),
"Bell/AGENTS.md": (
"## go-admin / go-admin-ui 约束",
"菜单权限或路由开关隐藏",
"不能只隐藏菜单",
"新增组件前在工单中说明",
"同时影响 Sense 或共享基线时升级为协同工单",
),
}
for relative_path, required in requirements.items():
path = root / relative_path
if not path.is_file():
errors.append(f"缺少 go-admin 规则文件:{relative_path}")
continue
content = path.read_text(encoding="utf-8")
for section in missing_sections(content, required):
errors.append(f"{relative_path} 缺少 go-admin 规则:{section}")
def check_claude_code_entry(errors: list[str], root: Path = ROOT) -> None:
"""检查 Claude Code 入口直接复用共同 Agent 规则。"""
@@ -382,6 +422,7 @@ def main() -> int:
check_core_documents(errors)
check_task_template(errors)
check_agent_efficiency_rules(errors)
check_go_admin_ui_rules(errors)
check_claude_code_entry(errors)
check_archives(errors)