用途
UB Authoring 用于塑造可移植、可安装的技能编写指导及相关智能体行为界面。它拥有应随技能目录本身一起分发的可复用编写约定,而非将这些约定放在仅限仓库的文档或某个定制化专用的技能中。
主要能力
- 编写、审查和重构可安装技能、共享技能参考以及可复用的智能体编写指导。
- 将描述视为路由元数据,而非营销文案。
- 在错误激活成本较高或较常见时,添加明确的非使用边界。
- 优先给出具体示例和验收边界,而非模糊告诫。
- 保持主技能面精简,把更深入的细节移入有针对性的参考文档。
- 让共享编写指导在已安装的技能载荷之间保持可移植,并避免在可复用约定中写入仓库本地的实时真相。
- 将可复用的选择题交互约定保留在共享编写指导中,而不是在每个技能中重复编码相同的多选题规则。
使用方式
核心工作流:
- 判断任务是在更改可复用的编写约定,还是单个技能的本地内容。
- 将可移植的共享指导保留在本技能中,将领域特定指导保留在拥有该领域的技能中。
- 仅在变更面确实受益时,规范化描述、示例、非使用边界和共享选择题行为。
- 保持可复用参考可安装,避免指向仅限仓库文档的死链。
按需加载:在塑造共享技能结构、跨技能措辞、路由质量、可复用选择题交互或其他可复用编写模式时,阅读 references/authoring-conventions.md。
产出非平凡的编写更新时,需包含:routing_note、boundary_note、reference_note、validation_note。
适用场景
- 创建、审查或重构可安装技能及其共享参考。
- 调整跨技能的编写约定、路由描述与示例边界。
- 统一可复用的选择题交互约定。
限制
- 不用于端到端定制生成,该任务应交给 ub-customizations。
- 不用于普通代码实现或框架工作,除非涉及共享编写契约的变更。
- 不能替代属于开发仓库而非可分发技能载荷的仓库本地维护文档或打包元数据。
完成检查清单:共享指导在 .agents/skills/ 内保持可移植;描述措辞读起来像路由逻辑而非清单式散文;在误路由现实存在处明确非使用边界;在抽象指导易被误用时给出具体示例;共享参考避免仅限仓库的假设,除非明确标注。