docs: limit total capability text to 50 characters

2026-09-23 13:05:55 +08:00
parent 7699540239
commit 5183220455
1 changed files with 3 additions and 2 deletions
@@ -1,7 +1,8 @@
 # Agent Capabilities 格式与编写

 `agent.capabilities` 描述可分派、可验证的稳定交付能力，不代表权限或工具已经获准。
-每条 capability 不超过 50 个字符（含标点与空格），优先用简洁动宾短句表达。
+`agent.capabilities` 所有条目的文本长度合计不得超过 50 个字符（含文本内标点与空格，
+不计 JSON 结构字符），优先用简洁动宾短句表达。

 ## 提取与表达

@@ -17,7 +18,7 @@
 ## 写入与检查

 - 只更新 manifest 的 `agent.capabilities`，不新增私有字段或同步到 Version API 兼容字段。
- 至少保留一项真实能力；删除空值、重复项和占位符，逐条确认不超过 50 个字符；
+- 至少保留一项真实能力；删除空值、重复项和占位符，确认所有条目文本的字符数之和不超过 50；
  当前 schema 有更严格约束时同时满足。
 - 每条能力都应能追溯到实际职责、实现及可观察结果；用真实任务检查是否足以支持分派。
 - 依赖缺失时说明需要补充的内容，不以扩大声明替代实现，也不擅自改变权限或其他模块。