diff --git a/.agents/skills/unidesk-tasktree/references/development-operations.md b/.agents/skills/unidesk-tasktree/references/development-operations.md
index d8af6726..254561d6 100644
--- a/.agents/skills/unidesk-tasktree/references/development-operations.md
+++ b/.agents/skills/unidesk-tasktree/references/development-operations.md
@@ -233,6 +233,8 @@ bun scripts/cli.ts web-probe console-verify \
   - 全局概览使用 PostgreSQL 单次聚合 API；
   - 禁止前端逐组请求 timeline；
   - 详情页支持三级缩进和逐级折叠；
+  - 大纲编号、层级控件和 Markdown 标题遵循
+    `$unidesk-webdev` 的结构化树设计规则；
   - 左侧标题与右侧时间条的组内滚动同步；
   - 标题占满可用单行宽度后才使用省略号；
   - Markdown 链接渲染为链接；
diff --git a/.agents/skills/unidesk-webdev/references/design.md b/.agents/skills/unidesk-webdev/references/design.md
index c58884ea..596d906e 100644
--- a/.agents/skills/unidesk-webdev/references/design.md
+++ b/.agents/skills/unidesk-webdev/references/design.md
@@ -32,6 +32,15 @@
 - 页面可见文案默认使用中文；协议字段、实体名、命令、路径、`runId`、`traceId`、`SHA256`、`HWPOD` 等机器或领域标识可保留原文，状态码旁应提供中文含义，禁止整块工作区只显示英文标题和状态。
 - 新建、配置、probe、reindex 等低频表单用对话框或抽屉承载；默认版面不要常驻新建框、配置表或调试面板。高频命令保留为稳定按钮或图标按钮，并配清晰状态。
 - 文档/任务类页面优先就地阅读和就地编辑：标题和正文双击或显式编辑态切换，不为常规查看单独铺满输入框；正文渲染态必须可见，不能只显示 taskRef、文件名或更新时间。
+- 树和大纲中的结构化编号、层级控件与标题内容必须职责分离：
+  - `R1`、`R1.2` 等结构化编号使用独立稳定列，不嵌入 Markdown 标题流，
+    不因编号长度或层级深度改变同级标题起点；
+  - 展开按钮、树导线和缩进只表达层级，不重复推动编号列；
+  - 状态点属于标题内容列，不能夹在展开控件与编号之间制造视觉噪声；
+  - 导入标题已带旧结构编号时，只在展示层去重，禁止修改原始标题或破坏
+    Markdown 链接；
+  - 不使用逐行断开的硬分隔线模拟列边界，优先依靠稳定对齐、字重和留白表达
+    信息层次。
 - 报告、Markdown、日志和 JSON 片段要用成熟 Markdown/代码块渲染，代码块采用浅色 Workbench 风格、可滚动且不撑破布局；不要把裸 JSON 或长日志直接挤爆页面。
 - 页面状态要可深链：重要 source/file/task/report/session 选择进入 RESTful URL，并能刷新后恢复；联动其他功能只通过公共 API、稳定 id 和 URL，不把两个功能互相嵌入成强依赖。
 - 设计验收必须用截图或 web-probe 样本检查真实版面：