docs: document native restart workflow

.agents/skills/unidesk-sub2api/SKILL.md

@@ -111,6 +111,12 @@ bun scripts/cli.ts web-probe product-smoke \
 ```
 
 - `management l0-smoke` 一次覆盖 PostgreSQL、skill CRUD、API Key 单向保存、绑定启停、绑定级强制全文、历史导入和快照。
+- 修改 Native 组件后统一使用
+  `native restart --component <gateway|api|worker|web|all>`：
+  - 命令按 YAML `runtime.native.stopTimeoutMs` 等待旧 PID 和固定端口释放；
+  - 启动后按 `runtime.native.startTimeoutMs` 等待组件恢复 `ready`；
+  - 禁止再手工紧接 `stop` 与 `start`，也不因退出延迟改用临时端口；
+  - 重启返回后只需一次 `native status` 完成就绪验收。
 - 绑定级强制全文必须满足：
   - `forceEnabled` 默认关闭，并与普通 `enabled` 分别保存；
   - 关闭时保持 `name + description + SKILL.md URL` 注入；

project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md

@@ -254,7 +254,7 @@ owning YAML 应声明：
 
 - PostgreSQL configRef 与 Secret sourceRef；
 - Temporal serviceRef、namespace、task queue、超时和重试；
-- gateway、API、worker 与 Web 的 native entrypoint、固定端口、PID、日志和状态目录；
+- gateway、API、worker 与 Web 的 native entrypoint、固定端口、PID、日志、状态目录、停止等待上限和启动就绪等待上限；
 - 管理 API 的同源路径；
 - Web 固定 HTTPS origin；
 - gateway 快照路径与刷新策略；