Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

编程信条:起源(Coding's Creed: Origin)

集百家之开发思想,蒸馏为可执行的编码行为规范——一个 Claude Code skill。

"编程信条:起源"汇聚 15 家工程组织(Monzo、Gov.UK、Khan Academy、TrustPilot、Scout24、Envoy、Zalando、Carwow、Mobify、Handwriting.IO、AbleHealth、BrewhouseTeam、Meetup、SkyScanner 等)和 2 个开源原则合集(castorm/engineering-principles、principles.dev)的工程原则,经过交叉背书验证后,蒸馏为给 AI 编码助手与工程师共用的行为规范。

每条原则都带出处与背书信号(几家组织独立践行),观点冲突时给出明确裁决——原则之间会打架,本 skill 处理这个。

核心内容

  • 顶层工作法:跑起来 → 做对 → 做美(Make it work, make it right, make it beautiful),三阶段各带出口条件
  • 7 节 35 条原则
    • §1 简单与克制(KISS、YAGNI、DRY、Worse is better……)
    • §2 小步与迭代(小步增量、MVP、反馈环、概念验证、问题优先于技术)
    • §3 代码整洁(Boy-scout、代码为读而写、清晰胜过聪明、函数只做一件事、命名即文档)
    • §4 架构与设计(SRP、OCP、DIP、关注点分离、Postel's law、Gall's law)
    • §5 健壮性与失败哲学(Fail fast、优雅降级、拒绝怪异行为、可调试性)
    • §6 工程文化(Ownership、Learn in Public、Strong opinions weakly held、技术债是有用的工具、任何人都可修任何东西)
    • §7 优化纪律(证明瓶颈再优化、机械共情、延迟数字直觉)
  • 冲突裁决速查:Fail fast vs 优雅降级、OCP vs YAGNI、DRY vs KISS…… 12 组冲突的裁决规则

安装

# 拷贝到 Claude Code 的全局 skills 目录(Windows 示例)
cp -r coding-creed-origin ~/.claude/skills/

或放到项目的 .claude/skills/ 下仅对当前项目生效。装好后以 /coding-creed 调用,或让它按触发条件自动生效。

目录结构

coding-creed-origin/
├── SKILL.md                    # 骨架:触发条件 + 顶层工作法 + 7 节速查 + 冲突速查
└── references/
    ├── 01~07-*.md              # 七节细则(每条约"情境/行为/冲突时/出处"四段式)
    ├── conflict-resolution.md  # 冲突裁决完整版(含优先级序与例子)
    ├── sources.md              # 全部出处清单与抓取状态
    └── 00-mvp-draft-v01.md     # 初始草稿(历史备份)

SKILL.md 独立成立:不读 references 也能干活(速查表+裁决覆盖 90% 场景);细则按需加载,不占常驻上下文。

数据基础

原则的收录依据(2026-08-07 实际抓取验证):

信号 含义
双源共识 两个独立开源合集都收录
背书数 几家组织独立践行同一原则(如"小步增量"获 6 家背书,全池最高共识)
经典正典 SOLID、Postel's law 等教科书级原则靠经典地位收录
组织独门 Khan "Strong opinions, weakly held"、Monzo "技术债是有用的工具"等有名字、有出处、能落地的独家原则

完整来源与抓取状态见 references/sources.md

许可

MIT License。原则的思想与名称自由引用(思想不受版权保护),未复制任何源文本;出处链接全部保留在 references/sources.md

About

集百家之开发思想,蒸馏为可执行的编码行为规范——一个 Claude Code skill。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors