开发工具CLIAI 应用【免费下载链接】zcfZero-Config Code Flow for Claude code Codex项目地址https://gitcode.com/gh_mirrors/zc/zcf点击查看免费下载输出风格Output Style是 ZCFZero-Config Code Flow for Claude Code Codex提供的高优先级系统提示词机制用于统一定义 AI 助手的人格特质、编码规范、质量标准与工作方法。本指南以 docs/en/best-practices/output-styles.md 为主线结合仓库源码实现系统讲解输出风格的安装、切换、编辑、预置风格清单、自定义风格与团队落地最佳实践读完即可在团队与项目中建立一套可版本化、可复用、可随时切换的 AI 协作标准。什么是输出风格Output Style输出风格本质上是存放在prompts/output-style/目录下的 Markdown 文件属于高优先级系统提示词适合承载团队标准、编码规范与 AI 行为准则。通过配置不同的输出风格可以精确控制 AI 助手的人格与工作方式。从 ZCF 的实现来看输出风格文件定义了 AI 助手的四个维度人格特质Personality TraitsAI 的说话方式与行为特征编码规范Coding Standards代码风格、注释要求、命名约定✅质量标准Quality Standards代码评审标准、测试要求工作方法Working Methods问题分析方法、决策流程在源码层面src/utils/output-style.ts 通过OutputStyle接口将每种风格建模为{ id, isCustom, filePath }三要素其中isCustom: true的风格拥有真实模板文件存放在templates/common/output-styles/下而isCustom: false的风格为 Claude Code 内置风格、无需模板即可使用。输出风格的管理方法安装输出风格在初始化 ZCF 时通过--output-styles短参数-o参数指定需要安装的风格# 安装全部输出风格 npx zcf init -o all # 安装指定风格多个风格用英文逗号分隔 npx zcf init -o engineer-professional,nekomata-engineer # 跳过输出风格安装 npx zcf init -o skip参数解析逻辑位于 src/commands/init.tsall会被展开为[engineer-professional, nekomata-engineer, laowang-engineer]三个默认风格skip会被置为false跳过安装逗号分隔的字符串则被拆分并去空格后作为风格 ID 列表。值得注意的是即便你不显式传参init的默认值也会安装上述三个风格并将engineer-professional设为全局默认风格。在非交互--skip-prompt模式下init会对输出风格 ID 做合法性校验src/commands/init.ts 中的validStyles数组只接受engineer-professional、nekomata-engineer、laowang-engineer、default、explanatory、learning这六个 ID非法值会直接抛出invalidOutputStyle错误。切换输出风格在主菜单中切换npx zcf # 选择 6Configure AI Memory Output Style / 配置 AI 记忆与输出风格 # 然后进入输出风格管理子菜单交互式切换流程由 src/utils/output-style.ts 的configureOutputStyle()驱动先用 checkbox 多选要安装的自定义风格默认全选再通过 list 单选设置全局默认风格默认倾向engineer-professional。若你一个自定义风格都不选程序会进一步询问是否设置内置风格作为默认或者选择 none 彻底清除已有配置。在项目中切换Claude Code在会话中直接使用斜杠命令/output-style engineer-professionalCodex编辑config.toml中的systemPromptStyle字段或通过系统提示词配置。ZCF 对 Codex 的完整初始化流程runCodexFullInitsrc/utils/code-tools/codex.ts会把输出风格选择映射为systemPromptStyle其风格文件同样来自templates/common/output-styles/目录并优先使用当前语言目录、缺失时回退到zh-CN。编辑输出风格输出风格文件位于prompts/output-style/目录可直接用编辑器修改# 查看已安装的风格 ls -la ~/.claude/prompts/output-style/ # 编辑某个具体风格 vim ~/.claude/prompts/output-style/engineer-professional.md # 创建自定义风格 vim ~/.claude/prompts/output-style/my-custom-style.md源码层面ZCF 通过copyOutputStyles()将风格模板从包内templates/common/output-styles/语言/复制到~/.claude/output-styles/源码中实际写入的目录名为output-styles安装完成后即成为 Claude Code 可识别的风格目录。全局默认风格则通过setGlobalDefaultOutputStyle()写入 Claude 的settings.json~/.claude/settings.json中的outputStyle字段字段定义见 src/types/config.ts 的ClaudeSettings.outputStyle。预配置的输出风格ZCF 官方文档声明的预配置风格如下表风格 ID名称特点适用场景engineer-professional专业工程师Professional Engineer严谨、专业、注重代码质量正式项目、企业环境nekomata-engineer猫娘工程师Nekomata Engineer轻松友好同时保持专业性个人项目、轻松氛围laowang-engineer老王工程师Laowang Engineer幽默接地气直接高效中文项目、国内团队ojousama-engineer大小姐工程师Ojousama Engineer优雅精致注重细节特定场景、风格化项目rem-engineer蕾姆女仆工程师Rem Maid Engineer温柔奉献冷静果断需要细致呵护的项目内置输出风格除预配置风格外以下内置风格始终可用无需安装模板default默认输出风格explanatory解释型风格注重详细说明learning学习型风格注重教学讲解源码OUTPUT_STYLES数组src/utils/output-style.ts与 i18n 配置src/i18n/locales/en/configuration.json还揭示了一个文档表格之外的细节仓库实际维护了第六个自定义风格leibus-engineer雷布斯工程师营销天才型工程师背景同样拥有独立模板。这意味着templates/common/output-styles/en/目录下共有 6 个风格模板可用只是默认安装集合只包含前三个。以engineer-professional模板templates/common/output-styles/en/engineer-professional.md为例可以直观看到风格文件的实际写法它包含危险操作确认机制文件系统、git 提交、系统配置、数据操作、网络请求、包管理六类高风险操作必须显式确认、命令执行标准路径加双引号、优先/分隔符、rg优先于grep、KISS/YAGNI/DRY/SOLID 四组编程原则的可执行化描述以及持续解决问题的行为准则。这四部分恰好就是前文所述的人格特质、编码规范、质量标准、工作方法四维度的具体实现。实践建议1. 将团队标准写进输出风格输出风格是定义团队开发标准的理想载体例如建立一份团队编码规范风格文件# ~/.claude/prompts/output-style/team-standards.md ## Coding Standards - Use TypeScript, strict mode - Functions no more than 50 lines - Must write unit tests - Use ESLint and Prettier - Follow SOLID principles ## Code Review Requirements - All PRs must go through code review - Ensure test coverage 80% - Check performance impact - Verify security2. 创建多种风格按需切换为不同场景创建不同风格并在会话中随时切换# 开发期间使用专业工程师风格 /output-style engineer-professional # 代码评审期间使用评审专用风格 /output-style code-review # 写文档期间使用文档风格 /output-style documentation3. 项目专属风格需要独立风格的项目可在项目根目录使用项目级输出风格# 在项目根目录创建 Project Root/.claude/output-style/project-specific.md # 在会话中使用 /output-style project-specific项目级风格会覆盖全局风格但只在当前项目内生效。对应地Codex 项目级目录为.codex/output-style/。4. 风格优先级输出风格的优先级从上到下递减项目专属风格.claude/output-style/或.codex/output-style/全局默认风格~/.claude/prompts/output-style/中的默认设置内置风格default、explanatory、learning这一优先级模型与源码的冲突处理逻辑一致configureOutputStyle()中当用户显式选择内置风格时会直接调用setGlobalDefaultOutputStyle()写全局配置而项目级.claude/output-style/目录天然优先于全局目录被 Claude Code 读取。5. 纳入版本控制将团队输出风格纳入版本控制实现团队标准化分发# 创建团队风格仓库 mkdir team-output-styles cp ~/.claude/prompts/output-style/team-standards.md team-output-styles/ # 纳入 Git git add team-output-styles/ git commit -m Add team output style standards # 团队成员同步 git pull cp team-output-styles/team-standards.md ~/.claude/prompts/output-style/输出风格文件结构一个典型的输出风格文件应包含以下四部分结构# Output Style Name ## Personality Traits Describe AIs speaking style and behavior ## Coding Standards - Code style requirements - Naming conventions - Comment requirements ## Quality Standards - Code review standards - Testing requirements - Performance standards ## Working Methods - Problem analysis methods - Decision processes - Collaboration methods仓库中的真实模板基本遵循这一骨架YAML front matter 中的name与description字段用于在配置界面中展示风格名称与描述i18n 文案亦与此一一对应正文则按身份定义 → 核心行为标准 → 响应特征层层展开。以rem-engineer模板templates/common/output-styles/en/rem-engineer.md为例其核心行为标准细分为危险操作确认机制、执行标准、编程原则执行、持续守护四节并附带模式切换表与动作描述等氛围增强内容——这些全部以系统提示词形式进入每次对话构成完整的 AI 行为约束。自定义输出风格创建自定义风格创建风格文件vim ~/.claude/prompts/output-style/my-style.md编写风格内容# My Custom Style You are a professional full-stack engineer, focusing on: - Code quality and maintainability - Performance optimization - Security considerations - User experience ## Coding Standards - Use TypeScript - Follow Airbnb code standards - Write complete type definitions - Must include error handling ## Working Methods - Understand requirements before coding - Write tests for test-driven development - Focus on code reuse - Continuous refactoring and optimization使用自定义风格# 设置默认风格 npx zcf # 选择 6然后选择 my-style # 或在项目中使用 /output-style my-style团队共享风格通过版本控制分发自定义风格# 1. 导出风格文件 cp ~/.claude/prompts/output-style/team-style.md ./team-styles/ # 2. 纳入版本控制 git add team-styles/ git commit -m Add team output style # 3. 团队成员导入 git pull cp team-styles/team-style.md ~/.claude/prompts/output-style/最佳实践1. 分层定义标准全局风格Global Style团队通用的编码规范与标准项目风格Project Style项目特定的要求与约束角色风格Role Style为不同角色定义风格开发者、评审者、文档撰写者2. 保持风格简洁输出风格应简洁明了避免过度冗长✅推荐核心标准与关键要求❌不推荐过于琐碎的细节应放到项目文档中这一点在源码中同样有体现自定义风格模板如engineer-professional、nekomata-engineer、ojousama-engineer都遵循统一的核心行为标准模板结构用高度精炼的条目承载工程原则而非堆砌长篇说明。3. 定期更新风格随着项目发展和团队成长应定期更新输出风格# 定期评审与更新 vim ~/.claude/prompts/output-style/engineer-professional.md # 团队讨论后更新并提交 git add prompts/output-style/ git commit -m Update output style standards4. 测试风格效果创建新风格后务必实测其效果# 1. 设置新风格 /output-style my-new-style # 2. 进行测试对话 Please help me implement a simple Todo feature # 3. 评估输出是否符合预期 # 4. 根据反馈调整风格5. 为风格编写文档为自定义风格编写配套说明文档# team-standards.md ## Style Description This style defines our teams development standards and quality standards. ## Usage Scenarios - Formal project development - Code review - Technical review ## Update History - 2025-01-15: Initial version - 2025-02-01: Added performance requirements注意事项Claude Code 版本要求⚠️版本要求Claude Code 版本必须大于 1.0.81 才能支持输出风格✅检查版本使用npx zcf check-updates检查并更新迁移说明旧版本的全局记忆规则已迁移到engineer-professional风格中关于旧版本迁移源码提供了可验证的佐证configureOutputStyle()会检测~/.claude/下的遗留文件personality.md、rules.md、technical-guides.md、mcp.md、language.md定义于 src/utils/output-style.ts 的LEGACY_FILES常量发现后提示用户清理非交互模式下则自动清理——这正是旧版全局记忆规则迁移到输出风格的落地实现。风格文件位置Claude Code~/.claude/prompts/output-style/Codex~/.codex/prompts/output-style/如支持项目级.claude/output-style/或.codex/output-style/风格冲突处理若多个风格同时存在按以下顺序裁决项目级风格优先全局默认风格其次内置风格兜底相关资源模板系统Templates —— 更详细的模板与输出风格讲解配置管理Multi-Config —— 多配置与备份管理使用技巧Usage Tips —— 更多实用技巧提示合理使用输出风格可以显著提升代码质量与开发效率。建议在团队内统一输出风格标准并根据项目特性做适当定制输出风格应保持简洁清晰聚焦核心标准与关键要求。从源码看ZCF 的默认安装集与默认风格engineer-professional正是这一先统一、再定制理念的默认落地——团队可在此基础上通过版本控制持续演化自己的风格体系。赞分享开发工具CLIAI 应用【免费下载链接】zcfZero-Config Code Flow for Claude code Codex项目地址https://gitcode.com/gh_mirrors/zc/zcf点击查看免费下载相关推荐为 Claude 首席参谋 Agent 定制 executive 输出风格从 output-style 模板到 Agent SDK 的参数化落地为 Claude 首席参谋 Agent 定制 executive 输出风格从 output style 模板到 Agent SDK 的参数化落地 导读 本文以示例工程bge-small-zh-v1.5模型训练全解析从数据准备到模型微调bge small zh v1.5模型训练全解析从数据准备到模型微调 bge small zh v1.5是一款高效的中文文本嵌入模型能够将文本转换为低维稠密2025最新Checkstyle实战教程从安装配置到团队规范落地2025最新Checkstyle实战教程从安装配置到团队规范落地 Checkstyle作为Java开发中不可或缺的代码质量工具能够帮助开发团队统一编码规范开发工具代码质量Lint静态分析上一篇ShameCom终极指南如何将校招避坑神器融入日常求职流程下一篇终极指南如何用Shan-Shui-Inf快速生成无限滚动的中国山水画创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考