docs(ui): AGENTS.md 声明 antd skills/工具安装确认与 UI 规范;页头操作按钮底部对齐

This commit is contained in:
2026-09-23 15:59:01 +08:00
parent fdfc2fb544
commit d0a252f3dd
2 changed files with 19 additions and 2 deletions
+16
View File
@@ -48,6 +48,22 @@
用户交互需要使用 skill:impeccable 优化交互操作
## Agent Skills 与工具(开发前必须确认已安装)
以下 skill 与工具是本项目 antd/pro 开发的官方标准,缺失时先安装再写代码:
- `.pi/skills/antd/`:`@ant-design/cli` 工作流(API 离线查询、demo、token、lint、迁移)
- `.pi/skills/ant-design/`:antd 6 + Pro 决策指南与回归 checklist
- 全局 `@ant-design/cli`(`antd` 命令):缺失时 `npm install -g @ant-design/cli`
使用规则:写/改 antd 组件前先 `antd info <Component> --format json` 查 API,不凭记忆;改完跑 `antd lint <path> --format json`,警告清零才算完成;命令始终加 `--format json`。
## UI 规范(antd/pro)
- 页面标题右侧的操作按钮与标题底部对齐(Layout 页头槽内联样式控制,勿在其他位置另造对齐方式)。
- 页面级操作按钮通过 `usePageActions` 注册到页头槽,不得在卡片内重复渲染。
- 弃用 API 禁止回潮:`Alert` 用 `title`/`description`(非 `message`)、纵向堆叠用 `Flex vertical`(非 `Space direction`)、静态 `message.xxx` 改 `App.useApp()`。以 `antd lint` 结果为准。
## 沟通方式
- 向使用者回报时,使用清楚直白的语言说明做了什么、结果如何。最终回复禁用术语、技术实现细节与工程腔。写法是:对一个聪明但没在看代码的人解释。
+3 -2
View File
@@ -62,13 +62,14 @@ export default function Layout() {
<PageContainer
ghost
title={
<div>
<div style={{ display: 'flex', flexDirection: 'column', justifyContent: 'flex-end', height: '100%' }}>
<Typography.Title level={4} style={{ marginBottom: 2 }}>{meta.title}</Typography.Title>
<Typography.Text type="secondary" style={{ fontSize: 12 }}>{meta.subtitle}</Typography.Text>
</div>
}
subTitle={false}
extra={pageActions}
// 官方 skill 规范:标题右侧操作按钮底部对齐(PageContainer 的 -row 未设 align-items,默认居中)。
extra={<div style={{ alignSelf: 'flex-end' }}>{pageActions}</div>}
>
<Outlet />
</PageContainer>