SuperAPI AI 工具集

generating-output-styles

编程与开发

查看项目

更新于 10-15 16:45

技能介绍

用途:为 Claude Code 创建自定义 output style。output style 通过修改系统提示词,让 Claude Code 的行为超出软件工程范畴,直接影响主代理循环,控制回复的语气、结构与方式。

主要能力:生成带 frontmatter 的合法 output style markdown 文件;遵循命名与描述规范;按渐进披露组织指令;正确配置 keep-coding-instructions;放入用户级 ~/.claude/output-styles/ 或项目级 .claude/output-styles/。

工作流程:先收集需求,确定用途与目标行为、是否保留编码指令、选择存放位置,并参考 .claude/skills/output-style/references/output-style-docs.md。再创建文件,frontmatter 包含 name(标题式、简洁、显示在 UI)、description(面向终端用户,200 字符内)、keep-coding-instructions(默认 false,false 会移除软件工程指令,true 则在保留编码指导基础上叠加修改)。正文从角色定义开始,写明具体行为、格式化指南与约束,用 markdown 标题组织,保持简明可执行,避免与 Claude Code 核心功能矛盾,侧重增量指令。最后校验 YAML 语法(开头结尾的 ---)并保存,用 /output-style 命令测试激活。

文件格式示例:frontmatter 后接自定义说明与具体行为章节。示例包括 Technical Writer(keep-coding-instructions: true,详细文档与解释)和 Minimalist(keep-coding-instructions: true,回复尽量 5 行内、少解释)。

限制:必须含合法 YAML frontmatter 与全部必填字段;指令应补充而非矛盾于核心 Claude Code;不能覆盖工具权限或安全限制;文件须为 .md 扩展名并放在可识别的 output-styles 目录;description 会显示在 UI 中,须对用户友好。可通过 /output-style 验证是否出现在菜单、激活并以代表性任务测试,迭代后确认样式保存在 .claude/settings.local.json。