name: 输出定制化 description: Claude Code输出风格的中央权威。涵盖内置输出样式(默认、解释性、学习)、自定义输出样式、输出样式前部元数据(名称、描述、保持编码指令)、/output-style命令、样式切换、输出样式创建和定制、输出样式比较(与CLAUDE.md、与代理、与斜杠命令的比较)以及输出样式设置。协助选择适当的输出样式、创建自定义样式、配置输出行为以及理解样式差异。100%委托给docs-management技能以获取官方文档。 user-invocable: false allowed-tools: Read, Glob, Grep, Skill
输出样式元技能
🚨 强制性:首先调用docs-management
停止 - 在提供任何关于输出样式的响应之前:
- 调用
docs-management技能- 查询 用户的具体主题
- 基于 所有响应,完全依赖已加载的官方文档
跳过此步骤将导致过时或不正确的信息。
验证检查点
在响应之前,验证:
- [ ] 我是否调用了docs-management技能?
- [ ] 官方文档是否已加载?
- [ ] 我的响应是否完全基于官方文档?
如果任何复选框未勾选,停止并首先调用docs-management。
概述
Claude Code输出风格的中央权威。此技能使用 100%委托给docs-management - 它不包含任何重复的官方文档。
架构: 纯委托与关键词注册表。所有官方文档通过docs-management技能查询访问。
何时使用此技能
关键词: 输出样式,输出风格,简洁样式,详细样式,Markdown样式,代码稀疏样式,/output-style命令,自定义输出样式,输出样式前部元数据,输出样式提示,样式切换,输出行为,响应格式,输出格式化
在以下情况使用此技能:
- 理解可用输出样式
- 为任务选择适当的输出样式
- 创建自定义输出样式
- 配置输出样式前部元数据
- 切换输出样式
- 比较输出样式行为
- 自定义输出格式和详细程度
docs-management查询的关键词注册表
查询docs-management技能以获取官方文档时使用这些关键词:
输出样式基础
| 主题 | 关键词 |
|---|---|
| 概述 | “输出样式”, “输出样式概述”, “响应格式化” |
| 内置样式 | “内置输出样式”, “默认样式” |
| 自定义样式 | “自定义输出样式”, “创建输出样式” |
内置样式
| 主题 | 关键词 |
|---|---|
| 默认样式 | “默认输出样式”, “默认样式”, “软件工程样式” |
| 解释性样式 | “解释性样式”, “解释性输出”, “教育见解”, “代码库见解” |
| 学习样式 | “学习样式”, “学习输出”, “边做边学”, “TODO人类标记”, “协作编码” |
样式配置
| 主题 | 关键词 |
|---|---|
| 前部元数据 | “输出样式前部元数据”, “样式YAML前部元数据” |
| 名称字段 | “输出样式名称”, “样式命名” |
| 描述字段 | “输出样式描述”, “样式描述” |
| 保持编码指令 | “保持编码指令”, “编码指令”, “软件工程提示” |
| 样式文件位置 | “输出样式文件位置”, “~/.claude/output-styles”, “.claude/output-styles”, “用户级样式”, “项目级样式” |
样式管理
| 主题 | 关键词 |
|---|---|
| 切换样式 | “/output-style命令”, “切换输出样式”, “更改样式” |
| 样式选择 | “选择输出样式”, “选择样式”, “样式推荐” |
| 样式比较 | “比较输出样式”, “样式差异”, “样式比较” |
使用案例
| 主题 | 关键词 |
|---|---|
| 基于任务的选择 | “输出样式使用案例”, “何时使用样式” |
| 编码任务 | “输出样式编码”, “代码聚焦样式” |
| 文档任务 | “输出样式文档”, “写作聚焦样式” |
| 学习任务 | “输出样式学习”, “教育样式” |
与相关功能比较
| 主题 | 关键词 |
|---|---|
| 与CLAUDE.md比较 | “输出样式与CLAUDE.md”, “系统提示与用户消息”, “输出样式CLAUDE.md差异” |
| 与append-system-prompt比较 | “输出样式与append-system-prompt”, “系统提示修改”, “–append-system-prompt” |
| 与代理比较 | “输出样式与代理”, “输出样式代理差异”, “子代理与输出样式” |
| 与技能比较 | “输出样式与技能”, “存储提示与存储系统提示” |
自定义样式开发
| 主题 | 关键词 |
|---|---|
| 创建样式 | “创建自定义输出样式”, “新输出样式” |
| 样式模板 | “输出样式模板”, “样式起点” |
| 样式位置 | “输出样式文件位置”, “保存样式的位置” |
| 样式测试 | “测试输出样式”, “验证样式” |
快速决策树
您想做什么?
- 理解可用样式 -> 查询docs-management: “内置输出样式”, “输出样式概述”
- 使用默认编码助手 -> 查询docs-management: “默认输出样式”, “软件工程样式”
- 了解代码库 -> 查询docs-management: “解释性样式”, “教育见解”
- 边做边学(实践) -> 查询docs-management: “学习样式”, “TODO人类标记”, “边做边学”
- 切换输出样式 -> 查询docs-management: “/output-style命令”, “切换输出样式”
- 创建自定义样式 -> 查询docs-management: “创建自定义输出样式”, “输出样式前部元数据”
- 与相关功能比较 -> 查询docs-management: “输出样式与CLAUDE.md”, “输出样式与代理”
- 保存样式文件的位置 -> 查询docs-management: “输出样式文件位置”, “~/.claude/output-styles”
主题覆盖
内置输出样式
- 默认:标准软件工程助手行为
- 解释性:在任务之间添加教育“见解”以帮助理解实现选择
- 学习:协作边做边学模式,带有
TODO(人类)标记供用户贡献
输出样式前部元数据
- 名称字段(可选 - 默认为文件名)
- 描述字段(可选 - 用于/output-style菜单中的UI显示)
- 保持编码指令字段(可选 - 默认false,是否在系统提示中保持编码指令)
样式配置选项
- 默认样式配置
- 每会话样式切换
- 跨会话样式持久性
/output-style命令
- 列出可用样式
- 切换到不同样式
- 查看当前样式
- 样式选择语法
自定义样式创建
- 自定义样式文件位置
- 前部元数据结构
- 自定义行为的提示设计
- 测试和验证
样式选择标准
- 基于任务的推荐
- 详细程度偏好
- 输出格式需求
- 代码与解释平衡
样式比较
- 输出样式与CLAUDE.md与–append-system-prompt(系统提示修改方法)
- 输出样式与代理(主循环与特定任务,不同配置选项)
- 输出样式与技能(存储系统提示与存储提示)
- 每种方法的适用场景
委托模式
标准查询模式
用户问:"有哪些输出样式可用?"
1. 调用docs-management技能
2. 使用关键词:"内置输出样式", "输出样式概述"
3. 加载官方文档
4. 完全基于官方文档提供指导
多主题查询模式
用户问:"我想要简短响应,代码更少"
1. 使用多个查询调用docs-management技能:
- "简洁样式", "简短响应"
- "代码稀疏样式", "最小代码"
2. 从官方文档合成指导
故障排除模式
用户报告:"我的自定义输出样式不起作用"
1. 调用docs-management技能
2. 使用关键词:"输出样式前部元数据", "创建自定义输出样式"
3. 检查官方文档以获取样式配置要求
4. 指导用户进行适当的样式设置
故障排除快速参考
| 问题 | docs-management的关键词 |
|---|---|
| 样式未更改 | “/output-style命令”, “切换输出样式” |
| 自定义样式未加载 | “输出样式前部元数据”, “样式文件位置” |
| 响应过于详细 | “简洁样式”, “简短响应” |
| 细节不足 | “详细样式”, “详细响应” |
| 想要格式化输出 | “Markdown样式”, “格式化输出” |
| 输出中代码过多 | “代码稀疏样式”, “最小代码” |
| 样式选择指导 | “输出样式使用案例”, “样式推荐” |
存储库特定说明
此存储库当前未使用自定义输出样式。输出样式文档适用于:
- 理解输出样式如何影响响应行为
- 为存储库特定工作流创建潜在自定义样式
- 理解团队偏好的样式配置
在处理输出样式主题时,始终使用docs-management技能访问官方文档。
审核输出样式
此技能提供output-style-auditor代理进行正式审核所使用的验证标准。
审核资源
| 资源 | 位置 | 目的 |
|---|---|---|
| 审核框架 | references/audit-framework.md |
查询指南和评分标准 |
评分类别
| 类别 | 分数 | 关键标准 |
|---|---|---|
| 文件结构 | 20 | 正确位置,.md扩展名 |
| YAML前部元数据 | 30 | 必需字段存在且有效 |
| 内容质量 | 30 | 清晰指令,适当结构 |
| 兼容性 | 20 | 与样式切换配合,无冲突 |
阈值: 85+ = 通过,70-84 = 通过但有警告,<70 = 失败
相关代理
output-style-auditor代理(Haiku模型)使用此技能进行正式审核:
- 通过
skills: output-customization自动加载此技能 - 使用审核框架和docs-management获取规则
- 生成结构化审核报告
- 通过
/audit-output-styles命令调用
外部技术验证
审核引用外部技术(脚本、包、运行时)的输出样式时,审核员必须在标记发现前使用MCP服务器验证声明。
需要MCP验证的技术:
- .NET/C#脚本:使用microsoft-learn + perplexity验证
- Node.js/npm包:使用context7 + perplexity验证
- Python脚本/包:使用context7 + perplexity验证
- Shell脚本:使用perplexity验证
- 任何版本特定声明:始终使用perplexity验证
验证规则:
在未首先执行以下操作的情况下,切勿将技术使用标记为不正确:
- 查询适当的MCP服务器以获取当前文档
- 使用perplexity验证最近更改(尤其是.NET 10+)
- 在发现中记录MCP来源
陈旧数据警告:
- microsoft-learn可能返回缓存/过时文档
- 始终配对microsoft-learn与perplexity以进行版本验证
- 信任perplexity获取版本号和最近发布的功能
参考文献
官方文档(通过docs-management技能):
- 主要:"output-styles"文档
- 相关:“settings”, “configuration”, “terminal-config”
存储库特定:
- 输出样式设置:
.claude/settings.json(outputStyle设置)
版本历史
- v1.1.0(2025-11-27):内容准确性修复
- 修复内置样式(默认、解释性、学习 - 非简洁/详细/Markdown/代码稀疏)
- 修复前部元数据字段(保持编码指令,非"提示")
- 添加"与相关功能比较"部分(与CLAUDE.md、与代理、与斜杠命令)
- 添加文件位置关键词(~/.claude/output-styles,.claude/output-styles)
- 更新决策树以包含正确样式
- 更新主题覆盖以包含准确描述
- v1.0.0(2025-11-26):初始发布
- 纯委托架构
- 全面关键词注册表
- 快速决策树
- 所有输出样式功能的主题覆盖
- 故障排除快速参考
最后更新
日期: 2025-11-28 模型: claude-opus-4-5-20251101