architecture-decision-record 项目解析：适应度函数（Fitness Function）如何把架构决策变成可自动验证的代码

发布时间：2026/10/12 3:02:10 · 信平特种工考证网

【免费下载链接】architecture-decision-recordArchitecture decision record (ADR) examples for software planning, IT leadership, and template documentation项目地址https://gitcode.com/gh_mirrors/ar/architecture-decision-record点击查看免费下载架构决策记录Architecture Decision RecordADR解决了把决策写下来的问题但写下来的决策如何确保团队真的在遵守本篇文章以 architecture-decision-record 仓库中的《Fitnessfunktioner for beslutninger som kode》决策即代码的适应度函数文档为核心讲解 fitness function 的核心概念、与 ADR 的分工、四大实战价值、基于 AI 大语言模型的检查提示词以及 ArchUnit / ArchUnitTS 等架构单元测试工具。读完你就能在自己的项目中把每一条架构决策固化成随每次提交与构建自动运行的客观检查。什么是决策即代码的适应度函数原文档给出一个精炼的定义适应度函数fitness function是用编程代码编写的一种客观、自动化的检查用于验证一项决策是否仍然被遵守。这个定义有三个关键限定词客观objektiv检查结果只有通过 / 失败两种状态不依赖评审者的主观印象自动化automatiseret检查以代码形式存在可以挂接到持续集成CI流水线中无需人工触发针对决策for beslutninger它验证的不是代码风格或单元行为而是我们当初做出的架构决策是否仍然成立。原文档同时指出两条直接收益适应度函数让决策变得可测试、可保证testbare og kontrollerbare并且对**质量保证kvalitetssikring、合规流程regulatoriske processer和治理目标governance-mål**有显著帮助。在 architecture-decision-record 仓库中这篇文章是英文源文档 fitness-functions-for-decisions-as-code 的丹麦语翻译丹麦语版本同时被收录进仓库根 README.md 的 Fitness functions for decisions as code 章节见 README.md并作为 12 篇核心文档之一在 spec/content.md 中被明文列出。如果你想阅读同主题的中文版本仓库还提供了《将决策作为代码的适应度函数》等 30 种语言的译文方便对照学习。适应度函数与 ADR 的分工文档记录决策代码执行决策原文档用一个非常简洁的公式定义了二者关系决策记录ADR负责记录决策适应度函数负责**执行håndhæver**决策。文档中的成对示例如下决策示例为满足审计要求我们采用事件溯源event sourcing适应度函数示例我们使用持续集成服务器来测试所有状态变更都必须产生事件。也就是说ADR 回答我们决定怎么做、为什么这么做而 fitness function 回答系统是否仍然按这个决定在运行。二者的角色差异可以归纳为下表维度决策记录ADR适应度函数Fitness Function形态人读的 Markdown 文档机器执行的程序代码作用记录决策及其背景、后果验证决策是否仍被遵守时效决策时刻的一次性产物可追加修订随每次 commit / build 持续运行的活规则判定靠人工评审与理解通过 / 失败的客观结果典型落点adr/或decisions/目录单元测试、CI 脚本、架构测试仓库中为记录决策这一半提供了大量模板例如 Michael Nygard 模板Title / Status / Context / Decision / Consequences 五段式以及 MADR 项目模板强调备选方案及利弊而执行决策这一半正是本篇文档的主题。仓库的 writing-guide.md 也把Fitness functions — making a decision testable, not just documented让决策可测试而不只是被记录单列为一节与本文档内容相互印证。为什么适应度函数有助于决策落地原文档给出四个核心理由逐一展开如下1. 客观度量工作结果清晰可见适应度函数要么通过、要么失败不存在模糊地带。相比代码评审时口头提醒大家遵守某某约定一条自动化检查给出的是确定的布尔结果任何人都能一眼看到当前系统是否满足决策要求团队工作状态变得透明。2. 持续使用随每次提交与构建运行的活规则适应度函数不是一次性审计而是常驻的规则——每次 commit、每次 build 都会执行。这意味着决策的遵守不是靠记忆或自觉而是靠流水线强制。这与本仓库自身的工程实践是同一思路仓库通过 scripts/audit-locales.py 把每个语言目录必须与英文源 en-001 完全对齐205 个文件、README.md 必须是 index.md 的软链接、所有相对链接与锚点必须可解析这一内容治理规则写成了可自动执行的检查并在 .github/workflows/ci.yml 中配置为每次 push 和 pull request 都运行。从源码结构看这正是一个针对内容同步决策的 fitness function 实例。3. 重构的信心自动捕获违反决策规则的错误重构时最怕结构变了但没人意识到某条决策被悄悄破坏。适应度函数会在重构代码的构建阶段自动发现此类偏差并让流水线失败把事后发现变成提交时发现为持续演进提供安全网。4. 可扩展的治理不制造瓶颈地保证标准人工审批会随着规则数量增长而成为瓶颈自动化检查则可以无限扩展——每条决策对应一条检查规则越多流水线越严格却不需要增加任何人力评审环节。这让治理从人的流程转变为代码的流程。用 AI 大语言模型充当适应度函数完整提示词原文档明确回答了适应度函数可以使用 AI 吗——可以。思路是让 AI 大语言模型针对我们的工作成果计划、代码、模式、API 等提出检查性问题从而充当一条广义的适应度函数。文档给出了可直接复用的完整提示词模板IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning. IMPORTANT: Turn on extended thinking. Turn on expert advice. Turn on search. This is a fitness function to evaluate if our work is using all our decisions, and is correct and accurate. - Our decisions are here: {url} - Our work to evaluate is here: {url} Explain any errors, problems, gaps, weaknesses. Be direct. Be decisive.这份提示词可以从四个层面理解方便你按需调整推理模式指令前两行要求模型优先基于检索的推理而非基于预训练记忆的推理并开启扩展思考extended thinking、专家建议expert advice和搜索search能力——本质上是要求模型把决策文档和工作产物当作证据来源而不是凭训练语料里的泛化知识作答角色声明第三至五行明确这是一条评估我们工作是否使用了全部决策、是否正确且准确的 fitness function输入占位{url}需要替换为两处真实地址——决策存放处如 ADR 目录或文档链接与被评估的工作产物如 PR 变更、设计文档、API 契约输出要求最后一行要求模型直接、果断地指出错误、问题、缺口与弱点避免含糊其辞。同一份提示词也原样收录在 writing-guide.md 中说明它是仓库推荐的、经过项目团队验证的通用形态可以直接粘贴使用或在此基础上扩展。架构单元测试ArchUnit 与 ArchUnitTS当决策本身是代码的架构形态时例如分层依赖、包边界、禁止某类循环引用最自然的实现方式是把 fitness function 写成架构单元测试。原文档推荐了两个工具ArchUnitJava使用任何普通的 Java 单元测试框架如 JUnit来检查 Java 代码的架构规则。它把分层不得反向依赖领域层不得引用基础设施层这类规则写成可断言的测试随测试套件一起在 CI 中执行。下面是一段通用示意非本仓库代码具体 API 以工具当前版本为准// 示意用 ArchUnit 在 JUnit 中声明一条架构规则 AnalyzeClasses(packages com.example.app) public class ArchitectureRulesTest { Test void domain_should_not_depend_on_infrastructure() { noClasses().that().resideInAPackage(..domain..) .should().dependOnClassesThat().resideInAPackage(..infrastructure..) .check(new ClassFileImporter().importPackages(com.example.app)); } }ArchUnitTSTypeScript / JavaScript使用 Jest、Vitest、Jasmine 等测试框架检查 TypeScript 与 JavaScript 代码的架构规则为前端与 Node.js 项目提供同样的能力。它同样把架构约束表达为测试用例例如某个目录下的模块不得 import 另一个目录的模块失败即让测试套件报错。把这两类工具与前述 AI 提示词放在一起看可以梳理出一条完整的决策即代码落地路径能用确定性代码表达的架构决策 → 写成 ArchUnit / ArchUnitTS 之类的架构单元测试难以用代码表达的开放性决策如计划、文档、API 设计是否与全部决策一致→ 用 AI 提示词充当柔性检查。两者都挂进 CI就构成了既有硬约束又有软校验的双层保证。在本仓库中的落地路径与相关资源如果你希望基于本仓库进一步实践决策即代码可以从这几处切入阅读原文英文源文档 fitness-functions-for-decisions-as-code 与中文译本《将决策作为代码的适应度函数》内容完全对应适合对照研读查看集成位置根 README.md 的 Fitness functions for decisions as code 章节README.md把该主题与决策记录模板决策生命周期架构图与视图等内容并列帮助你理解它在整套 ADR 方法论中的位置结合相邻机制紧跟在 fitness functions 章节之后README 还介绍了Decision guardrails for pull requests见 README.md即 ADR Guard 之类的工具在 pull request 阶段自动拦截改动了受保护代码却未新增或更新 ADR的情况并支持显式的ADR-Exempt:豁免行——这是决策执行在代码评审环节的另一种自动化形态与本文主题形成互补复用 AI 检查提示词skills 目录下的 writing-guide.md 收录了同样的 fitness function 提示词说明该项目已把这一实践固化到面向 AI 编码代理的写作指南中可作为团队内部约定直接采用参考示例与模板仓库示例目录中有 40 个 ADR 实例如环境变量配置、事件溯源相关的时间戳格式等模板目录提供 11 种决策记录模板可用来补齐记录决策这一半。需要提醒的是本文所述 fitness function 属于通用软件工程实践不同工具ArchUnit、ArchUnitTS的 API 与版本差异较大在关键系统中使用前请自行核验工具文档与项目实际情况这也是仓库 README 中明确给出的注意事项。总结一句话概括本文档的核心主张ADR 负责把决策写下来fitness function 负责让决策被执行。通过客观度量、随构建持续运行、为重构提供信心、以代码实现可扩展治理这四个价值点适应度函数把架构决策从纸面文档变成了可测试、可保证的工程资产。对于无法用确定性代码表达的开放性决策还可以借助 AI 大语言模型提示词充当柔性检查——原文档提供的完整提示词模板可以直接投入实战。结合 ArchUnit / ArchUnitTS 等架构单元测试工具你就能在 CI 中建立硬规则软校验的双层决策保障体系。赞分享【免费下载链接】architecture-decision-recordArchitecture decision record (ADR) examples for software planning, IT leadership, and template documentation项目地址https://gitcode.com/gh_mirrors/ar/architecture-decision-record点击查看免费下载相关推荐HCCL 集合通信算法全解Server 内 / Server 间 / 超节点间算法选型、HCCL_ALGO 配置与分级通信原理HCCL 集合通信算法全解Server 内 / Server 间 / 超节点间算法选型、HCCL_ALGO 配置与分级通信原理集合通信算法是决定集群通信性能电视盒子变 Linux 服务器Armbian 移植实操指南电视盒子变 Linux 服务器Armbian 移植实操指南 amlogic s9xxx armbian 是一个开源项目可以把 Armbian基于 Debi从架构决策到代码实现architecture-decision-record的完整落地流程从架构决策到代码实现architecture decision record的完整落地流程架构决策记录Architecture Decision Reco上一篇【亲测免费】 rCore-Tutorial-v3 开源项目指南下一篇MoA项目快速入门指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

拿不准这条消息跟你有没有关系？

工种不同、批次不同，要求可能差很多。打电话把你的情况说清楚，我们按信阳、平顶山本地的口径给你捋一遍。

拨 18236992212 在线预约咨询

接着看

这些消息，可能你也用得上

附近有办电工证内部消息：河南薪资曝光，过期待复附近有办电工证内部消息：河南薪资曝光，过期待复手里证书过期三个月了，心里是不是特别慌？想问问附近哪里有办电工证的，结果发现光找报名点不够，还得搞清楚复审延期到底卡在哪。最近从内部消息… 2026/10/12 2:57:24

编译原理复习提纲：从词法分析到代码优化的流水线地图如果让我用一个词概括编译原理这门课，我选“流水线”。2025年春季学期这门课结课后，我花了一周把全学期的笔记、作业、往年卷重新过了一遍，整理出这份核心提纲。初衷很简单：给复习备考的同学一份能直接照着用的地图，而… 2026/10/12 2:57:10

STM32型号识别与CubeMX工程化实践指南 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … 2026/10/12 2:55:09

旧 Mac 装新系统：OpenCore Legacy Patcher 免费实操指南旧 Mac 装新系统：OpenCore Legacy Patcher 免费实操指南【免费下载链接】OpenCore-Legacy-Patcher Experience macOS just like before 项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher 你的 Mac 早被官方划出了更新名单&#x… 2026/10/12 3:46:29

Home Assistant 前端 ha-tooltip 悬浮提示组件实战：用法、定位与主题令牌完全指南前端智能家居UI组件【免费下载链接】frontend :lollipop: Frontend for Home Assistant 项目地址： https://gitcode.com/gh_mirrors/frontend149/frontend 点击查看免费下载 ha-tooltip 是 Home Assistant 前端（本项目仓库 frontend）中基于… 2026/10/12 3:45:29

特种工刷身份证怎么刷？揭秘含金量背后的实操通关细节特种工刷身份证怎么刷？揭秘含金量背后的实操通关细节很多兄弟在实操考场前腿都软了，盯着那个刷卡机心里直打鼓，生怕因为身份证刷不过去直接挂科，这不仅是技术问题，更是关乎这张证含金量能不能落袋为安的大事。… 2026/10/12 3:44:30

萧山低压电工证怎么考？学历不高看这篇报名攻略与薪资真相萧山低压电工证怎么考？学历不高看这篇报名攻略与薪资真相学历只有初中，甚至只有小学文凭，想在萧山找份稳定又体面的工作，是不是心里发慌？很多人第一反应就是：我这点文化，低压电工证还能报上名吗？别急，先把心放肚子里。只要年满18周岁，身体健康，且没有妨碍从事特种作业的疾病，学历并不是绝对的拦路虎… 2026/10/12 3:38:30 $Java常用API陷阱：Math、System、Runtime、Object与深浅拷贝实战解析$ Java常用API陷阱：Math、System、Runtime、Object与深浅拷贝实战解析在Java基础类库里，Math、System、Runtime、Object、对象克隆、Objects 这几个名字，凡是写过两年代码的人应该都能报出来。可也恰恰是这类“入门就见过”的API，在代码评审和线上排障里反复出问题。我见过有人用Math.round做金额舍入&#xff0… 2026/10/12 3:37:25

web3.py Testing API 完全指南：用 timeTravel、mine、snapshot 与 revert 掌控测试链时间与状态 Web3区块链【免费下载链接】web3.py A python interface for interacting with the Ethereum blockchain and ecosystem. 项目地址： https://gitcode.com/gh_mirrors/we/web3.py 点击查看免费下载 web3.testing 是 web3.py 暴露的一组非标准 RPC 接口封装&#x… 2026/10/12 3:37:25

内部消息揭秘：考低压电工证有难度？郑州金水区水利人避坑指南内部消息揭秘：考低压电工证有难度？郑州金水区水利人避坑指南是不是每次看到朋友圈里有人晒电工证，心里痒痒的，想考一个备用，又怕被那些满大街发广告的中介坑得明明白白？这种“不知道去哪报名、怕交钱后没下文”的焦虑，我太懂了。在郑州金水区搞水利工程的，咱们干的是实打实的辛苦活，证书这东西，水太深，稍不留神… 2026/10/11 0:02:21

内部消息：涿州市电工证培训跨省转办全流程解析内部消息：涿州市电工证培训跨省转办全流程解析很多在外地干了几年电工的老伙计，最近都在问同一个问题：之前考的那个电工证，现在回涿州干活，还能不能用？或者说，需不需要重新在涿州市找个地方重新培训一遍？这确实是咱们一线从业者最头疼的事，毕竟谁也不想白交那几百上千的学费，更不想耽误接活儿的时间。今天我就结… 2026/10/11 0:07:27

3招看懂中级电工证能干嘛用，避开官方报名入口陷阱 3招看懂中级电工证能干嘛用，避开官方报名入口陷阱很多人怕考不过白交培训费，这种焦虑我太懂了。毕竟电工证是安监局（现应急管理局）发的硬通货，考不过不仅钱打水漂，还耽误找工作的时间。别慌，今天咱们不聊虚的，直接拆解【中级电工证能干嘛用】，顺便把官方报名入口… 2026/10/11 0:12:31

官方回应：怎么申领电工证电子证？异地转证全攻略官方回应：怎么申领电工证电子证？异地转证全攻略之前考的证在外省能不能转过来？这是无数在外打拼的电工兄弟最关心的事儿。别急，今天就把这事儿掰开了揉碎了讲清楚。很多师傅拿着纸质本，担心换个城市工地就废了。其实，国家安全生产考试网… 2026/10/12 0:00:11

箱面接地电工作业报名门槛低，考下来多少钱才合理箱面接地电工作业报名门槛低，考下来多少钱才合理学历不高，怕报不上名？别自己瞎琢磨，直接看这里。很多刚出校门的朋友，尤其是许昌这边刚毕业学工程的学弟学妹，手里攥着身份证，心里打鼓：我是不是得先拿个本科证才能考这个证？是不是得去报个几千块的培训班才能过？其实，关于箱面接地电工作业… 2026/10/12 0:04:21

建湖高压电工证外省能转吗？官方回应来了建湖高压电工证外省能转吗？官方回应来了之前在外省考的高压电工证，回到江苏建湖能直接用吗？能不能直接转过来？这是很多跨省流动电工最头疼的问题。别急，关于【建湖高压电工证】异地互认的疑惑，官方回应… 2026/10/12 0:10:03

看完这篇，接下来怎么办

考证这件事，其实没你想的那么复杂

这篇文章讲的是一个具体问题，但真轮到自己报名考试，还有不少细碎的事要提前理清。我们在信阳、平顶山两地做特种作业考证咨询多年，把大家问得最多的几步，给你捋顺。

先预审材料

身份证、学历证明、体检报告、白底照片，自己先备齐发我们看一眼。缺啥补啥，别等到报名当天才发现少东西，那批就赶不上了。

再安排辅导

理论刷题加实操要点，我们按当期考试范围给你划重点。上过班的师傅底子不差，缺的就是熟悉题型这一步。

考完盯证书

成绩出来多久能领证、证到手怎么查真假、三年后什么时候复审，我们都帮你记着，到点提醒。

本文涉及的报考条件、收费、批次均以河南省应急管理部门当期公示为准。具体到你个人的情况，打 18236992212 说清楚，我们给你一句准话。

本地师傅常问

信阳、平顶山这边的几句实在话

在信阳工地干活，低压电工证基本是进场标配，没有连报名面试都过不了
平顶山矿上电厂那边，高压电工和高处作业证需求稳，老师傅不愁找活
新手别上来就报难的，先从低压电工入手，考过再增项更顺

地区用工情况随项目变化，以当地企业实际为准。想按你情况挑个合适工种，打 18236992212。

这篇文章只解决一个具体问题。真要报名，流程、材料、考试是另一整套事。不清楚自己处在哪一步，打 18236992212，按你的进度给建议。

看完文章还有疑问，常见问题在"常见问答"里能找到；想直接聊，电话最省时间。文章信息仅供参考，报考条件、收费以官方当期公示为准。

不确定自己符不符合报考条件？电话里说下年龄、学历、工种意向，我们给你判断。

文章导读

看完这篇咋接着走

这篇文章讲的是一个具体问题，但真轮到自己报名考试，还有不少细碎的事要提前理清。我们在信阳、平顶山两地做特种作业考证咨询多年，把大家问得最多的几步给你捋顺。

先预审材料：身份证、学历证明、体检报告、白底照片，自己先备齐发我们看一眼，缺啥补啥。再安排辅导：理论刷题加实操要点，按当期考试范围划重点。考完盯证书：成绩出来多久能领证、证到手怎么查真假、三年后什么时候复审，我们都帮你记着。

本地师傅常问

信阳平顶山的实在话

在信阳工地干活，低压电工证基本是进场标配，没有连报名面试都过不了。平顶山矿上电厂那边，高压电工和高处作业证需求稳，老师傅不愁找活。新手别上来就报难的，先从低压电工入手，考过再增项更顺。

地区用工情况随项目变化，以当地企业实际为准。想按你情况挑个合适工种，打 18236992212。本文涉及的报考条件、收费、批次均以河南省应急管理部门当期公示为准。

延伸服务

看完文章接着办

这篇文章只解决一个具体问题。真要报名，流程、材料、考试是另一整套事。不清楚自己处在哪一步，打 18236992212，按你的进度给建议。

材料预审、考前辅导、排批考试、考完盯证，这一整套我们接着。常见问题在 faq.html 能找到，想直接聊电话最省时间。

文章信息仅供参考，报考条件、收费以官方当期公示为准。不确定自己符不符合报考条件，电话里说下年龄学历工种意向，我们给你判断。

文章导读

看完这篇咋接着走

这篇文章讲的是一个具体问题，但真轮到自己报名考试还有不少细碎的事要提前理清。我们在信阳平顶山两地做特种作业考证咨询多年，把大家问得最多的几步给你捋顺。先预审材料：身份证学历证明体检报告白底照片自己先备齐发我们看一眼缺啥补啥。再安排辅导：理论刷题加实操要点按当期考试范围划重点。考完盯证书：成绩出来多久能领证证到手怎么查真假三年后什么时候复审我们都帮你记着。

本地师傅常问补充

信阳平顶山的实在话

在信阳工地干活低压电工证基本是进场标配没有连报名面试都过不了。平顶山矿上电厂那边高压电工和高处作业证需求稳老师傅不愁找活。新手别上来就报难的先从低压电工入手考过再增项更顺。地区用工情况随项目变化以当地企业实际为准。想按你情况挑个合适工种打 18236992212。本文涉及的报考条件收费批次均以河南省应急管理部门当期公示为准。

延伸服务

看完文章接着办

这篇文章只解决一个具体问题。真要报名流程材料考试是另一整套事。不清楚自己处在哪一步打18236992212按你的进度给建议。材料预审考前辅导排批考试考完盯证这一整套我们接着。常见问题在faq.html能找到想直接聊电话最省时间。文章信息仅供参考报考条件收费以官方当期公示为准。不确定自己符不符合报考条件电话里说下年龄学历工种意向我们给你判断。

本地师傅常问再补

信阳平顶山的实在话

在信阳工地干活低压电工证基本是进场标配没有连报名面试都过不了。平顶山矿上电厂那边高压电工和高处作业证需求稳老师傅不愁找活。新手别上来就报难的先从低压电工入手考过再增项更顺。地区用工情况随项目变化以当地企业实际为准。想按你情况挑个合适工种打18236992212。本文涉及的报考条件收费批次均以河南省应急管理部门当期公示为准。

延伸服务再补