name: 输出样式指南 description: 通过为教学、学习、分析或领域特定工作流定制系统提示，将Claude代码适应于软件工程以外的用途。 allowed-tools: []

输出样式指南

输出样式通过修改系统提示来适应Claude代码的行为，使其适用于软件工程以外的用途，同时保留核心功能（文件I/O、脚本执行、TODO跟踪），实现专门的工作流。

什么是输出样式？

输出样式是定制的系统提示，用于替换或补充Claude代码默认的软件工程焦点。它们：

在不需要时排除效率导向的编码指令。
注入针对特定角色或工作流的自定义指令。
在项目级别（.claude/settings.local.json）或用户级别（~/.claude/output-styles）持久保存。
保留工具访问权限（Bash、文件编辑、TODO管理）。

内置输出样式

默认

标准Claude代码行为，针对软件工程优化：简洁输出、代码验证、高效任务完成。

解释性

在任务之间添加“见解”部分，解释实现选择和代码库模式。适合理解复杂代码或教学。

学习

协作式、边做边学模式。分享见解，并通过TODO(human)标记请求您对小代码部分的贡献。最适合技能建设或新手上手。

更改输出样式

交互式菜单：

/output-style
# 或通过/config访问

直接命令：

/output-style explanatory
/output-style default
/output-style learning

更改在项目级别应用并保存到.claude/settings.local.json。

创建自定义输出样式

快速开始（引导式）：

/output-style:new 我想要一个输出样式，用于[描述您的用途]

Claude创建并保存模板；您进行优化。

手动创建：

在~/.claude/output-styles/<名称>.md（用户级别，跨项目共享）或.claude/output-styles/<名称>.md（仅项目级别）创建一个markdown文件。

结构：

---
name: 我的自定义样式
description: 在/output-style菜单中显示的简要描述
---

# 自定义样式指令

您是一个交互式CLI工具。[您的指令在此...]

## 特定行为

[定义助手如何行为...]

示例：研究助手样式

---
name: 研究助手
description: 专注于深度优先分析，带有引用和假设跟踪。
---

# 研究助手模式

您是一个研究伙伴，专门从事深度调查和综合。

## 特定行为

- 在做出主张时请求来源并引用证据。
- 明确跟踪开放假设。
- 以带置信度的项目符号格式总结发现。
- 标记不确定性并建议下一步调查步骤。

自定义样式最佳实践：

具体：例如，“用3个项目符号总结”、“包括引用”、“请求反馈”。
保留工具灵活性：除非必要，不要禁用基本功能。
先用几个任务测试以验证行为，再分发。

常见用途

用途	样式	好处
学习代码库	解释性	理解代码为何这样结构
新手上手工程师	学习	主动参与，实践技能建设
研究/分析	自定义	深度优先调查，假设跟踪
技术写作	自定义	结构化大纲、示例、术语表生成
产品/UX工作	自定义	人物、用户流程、旅程映射焦点

输出样式与相关功能对比

功能	目的	范围
输出样式	持久系统提示修改	影响所有主代理交互
CLAUDE.md	项目级别指令，在系统提示后添加	补充默认行为；不替换它
–append-system-prompt	运行时系统提示添加	每次会话一次性追加
代理	任务特定执行，带有自定义工具/模型	单一用途委托；不影响主循环
自定义斜杠命令	存储的用户提示（输入模板）	重复请求的简写

关键区别： 样式替换核心系统指令；其他添加。

提示与故障排除

不持久？ 验证保存位置：.claude/settings.local.json用于项目，~/.claude/output-styles/用于用户级别样式。
丢失格式？ 保持自定义样式描述少于100字符，便于菜单可读性。
想分享？ 在项目级别（.claude/output-styles/）保存自定义样式并提交到Git。
恢复？ 运行/output-style default或从.claude/settings.local.json删除。
堆叠指令？ 使用CLAUDE.md与样式一起，为自定义样式添加项目特定规则。

快速参考

操作	命令
查看可用样式	`/output-style`
直接切换	`/output-style [样式名称]`
创建自定义	`/output-style:new [描述]`
打开配置	`/config`
访问设置	`.claude/settings.local.json`（项目）或`~/.claude/output-styles/`（用户）