AGENT SKILL
principle-type-system-discipline
设计类型、审查函数签名或在任意静态类型语言中写代码时应用。使非法状态无法表示,标记语义原始类型,在边界解析外部数据,穷尽变体,从权威 schema 派生。
- License 许可
- MIT
- 最近更新
- 2026-10-21
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- principle-type-system-discipline
- description
- 设计类型、审查函数签名或在任意静态类型语言中写代码时应用。使非法状态无法表示,标记语义原始类型,在边界解析外部数据,穷尽变体,从权威 schema 派生。
- disable-model-invocation
- true
03 SKILL.md 正文
类型系统纪律
让编译器拒绝不可能的状态、对不上的原始类型,以及没处理的变体。优先把错误和特例定义成不存在,而不是不断加处理分支。TypeScript 的具体写法见 typescript-best-practices skill。
- 给语义不同的原始类型各自的类型。
UserId和OrderId底下都是字符串,但不该能互换。各自给一个类型,比如 TypeScript 里的 branded intersection,或者其他语言里的 newtype。创建时校验一次,之后信任这个类型。如果两个参数是同一种原始类型、意思却不同,就给它们各自的类型。 - 外部数据在解析之前没有类型。 RPC 载荷、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行。每个边界都要有一个解析函数,把没有结构的输入变成带类型的模型。校验放在哪,看 boundary-discipline 原则 skill。
- 类型从权威的 schema 派生。 protocol buffer、OpenAPI spec、GraphQL schema、数据库 migration、design-token 文件,或其他文件已经拥有这个形状时,从它派生,不要手写一份平行的类型。见 encode-lessons-in-structure 原则 skill。
04 同仓库更多 Skills
why
用于「为什么 X 是这样实现的」「为什么选了 Y」、设计理由、回归、事后复盘,或数据支撑的阈值问题。发现可用 MCP 并并行查询各证据类别(源码控制、工单跟踪、长文文档、实时聊天、基础设施可观测性、错误跟踪、产品分析数仓),然后返回带引用的决策与权衡解读。运行时行为请用 how。
★ 3
unslop
从任意写作中剔除 AI 痕迹。
★ 3
typescript-best-practices
TypeScript 最佳实践。读取或编辑任意 .ts 或 .tsx 文件时使用。
★ 3
technical-writing
分层技术写作标准:Diátaxis 结构、Google 开发者风格句子、STE 指令规则、Global English 句法。用于 /technical-writing,或撰写/审查文档、RFC、README、PR 描述、commit message 时。
★ 3
teach
用平实语言解释一段工作,让人真正理解。运行 how 与 why skill,把发现织成一份清晰说明。用于「teach me this」「help me really understand X」「explain this change or subsystem to me」。
★ 3
tdd
仅当用户明确要求 TDD、失败测试或回归测试时使用,或 bug 有明显且廉价的本地测试目标时使用。测试路径不清、昂贵、偏集成或未要求时跳过。
★ 3