From d0a252f3dd7f3b2b3b5c766372abda534f06a419 Mon Sep 17 00:00:00 2001
From: Rogee <rogee@ipao.vip>
Date: Wed, 23 Sep 2026 15:59:01 +0800
Subject: [PATCH] =?UTF-8?q?docs(ui):=20AGENTS.md=20=E5=A3=B0=E6=98=8E=20an?=
 =?UTF-8?q?td=20skills/=E5=B7=A5=E5=85=B7=E5=AE=89=E8=A3=85=E7=A1=AE?=
 =?UTF-8?q?=E8=AE=A4=E4=B8=8E=20UI=20=E8=A7=84=E8=8C=83=EF=BC=9B=E9=A1=B5?=
 =?UTF-8?q?=E5=A4=B4=E6=93=8D=E4=BD=9C=E6=8C=89=E9=92=AE=E5=BA=95=E9=83=A8?=
 =?UTF-8?q?=E5=AF=B9=E9=BD=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                 | 16 ++++++++++++++++
 web/src/layouts/index.tsx |  5 +++--
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 7a0b6d6..1430f28 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -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` 结果为准。
+
 ## 沟通方式
 
 - 向使用者回报时，使用清楚直白的语言说明做了什么、结果如何。最终回复禁用术语、技术实现细节与工程腔。写法是：对一个聪明但没在看代码的人解释。
diff --git a/web/src/layouts/index.tsx b/web/src/layouts/index.tsx
index 726c47f..475790e 100644
--- a/web/src/layouts/index.tsx
+++ b/web/src/layouts/index.tsx
@@ -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>