Claude Code 输出风格指南：自定义AI助手行为，优化工作流与学习体验
The Agent Skills Directory
安装命令
npx skills add https://smithery.ai/skills/CaptainCrouton89/output-styles-guide🇨🇳中文介绍
输出风格指南
输出风格通过修改系统提示，调整 Claude Code 的行为，使其适用于软件工程之外的用例，从而实现专业化工作流，同时保留核心功能（文件 I/O、脚本执行、TODO 跟踪）。
什么是输出风格？
输出风格是定制的系统提示，用于替换或补充 Claude Code 默认的软件工程焦点。它们：
- 在不需要时排除以效率为中心的编码指令。
- 注入针对特定角色或工作流定制的指令。
- 在项目级别（
.claude/settings.local.json）或用户级别（~/.claude/output-styles）持久化。 - 保留工具访问权限（Bash、文件编辑、TODO 管理）。
内置输出风格
默认
标准的 Claude Code 行为，针对软件工程优化：简洁的输出、代码验证、高效的任务完成。
解释型
在任务之间添加 "见解" 部分，以解释实现选择和代码库模式。非常适合理解复杂代码或教学。
学习型
协作式、边做边学的模式。分享见解，并通过 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 个要点总结"、"包含引用"、"请求反馈"。
- 保留工具灵活性：除非必要，不要禁用基本功能。
- 在分发前用几个任务测试以验证行为。
常见用例
| 用例 | 风格 | 优势 |
|---|---|---|
| 学习代码库 | 解释型 | 理解代码为何如此结构化的原因 |
| 工程师入职 | 学习型 | 积极参与，动手技能培养 |
| 研究/分析 | 自定义 | 深度优先调查，假设跟踪 |
| 技术写作 | 自定义 | 结构化大纲、示例、术语表生成 |
| 产品/用户体验工作 | 自定义 | 专注于人物角色、用户流程、旅程地图绘制 |
输出风格与相关功能对比
| 功能 | 目的 | 范围 |
|---|---|---|
| 输出风格 | 持久化的系统提示修改 | 影响所有主要代理交互 |
| 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/（用户） |
每周安装次数
–
来源
首次出现
–
🇺🇸English
Output Styles Guide
Output styles adapt Claude Code's behavior for use cases beyond software engineering by modifying the system prompt, enabling specialized workflows while retaining core capabilities (file I/O, script execution, TODO tracking).
What Are Output Styles?
Output styles are customized system prompts that replace or supplement Claude Code's default software engineering focus. They:
- Exclude efficiency-focused coding instructions when not needed.
- Inject custom instructions tailored to a specific role or workflow.
- Persist at project level (
.claude/settings.local.json) or user level (~/.claude/output-styles). - Preserve tool access (Bash, file editing, TODO management).
Built-In Output Styles
Default
Standard Claude Code behavior optimized for software engineering: concise output, code verification, efficient task completion.
Explanatory
Adds "Insights" sections between tasks to explain implementation choices and codebase patterns. Ideal for understanding complex code or teaching.
Learning
Collaborative, learn-by-doing mode. Shares insights and requests your contribution on small code sections via TODO(human) markers. Best for skill-building or onboarding.
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
