# STYLE > STYLE 文档：包的形态、包级字段、规则、原生 hook、命令行和诊断码。下面每个链接都是一页 Markdown 原文。 ## 基础 包有哪几种形态、style 读取包时做了什么，以及从编写、校验到隔离测试的完整流程。 - [概览：包的形态与加载流程](https://style.pixulse.com/docs/style-yaml/overview.md): STYLE 包有两种形态：目录包和单文件包。本页说明它们的结构，以及 `style` 读取一个包时依次做了什么。 - [写作与测试：从校验到重放事件](https://style.pixulse.com/docs/style-yaml/authoring.md): 写完规则后，怎么在不影响真实环境的前提下，确认它在 Codex 和 Claude Code 上按预期匹配、去重和输出。 ## 包级字段 写在 STYLE.yaml 顶层、作用于整个包的字段：元数据、依赖与设置、token 预算和默认值。 - [package：包级元数据](https://style.pixulse.com/docs/style-yaml/package.md): 标识一个 STYLE 包的基本信息：规范版本、名称、版本号、描述、作者和默认优先级。 - [requires：依赖、设置与推荐](https://style.pixulse.com/docs/style-yaml/requires.md): 声明包对 STYLE 运行时和 harness 版本的要求、安装时由用户填写的配置项，以及推荐给各 harness 的配置。 - [budget：token 预算](https://style.pixulse.com/docs/style-yaml/budget.md): 限制规则注入给模型的文本量：单条规则、单个事件、常驻内容各有上限，超出时报警告或错误。 - [defaults：包级默认值](https://style.pixulse.com/docs/style-yaml/defaults.md): 给包里所有规则统一设置默认值，避免在每条规则里重复同一个字段。 ## 规则 一条规则的全部字段：正文来源、作用对象、动作与时机、条件匹配，以及落点不可用时的降级。 - [rules：规则来源与正文](https://style.pixulse.com/docs/style-yaml/rules.md): 说明一条规则从哪里来、正文怎么写，以及正文里可以使用的模板变量。 - [target：规则作用对象](https://style.pixulse.com/docs/style-yaml/target.md): `target` 决定规则在什么时候生效：整个会话、某类工具调用、某个 MCP 工具、某个 skill，或某个具体事件。 - [action：动作与时机](https://style.pixulse.com/docs/style-yaml/action.md): 规则命中后做什么（注入、提示、阻止）、在调用前还是调用后执行、多久重复一次，以及处理器出错时是否放行。 - [when：条件匹配](https://style.pixulse.com/docs/style-yaml/when.md): 给规则加上运行时条件：只在特定模型、思考强度、harness、代理，或事件内容满足条件时才生效。 - [fallback：落点不可用时的处理](https://style.pixulse.com/docs/style-yaml/fallback.md): 规则想用的事件或输出能力在某个 harness 上不受支持时，`fallback` 决定是换一种方式安装、跳过这条规则，还是拒绝安装整个包。 ## 原生 hook 不经过规则引擎、直接注册到 harness 的原生 hook 声明。 - [native_hooks：原生 hook](https://style.pixulse.com/docs/style-yaml/native-hooks.md): 把一条 shell 命令直接注册为 harness 的原生 hook，例如编辑文件后自动运行格式化脚本。 ## 命令与诊断 style 命令行的全部命令、参数和退出码，以及校验和安装时会报的诊断码。 - [命令行：style 使用指南](https://style.pixulse.com/docs/style-yaml/cli.md): `style` 命令行的全部命令、参数、确认提示、输出格式和退出码。编写、安装、排查一个 STYLE 包时查这一页。 - [diagnostics：诊断码总表](https://style.pixulse.com/docs/style-yaml/diagnostics.md): 汇总 `style validate`、`style plan`、安装流程和其他命令报告的诊断码，并指向详细说明它们的页面。