AGENT SKILL
principle-encode-lessons-in-structure
当你发现自己第二次写同一条指令,或注意到 recurring correction 时适用。把规则编码为 lint、metadata 标志、运行时检查或脚本,而不是更多文字。
- License 许可
- MIT
- 最近更新
- 2026-10-21
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- principle-encode-lessons-in-structure
- description
- 当你发现自己第二次写同一条指令,或注意到 recurring correction 时适用。把规则编码为 lint、metadata 标志、运行时检查或脚本,而不是更多文字。
- disable-model-invocation
- true
03 SKILL.md 正文
在结构中编码教训
若教训需要判断、没法编码进机制,就让指令更醒目,并加上失败模式的示例。
推论: 若修复是结构性的,只用结构性修复。指令只是症状。
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