diff --git a/skills/create-agent/CHANGELOG.md b/skills/create-agent/CHANGELOG.md
index 4d57886..2c7705e 100644
--- a/skills/create-agent/CHANGELOG.md
+++ b/skills/create-agent/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## [2.2.0] - 2026-02-27
+
+- API 改为结构化 L0/L1/L2 输入（PersonaInput / PrinciplesInput），所有字段可选
+- 用户确认预览从原始 markdown 改为表格形式展示
+- 支持最简创建（仅 name），自动补全所有默认值
+
 ## [2.1.0] - 2026-02-26
 
 - 移除 fetch_api 依赖，改为通过 Bash/curl 调用 HTTP API；API 地址由 system prompt 注入；以用户阅读体验优先的 blockquote 格式呈现内容
diff --git a/skills/create-agent/SKILL.md b/skills/create-agent/SKILL.md
index 8b0b52b..0d7a8c5 100644
--- a/skills/create-agent/SKILL.md
+++ b/skills/create-agent/SKILL.md
@@ -3,7 +3,7 @@ name: create-agent
 description: >-
   通过多轮对话收集需求，调用 HTTP API 创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when
   用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。
-version: 2.1.0
+version: 2.2.0
 type: meta
 risk_level: medium
 status: enabled
@@ -14,8 +14,8 @@ tags:
   - meta
 metadata:
   author: desirecore
-  version: 2.1.0
-  updated_at: '2026-02-26'
+  version: 2.2.0
+  updated_at: '2026-02-27'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -113,49 +113,32 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 
 ### 阶段 3：内容生成
 
-根据收集的需求，为新 Agent 生成以下内容：
+根据收集的需求，组装结构化的 persona 和 principles 数据。**不要输出原始 markdown**，而是按字段整理后向用户展示。
 
-**persona.md 生成规范**：
+**Persona 字段**（所有字段均可选，未收集到的由系统自动补全）：
 
-生成 persona.md 时，直接输出以下结构的 markdown 内容供用户阅读和确认，不要用代码块包裹：
+| 层级 | 字段 | 说明 |
+|------|------|------|
+| L0 | — | 一句话核心身份 |
+| L1 | `role` | 角色定位 |
+| L1 | `personality` | 性格特征标签 |
+| L1 | `communication_style` | 沟通风格 |
+| L2 | — | 专业领域、核心价值观、决策偏好等（free-form） |
 
-> **L0 — 核心身份**
->
-> 你是 {name}，{一句话角色定位}。
->
-> **L1 — 行为风格**
->
-> - {风格特征 1}
-> - {风格特征 2}
-> - {风格特征 3}
->
-> **L2 — 深层动机**
->
-> {2-3 句话描述深层价值观和驱动力}
+**Principles 字段**（同样全部可选）：
 
-**principles.md 生成规范**：
-
-生成 principles.md 时，同样直接输出 markdown 内容：
-
-> **L0 — 基础约束**
->
-> - {安全红线 1}
-> - {安全红线 2}
->
-> **L1 — 行为边界**
->
-> - {行为规则 1}
-> - {行为规则 2}
-> - {行为规则 3}
->
-> **L2 — 治理原则**
->
-> {2-3 句话描述最高治理原则}
+| 层级 | 字段 | 说明 |
+|------|------|------|
+| L0 | — | 一句话最高原则 |
+| L1 | `must_do` | 必须做的事项 |
+| L1 | `must_not` | 绝不做的事项（安全红线） |
+| L1 | `priority` | 优先级排序 |
+| L2 | — | 治理原则、升级规则等（free-form） |
 
 **领域匹配参考**：
 
-| 领域关键词 | 推荐风格 | 默认边界 |
-|-----------|---------|---------|
+| 领域关键词 | 推荐 personality | 默认 must_not |
+|-----------|-----------------|--------------|
 | 法律、合同、法务 | 专业、严谨、审慎 | 不提供诉讼代理、不替代正式法律意见 |
 | 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易 |
 | 代码、开发、架构 | 逻辑、务实、直接 | 不直接访问生产环境、不存储凭证 |
@@ -163,9 +146,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 
 ### 阶段 4：用户确认
 
-**展示预览**：
-
-向用户展示预览时，以自然可读的 markdown 格式直接呈现，不使用代码块包裹：
+向用户展示预览时，以自然语言/表格形式呈现各字段，**不要展示原始 markdown 源码**：
 
 > 即将创建智能体：
 >
@@ -174,21 +155,23 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 >
 > ---
 >
-> **persona.md 预览**
+> **人格设定**
 >
-> **L0 — 核心身份**
-> 你是法律顾问小助手，专注于合同审查和法律风险评估...
+> | 字段 | 内容 |
+> |------|------|
+> | 核心身份 | 你是法律顾问小助手，专注于合同审查和法律风险评估 |
+> | 角色定位 | 专注于合同审查和法律风险评估的数字法律顾问 |
+> | 性格特征 | 专业、严谨、审慎 |
+> | 沟通风格 | 准确使用法律术语，同时提供通俗解释 |
 >
-> *(完整内容)*
+> **行为原则**
 >
-> ---
->
-> **principles.md 预览**
->
-> **L0 — 基础约束**
-> - 不提供诉讼代理
->
-> *(完整内容)*
+> | 字段 | 内容 |
+> |------|------|
+> | 最高原则 | 以用户利益为最高优先级，不替代正式法律意见 |
+> | 必须做 | 准确引用法律条文、标注不确定性、建议咨询专业律师 |
+> | 绝不做 | 提供诉讼代理、替代正式法律意见、泄露用户咨询内容 |
+> | 优先级 | 用户安全 > 准确性 > 效率 |
 >
 > ---
 >
@@ -198,17 +181,45 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 
 **API 端点**：`POST /api/agents`
 
-**请求体**：
+**请求体**（结构化格式）：
 
 ```json
 {
   "name": "法律顾问小助手",
   "description": "专注于合同审查和法律风险评估的数字智能体",
-  "persona": "# L0 — 核心身份\n\n你是法律顾问小助手...",
-  "principles": "# L0 — 基础约束\n\n- 不提供诉讼代理..."
+  "persona": {
+    "L0": "你是法律顾问小助手，专注于合同审查和法律风险评估的数字智能体。",
+    "L1": {
+      "role": "专注于合同审查和法律风险评估的数字法律顾问",
+      "personality": ["专业", "严谨", "审慎"],
+      "communication_style": "准确使用法律术语，同时提供通俗解释"
+    }
+  },
+  "principles": {
+    "L0": "以用户利益为最高优先级，不替代正式法律意见。",
+    "L1": {
+      "must_do": ["准确引用法律条文", "标注不确定性", "建议咨询专业律师"],
+      "must_not": ["提供诉讼代理", "替代正式法律意见", "泄露用户法律咨询内容"],
+      "priority": "用户安全 > 准确性 > 效率"
+    }
+  }
 }
 ```
 
+**最简创建**（只需 name，其余全部自动生成）：
+
+```json
+{ "name": "我的助手" }
+```
+
+**基础创建**（name + description，description 自动填充 persona L0）：
+
+```json
+{ "name": "法律顾问", "description": "专注合同审查" }
+```
+
+所有未提供的字段由系统自动补全为合理默认值。`persona` 和 `principles` 也支持传入原始 markdown 字符串（向后兼容）。
+
 **可选**：如需指定 slug ID，可根据 name 生成合理的 kebab-case slug（如 "法律顾问" → "legal-advisor"），在请求体中附带 `"id": "<slug>"`。不指定时系统会自动从 name 生成。
 
 **成功响应** (`201 Created`)：
diff --git a/skills/update-agent/CHANGELOG.md b/skills/update-agent/CHANGELOG.md
index 69e47ce..bac2903 100644
--- a/skills/update-agent/CHANGELOG.md
+++ b/skills/update-agent/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Changelog
 
+## [2.2.0] - 2026-02-27
+
+- 新增结构化 persona/principles API 端点（GET/PUT）说明
+- 推荐使用结构化 API 替代原始文件写入
+
 ## [2.1.0] - 2026-02-26
 
 - 移除 fetch_api 依赖，改为通过 Bash/curl 调用 HTTP API；API 地址由 system prompt 注入；新增 PUT /api/agents/:id/files/* 端点说明
diff --git a/skills/update-agent/SKILL.md b/skills/update-agent/SKILL.md
index 50a67f7..776ace2 100644
--- a/skills/update-agent/SKILL.md
+++ b/skills/update-agent/SKILL.md
@@ -3,7 +3,7 @@ name: update-agent
 description: >-
   安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent
   行为、安装/卸载技能、调整配置、回滚变更或修订规则。
-version: 2.1.0
+version: 2.2.0
 type: meta
 risk_level: high
 status: enabled
@@ -14,8 +14,8 @@ tags:
   - meta
 metadata:
   author: desirecore
-  version: 2.1.0
-  updated_at: '2026-02-26'
+  version: 2.2.0
+  updated_at: '2026-02-27'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -294,9 +294,15 @@ git reset --soft <commit_hash>
 
 ### API 端点
 
-建议优先通过 HTTP API 完成操作，也可直接通过 Read/Write/Edit 工具编辑 AgentFS 文件：
+建议优先通过结构化 HTTP API 完成 persona/principles 更新：
 
-- `PUT /api/agents/:id/files/*` — 更新指定文件内容
+- `GET /api/agents/:id/persona` — 获取当前 persona 的结构化数据（PersonaInput）
+- `PUT /api/agents/:id/persona` — 更新 persona（接受 PersonaInput JSON）
+- `GET /api/agents/:id/principles` — 获取当前 principles 的结构化数据（PrinciplesInput）
+- `PUT /api/agents/:id/principles` — 更新 principles（接受 PrinciplesInput JSON）
+- `PUT /api/agents/:id/files/*` — 更新指定文件内容（原始文本，向后兼容）
+
+**结构化更新流程**：先通过 GET 获取当前数据，修改目标字段后通过 PUT 写回。
 
 API 基础地址已注入到 system prompt 的「本机 API」小节，使用 `Bash` 工具调用 curl 访问即可。