wyx 架构护栏（中文版）

wyx 架构护栏（中文版）

把模块边界写成规格，放在实现代码旁边，让 agent 在动手写代码之前就看见「什么可以碰、什么不可以碰」，并能定期核对规格是否已经和代码脱节。

这套方法只有两个动作：声明边界（写规格）和核对边界（查漂移）。规格是加法——覆盖的模块越多，护栏越密；从一个模块开始就有价值。

五种模式

从用户的说法判断模式，然后读取对应的参考文件再动手。参考文件是完整的执行程序，不要凭记忆执行。

模式名沿用上游 wyx 的命令名，便于与上游文档、ARCHITECTURE.md 里的提示互相对照；本技能里它们是模式，不是必须带斜杠的命令。用户说「wyx 审计」和用上游那条带斜杠的 audit 命令是一回事。

没有任何规格、也没指定模块时：先走 wyx:audit，让用户看到从哪里开始收益最大，而不是直接挑一个模块写规格。

三类规格与它们的分工

• CONCEPT.md —— 一个模块「是什么」：单一目的、自己拥有的状态、对外的动作、以及 ## interactions / ## dependencies 两段边界声明。
• PIPELINE.md —— 数据「怎么流」：来源、阶段、输出、运行时可断言的质量不变量，以及 ## data boundary 声明谁拥有输入输出数据。
• SYNCS.md —— 概念之间「怎么协同」：触发时机、数据流向、跳过条件、错误传播策略。CONCEPT.md 的 ## interactions 声明关系，SYNCS.md 描述执行机制。

三者的关系是：概念定义边界，管道在边界内保证数据质量，sync 负责跨概念的编排；架构地图是它们的合成视图，不参与护栏，只给人看。

规格放在哪里

规格必须紧贴它描述的实现代码。边界注入 hook 从被编辑文件所在目录向上走，在第一个含 CONCEPT.md 或 PIPELINE.md 的目录停下；SYNCS.md 会被列出但不终止向上查找。

src/lib/
├── orders/              # 一个概念 = 一个目录
│   ├── CONCEPT.md       # 本模块的边界声明
│   ├── service.ts