feat: 创建与更新技能支持独立长期指令 (#211)

创建与更新技能增加可选 instructions 字符串:普通 Markdown
全文、省略保留、字符串整体替换、空字符串清空。内容归属明确为人格、原则、长期指令与技能方法;既有 AgentFS
直接编辑遵循实际权限与审批。create-agent 2.8.0 / update-agent 3.4.0 的最低客户端为
10.0.179,双语正文与 sidecar 同步。

Add optional plain-Markdown instructions to Agent creation and update
guidance, including preserve/replace/clear semantics and clear content
ownership. Existing direct AgentFS editing retains its permission and
approval rules. Both localized bodies and catalog sidecars require
DesireCore 10.0.179.

验证 / Validation:目录与 i18n 校验 0 errors;严格 sidecar 全覆盖检查 0
errors(既有证据警告保留);双语由人工同步并按真实 source body 计算 freshness
hash。依据用户明确授权,本次以全树凭据形状扫描、Git/PR 元数据扫描与客户中立性人工审阅代替缺失的私有敏感词表检查;凭据形状扫描 740
文件无命中,不声称执行私有词表匹配。
This commit is contained in:
2026-10-07 21:03:40 -07:00
committed by GitHub
parent 8f6aa67c96
commit 13c72eba29
6 changed files with 54 additions and 32 deletions

View File

@@ -8,7 +8,7 @@
## L1:概述
元技能:多轮对话收集需求 → 生成 persona/principles → `ManageAgent(action='create')` 落地。用于为用户培养专业领域数字助手(法律顾问、财务分析师)、企业快速部署定制业务 Agent、或基于模板快速创建原型。创建的仓库符合 AgentFS v2 规范、由 git 管理版本(可治理、可追溯)。价值在工具给不了的部分:领域化的人格/原则生成 + 创建前的预览确认。
元技能:多轮对话收集需求 → 生成 persona/principles 与可选长期指令 → `ManageAgent(action='create')` 落地。用于为用户培养专业领域数字助手(法律顾问、财务分析师)、企业快速部署定制业务 Agent、或基于模板快速创建原型。创建的仓库符合 AgentFS v2 规范、由 git 管理版本(可治理、可追溯)。价值在工具给不了的部分:领域化的人格/原则生成 + 创建前的预览确认。
## L2:详细规范
@@ -26,9 +26,10 @@
### 阶段 3:内容生成
按结构化字段组织 persona 与 principles(不要输出 raw markdown,按字段整理后再展示)。未收集到的字段留空,由系统补全默认:
人格与原则按既有结构化字段组织;长期指令使用普通 Markdown 字符串,先以自然语言说明职责和交付要求。未收集到的字段留空,由系统补全默认:
- **persona**:L0 一句话核心身份;L1 `role`(角色定位)/ `personality`(特征标签数组)/ `communication_style`(沟通风格);L2 专业领域、价值观、决策偏好(free-form)。
- **instructions**:可选普通 Markdown 字符串,维护稳定职责、工作策略与交付契约,全文加载,不使用 L0/L1/L2 或自动截断。详细方法、长 SOP、案例与资料放入技能;只知道名称时省略,不虚构职责。
- **principles**:L0 一句话最高原则;L1 `must_do` / `must_not`(安全红线)/ `priority`(优先级排序);L2 治理原则、升级规则(free-form)。
**领域匹配参考**(据 domain 推荐人格与红线):
@@ -42,7 +43,7 @@
### 阶段 4:用户确认
以自然语言/表格向用户展示预览(名称、描述、人格设定、行为原则;**不展示 raw markdown 源码**),例如:
以自然语言/表格向用户展示预览(名称、描述、人格设定、行为原则、可选长期指令;**不展示 raw markdown 源码**),例如:
> 即将创建「法律顾问小助手」——专注合同审查与法律风险评估。
> **人格**:数字法律顾问;专业、严谨、审慎;准确用法律术语并给通俗解释。
@@ -61,7 +62,8 @@ ManageAgent({
"name": "法律顾问小助手",
"description": "专注于合同审查和法律风险评估的数字智能体",
"persona": { "L0": "…", "L1": { "role": "…", "personality": ["专业","严谨","审慎"], "communication_style": "…" } },
"principles": { "L0": "…", "L1": { "must_do": ["…"], "must_not": ["…"], "priority": "用户安全 > 准确性 > 效率" } }
"principles": { "L0": "…", "L1": { "must_do": ["…"], "must_not": ["…"], "priority": "用户安全 > 准确性 > 效率" } },
"instructions": "# 职责\n写明稳定负责的工作。\n\n## 交付要求\n给出成果位置与必要证据。"
})
```
@@ -128,3 +130,5 @@ ManageAgent({
- AgentFS 结构、排查要点与受保护路径详见 `_agentfs-background.md` 与 `_protected-paths.yaml`。
- 一律经 `ManageAgent` 创建,禁止 curl / HTTP 或直接写 AgentFS 目录;需客户端 ≥ 10.0.90。
角色与表达归人格,边界归原则,稳定职责归长期指令,方法归技能。用户或团队私有数据不得写入可分发 Agent 本体。