高级定制：命令库、子代理体系与 MCP 自建

当基础用法熟练后，进阶定制的目标是把高频、重复、边界清晰的工作沉淀为可复用、最小权限、可维护的资产：自定义命令、专用子代理与受控的外部连接。本节讲组合设计原则与边界，具体配置语法以当前版本官方文档为准。

一、三类可沉淀资产的分工

资产	适合承载	设计要点
自定义斜杠命令	固定步骤、固定提示模板的重复任务	单一职责、参数与输出要求清晰、可被团队共享
专用子代理	需要隔离上下文、限定工具的角色化任务（只读探索、计划、审查）	明确职责与工具边界，结论精炼回传
外部连接（MCP 等）	对接外部系统数据与操作能力	最小授权、优先官方接入方式、记录用途与风险

二、子代理体系的进阶组织

• 每个子代理声明名称与用途描述（name、description 为基础项）；按需限定可用工具、模型、权限模式、最大轮次、自动压缩窗口、技能、外部服务与排除的记忆文件等可选字段。
• 作用域遵循既定优先级：受管设置优先于命令行指定，再到项目级与用户级定义，最后是插件；需要禁用某子代理时通过权限拒绝规则按名称约束。
• 角色化分工：探索类保持只读、计划类只研究不改动、实现类限定范围、审查类保持新鲜视角；避免一个"万能子代理"承担所有职责。
• 子代理产出应是结构化结论与变更建议，而非把大量原始内容倾倒回主会话。

三、外部连接的安全接入原则

• 优先使用官方提供的接入方式。以 HTTP 传输接入外部服务为例，官方示例形式为通过 CLI 添加连接并指定传输方式与服务地址；具体参数与支持的传输类型以官方文档当前版本为准。
• 按需启用、最小授权：只给任务必需的连接与操作范围；凭据由安全配置提供，不写入共享记忆与提交历史。
• 记录每个连接的用途、提供方与数据流向；不确定可信度的外部服务先在隔离环境评估。

四、定制的反模式与维护

• 过度定制：命令与子代理数量膨胀、职责重叠、无人维护，反而增加认知负担。
• 把一次性提示固化成全局命令，污染所有项目；通用 vs 项目专属要分清作用域。
• 定制资产缺少说明与版本，团队成员不知道用途与前提条件。
• 定期审计：合并重复项、删除失效资产、依据评审反馈更新描述与约束；配置语法随版本变化时以官方文档校准。