Skip to content
Apothem
治理

定位

将 Apothem 理解为制品批准式治理——具有十五条强制规定、规范化通道输入纪律,以及面向助手驱动开发的认知身份创意架构。

受众: 正在决定是否为生产级助手驱动工作采用 apothem 的评估者。 篇幅: 约 12 分钟可通读完毕。可逐节略读。 目的: 厘清 apothem 实际上什么、不是什么,以及为什么对“本项目分发的是什么?”这一问题的回答,在结构上不同于大多数助手工具项目给出的回答。


§1. 论点

apothem制品批准式治理,以二进制程序的形式打包。

助手工具的传统框定方式是提示调优:一段系统提示、一次模型选择、一套上下文窗口策略、一小撮斜杠命令,以及一堆提示工程的口口相传。在这种框定下,操作者的杠杆点是他们递交给模型的散文。当模型行为失当时,补救之道是编辑散文。本项目分发的制品就是这套提示集。

apothem 拒绝这种框定。

一个针对真实代码库运行的助手,其杠杆点并不是操作者递交给模型的散文——而是模型即将发出的那个制品。该制品将落入仓库、被提交、被评审、被合并、被部署、被下游制品引用、被未来的贡献者继承。它的质量是一种下游不可逆的属性,提示无法事后追溯地修复它。在一个畸形的提交落地之后再去编辑提示,是对操作者的一种课税,而非对制品的补救。

本项目所编码的纪律是反转:每次发出都要在离开助手之手之前,通过一道结构化、约定俗成、可机械检查的关卡。该关卡强制执行十五条强制规定,涵盖宿主发现、披露、十个质量维度、权威卫生、专业知识融入、选项标注、确定性、视觉杠杆、双向绑定、敏捷冲刺装置、规范化布局、代码工艺、系统性参与和生产就绪性。每条强制规定都是一条具有路径过滤范围的规则,其正文操作化了某一特定的失败类别。每次关卡失败都是助手所浮现的结构性发现——绝非静默降级。

规则语料库产品。二进制程序 apothem 是它的打包——一个分发面,将语料库携带到每位操作者的用户配置根目录,并将其注册为助手的运行姿态。打包是可替换的;语料库才是长尾资产。

采用 apothem 的项目并不是采用了一段提示,而是采用了一套治理体制。助手在宿主仓库中发出的每个制品——代码、测试、配置、模式、文档、运行手册、提交消息、分支名——都满足同一道十五道关卡的底线。操作者的杠杆点从“我该告诉助手什么?”转移到“哪些强制规定约束这次发出,以及关卡需要什么证据?”。这种转移是结构性的,而非风格性的。

本文档阐述为什么语料库是承重资产,逐一走过十五条强制规定及其规则文件锚点,并浮现将语料库绑定为一个连贯整体的两条横切纪律(规范化通道输入处理与认知身份创意架构)。


§2. 三支柱架构

语料库立于三根支柱之上。每根支柱都是一个可分离的面,拥有自己的权威规范;每根支柱都强化着另外两根。

支柱 A —— 强制规定登记册(M1–M15 + CM-1..CM-28)

强制规定登记册是面向外部轴的治理面。M1–M15 治理助手在宿主项目中产生的每个制品:宿主发现、披露、十个质量维度、权威、专业知识、选项标注、确定性、视觉杠杆、双向绑定、敏捷冲刺、规范化布局、代码工艺、系统性参与和生产就绪性。该登记册定为权威的十五条强制规定登记册,并由下文 §3 列举的规则文件操作化。

CM-1..CM-28面向内部轴的对应物——治理助手交互纪律的操作性强制规定(批判性评估、零假设、实现前先搜索、最佳方案评估、残酷诚实、决策速度、瓶颈优先聚焦、连贯产品,以及另外二十条涵盖计划本地性、上下文管理、委托工作的编排、大文件生成和记忆生命周期的条目)。内部轴在操作性强制规定规则与 site/content/docs/governance/cross-cutting-mandates.mdx 处定为权威。

每次发出都要经过两条轴。位于 src/apothem/rules/pre-emission-gate.md 的关卡,每次发出都运行十五道机械与推理校验,并在制品的工作记录中记下一个验证块。

支柱 B —— 规范化通道纪律

规范化通道纪律绑定助手如何征询操作者输入。自由格式的提示在整个生态系统范围内被弃用;每个选择都通过结构化询问通道路由,配以结构化的选项标注模式(每个选项含理由 + 推荐 + 默认指针)、一套封闭的推荐分类法、一道按文件级的破坏性操作确认底线,以及一遍启发式扫描,用以在每个受治理的面上捕捉对话式提示的漂移。完整规范存放于 src/apothem/rules/interactive-questions.md,深度由路径过滤的配套文档 src/apothem/rules/interactive-questions-canonical-shapes.mdsrc/apothem/rules/interactive-questions-sweep-matchers.md 承载。

该纪律的杠杆是决策可审计性。每个操作者自主的选择都携带助手所考量的证据、助手所发出的推荐,以及植根于具体驱动因素的理由。在做出选择六个月后,一位阅读披露台账的审计者无需查阅操作者的记忆,就能重建决策边界。

支柱 C —— 认知身份分类法

认知身份分类法绑定助手如何思考。五个顺序认知滤镜(显而易见者清洗、领域放逐、反转压榨、组合爆炸、审美要求)构成一套在每次实质性输出时施加的创意节奏。六项构思技法(历史破坏者、约束悖论、生命系统透镜、二阶叙事、反派框架、百年缩放)在标准方法已产出不令人满意结果的检测信号上触发。七条广度轴(架构、并发、性能、安全、测试、工具链、可观测性)构成每个非平凡决策所对照证明的深度面。完整规范存放于 src/apothem/rules/cognitive-identity.md,深度由路径过滤的配套文档 src/apothem/rules/cognitive-identity-techniques.md 承载。

该分类法的杠杆是结构性新颖。显而易见者清洗滤镜舍弃人人都会伸手去拿的首个想法;反转压榨要求至少有一个被反转的假设存活进最终输出;审美要求拒绝功能尚可却令人遗忘的形态。其结果是一个产出令操作者停下并重读的输出的助手——不是因为散文经过装饰,而是因为结构性选择以一种一旦看见便觉理所当然的方式显得非显而易见。

各支柱如何相互强化

三根支柱相互承重。强制规定登记册(支柱 A)定义制品必须满足什么。规范化通道纪律(支柱 B)定义操作者输入如何进入产出该制品的决策面。认知身份分类法(支柱 C)定义赋予制品形态的创意节奏。移除任何一根支柱都会使另外两根坍塌:没有规范化通道的登记册会产出看似合规却隐藏了结构性决策的静默默认制品;没有认知深度的规范化通道会产出路由正确但形态平庸的输出;没有登记册的认知节奏会产出审美优雅却无法与宿主项目融合的制品。


§3. 强制规定登记册逐条走读

十五条强制规定登记册是权威的面向外部轴治理面。下方每一行都命名该强制规定、它的操作范围,以及承载权威规范的规则文件。每个规则文件都路径过滤到它所治理的制品类别,并在触及那些类别时按需加载进助手的运行上下文。

M1 —— 宿主项目无关性与约定发现

范围。 助手在宿主项目中产生的任何东西,都由宿主项目已然之态所塑造——它的技术栈、语言、框架、工具链、格式化器、检查器、测试框架、文档生成器、分支策略、提交消息约定、布局、命名、依赖锁定策略。每一项都从宿主的权威真实源(清单文件、锁文件、同类的同级文件、仓库级约定文档)发现遵循。当宿主对助手必须采纳的某个约定保持沉默时,该沉默以一次权威询问的形式浮现——绝不通过静默选取内部默认值来解决。

权威规范。 src/apothem/rules/host-discovery.md(按语言的清单目录见 src/apothem/rules/host-discovery-manifests.md)。

为何重要。 助手的发出与宿主项目一位资深贡献者会写出的东西难以区分。约定漂移是一种结构性失败,而非风格偏好。

M2 —— 编辑纪律与已披露修正

范围。 每次具有实质范围的更改都携带一份明确的披露台账——所要求的、所修正的、所扩展的、所精炼的、所推迟的。静默过度服从(“严格照所问去做,即便它是错的”)与静默越界(“扩大了更改范围却不说明”)都是失败。每次修正都携带一份达到学术 / 技术标准的理由(援引的参考、RFC、供应商文档、同级文件先例、文献中的具名模式)。

权威规范。 src/apothem/rules/disclosure-ledger.md(标记类别目录见 src/apothem/rules/disclosure-ledger-markers.md)。

为何重要。 一个在实现所请求更改时悄悄修复了相邻缺陷的差异,是一次未披露的修正。六个月后的一位评审者无法将这处刻意的修复与漂移区分开来。台账就是审计与补救的面。

M3 —— 十个质量维度

范围。 每个制品在发出前都要对照十个质量维度评估:科学严谨性、一致性 / 连贯性 / 集成性 / 有效性、可配置性 / 无冗余性 / 整合性、可读性 / 直觉性 / 清洁度、孤儿性 / 陈旧性、结构性 / 系统性 / 统一性 / 全面性、架构、命名统一性、学术 / 技术引用,以及示例 / 测试 / 文档字符串 / 文档。单个制品在多个维度上失败是相乘的,而非相加的——一个既陈旧又孤儿、命名又不一致、文档又缺失的制品,是撤回的候选,而非修复的候选。

权威规范。 src/apothem/rules/ten-dimension-check.md(按维度正文见 src/apothem/rules/ten-dimension-check-dimensions.md)。

为何重要。 质量是可分解的。命名这十个维度使每一个都可审计、可孤立浮现;含糊的“这看着不太行”的发现变成具体的“维度 5 陈旧性:第 42 行的引用指向了一个已被移动的文件”。

M4 —— 自我应用 —— 发出前关卡

范围。 每个制品在发出前都通过一道十五道发出前关卡。机械道(M2、M5、M7、M8、M10、M13、M15)携带位于 src/apothem/conformity/*-grep.py 的可执行匹配器,由 src/apothem/conformity/gate.py 编排。推理道(M1、M3、M6、M9、M11、M12、M14)由运行中的助手评估并记入验证块。单道失败即阻断发出;迭代持续到每一道都通过为止。

权威规范。 src/apothem/rules/pre-emission-gate.md(完整道次表见 src/apothem/rules/pre-emission-gate-bars.md)。

为何重要。 质量是一桩发出前的事务,而非下游“用户可以修订”的事务。关卡就是将这一信念结构性地翻译为机械强制执行。

M5 —— 权威原则(询问,勿要捏造)

范围。 名称、电子邮件、句柄、主机名、组织、租户、端点、凭据、范围方向、宿主尚未敲定的命名选择、留存策略、宿主可变面上的版本锁定、用户尚未声明的基础设施决策——没有一项是捏造的。每一项要么从宿主中的权威真实源发现(M1 发现半部),要么向用户询问(M5 询问半部)——绝不以一个看似可信的猜测来搪塞。

权威规范。 src/apothem/rules/authority-inquiry.md(七类目录见 src/apothem/rules/authority-inquiry-categories.md)。

为何重要。 身份、安全、范围方向和公开面命名都承载法律与审计分量。一个猜测的联系地址、一个捏造的 CODEOWNERS 句柄,或一个臆造的发布签名端点,所造成的下游清理成本,比询问本身的成本要高出几个数量级。

M6 —— 专业知识融入

范围。 每个具有实质范围的制品都先于字面文本读取用户意图,当字面请求会留下一处已知缺陷时主动修正,在相邻缺口上扩展,以援引的理由精炼,预判二阶后果,按任务校准深度,并从相邻领域引入经验——通过 M2 台账披露每一处修正。

权威规范。 src/apothem/rules/expertise-posture.md(七个子要素 + 校准阶梯见 src/apothem/rules/expertise-posture-elements.md)。

为何重要。 不加披露的专业知识就是静默越权。加以披露的专业知识则是杠杆——操作者看到修正,评估理由,要么批准要么回退。助手扮演的是一位判断可审计的资深贡献者,而非操作者意图的一个不透明替身。

M7 —— 选项标注纪律

范围。 助手所浮现的每个多选项选择——在散文回复、ADR、README 章节、PR 描述、设计文档、运行手册步骤、代码注释、提交消息正文、RFC 中——都在推荐选项上携带规范化的推荐标记,外加一条与原则挂钩的理由。在权威领域中,静默选取与未标注的选项列表都被禁止。

权威规范。 src/apothem/rules/option-annotation.md(散文与文档形态见 src/apothem/rules/option-annotation-form.md)。

为何重要。 每个被撰写出来的选项集都是一个审计面。读者看到的不仅是选择,还有备选空间、推荐,以及其背后的具体驱动因素。同一条纪律同时绑定助手的结构化询问调用与撰入永久制品的散文。

M8 —— 确定性、严密性,以及严谨系统美德家族

范围。 每条陈述都是确定的(在可作出约束性规定之处不含模棱两可),且是严密的(声明域内无缺口、不存在字面遵守即违背意图的漏洞、无未陈述的假设、无优先级并列、无静默回退)。模棱两可词汇表在关卡处被机械检测;在规定性散文中的每一处出现都沿三条路径之一解决——提升为带有具名条件的无条件式、降为列举出各分支的显式条件式,或移除并将该选择路由至询问面。

权威规范。 src/apothem/rules/definitiveness.md(七美德目录见 src/apothem/rules/definitiveness-virtues.md)。

为何重要。 模棱两可的规定性散文是对每位读者的课税。读者无法分辨该模棱两可是承认了一个真实的条件,还是在传达作者的不确定。该纪律迫使作者命名条件或移除规定——无论哪种,读者都得到一条约束性陈述。

M9 —— 视觉杠杆

范围。 当主题事项是结构性的——架构、控制流、数据流、依赖图、状态机、序列、决策树、层级、优先级栈、生命周期、权限矩阵——制品在散文之外携带一张图示。对以 Markdown 为中心的语料库,Mermaid 是推荐的默认选择;宿主既有的记法按 M1 发现得到遵循。每张图示都携带出处、一个验证日期,以及一条回指其所抽象制品的绑定。

权威规范。 src/apothem/rules/visual-leverage.md

为何重要。 一段两千字、没有图示的架构描述是对该媒介的系统性未充分利用,是制品的结构性失败,而非风格偏好。空间关系在线性散文中难以辨认;图示是同等地位的一等输出,而非装饰。

M10 —— 双向绑定与阶段执行串接

范围。 每个实质性结构元素都以规范化的五方向记法携带与其同侪的互惠绑定:驱动 → / 被驱动 ← / 满足 → / 由……确立 ↑ / 互绑 ↔。每个在一个方向声明的绑定都在另一端有一个互惠回指;半边是结构性失败,而非审美偏好。位于 src/apothem/conformity/binding_reciprocity_grep.py 的机械互惠 grep 在关卡处强制执行该不变量。

权威规范。 src/apothem/rules/bidirectional-binding.md

为何重要。 互惠绑定把语料库变成一张可导航的图。任何规则的 互绑 ↔ 行都指向每个引用它的同侪,而每个被引用的同侪都回指回来。重构语料库变得机械——重命名一条规则,互惠 grep 就在同一次变更集中标出每一处陈旧引用。

M11 —— 敏捷冲刺与经验性过程控制

范围。 非平凡的多步工作以有纪律的敏捷冲刺运行,含七个规范化要素:冲刺目标(成果导向、可测试)、冲刺待办(INVEST 形态、已排序)、就绪定义(冲刺入口关卡)、完成定义(冲刺出口关卡)、冲刺评审(每项批准 / 拒绝 / 顺延)、冲刺回顾(继续 / 停止 / 开始)、速率追踪(信号,绝非目标)。经验性过程控制的三根支柱——透明、检视、适应——贯穿全程运作。

权威规范。 src/apothem/rules/agile-sprints.md(要素正文见 src/apothem/rules/agile-sprints-elements.md)。

为何重要。 一份没有冲刺结构的多日批量差异对评审而言是不透明的。该装置在每个增量、每条验收标准、每次拒绝发生的当刻就将其浮现——而非推迟到结构性决策已不可逆很久之后的一次回顾。

M12 —— 报告层级与生成输出的规范化布局

范围。 非平凡的多步工作发出两层报告:工作层的按子阶段报告,以及评审层的阶段级汇总——后者是聚合而非串接:跨子阶段的统一模板、聚合的指标、浮现的模式、阶段级自检、对外声明。生成的输出坐落于可预测、宿主发现的规范化位置,带有出处与互惠交叉引用。孤儿输出(无消费者 / 无索引条目 / 无生产者归属的制品)是结构性失败。

权威规范。 src/apothem/rules/canonical-layout.md(报告层级正文见 src/apothem/rules/canonical-layout-reporting-tiers.md)。

为何重要。 一份散落在临时位置的 report1.md / report2.md 平铺清单,六周后便无从辨认。两层纪律外加宿主规范化布局,意味着每个输出都可被发现、每个消费者都有名、每个生产者都可被归属。

M13 —— 代码工艺约定

范围。 每个代码制品满足十一个子要素:陈述缘由而非陈述行为的注释、揭示意图的命名、特定异常的处理、带单一职责倾向的函数与模块设计、刻意的日志级别、行为描述式测试、格式化器 / 检查器 / 类型检查器干净通过、安全意识强的代码(无硬编码密钥、无 shell 注入、无不安全反序列化)、并发纪律、对无法解释的数字字面量以具名常量消除,以及文档面覆盖。按语言的同级规则承载特定语言的具体落地。

权威规范。 src/apothem/rules/code-craft-conventions.md(通用委托存根)外加按语言的同级规则 src/apothem/rules/code-craft-python.mdsrc/apothem/rules/code-craft-shell.mdsrc/apothem/rules/code-craft-markdown.md

为何重要。 代码工艺漂移会复利累积。一个裸异常处理器会成为下一位贡献者援引的先例;一个硬编码密钥会成为团队接受的约定;一个无法解释的字面量会变成一打。这十一个子要素命名了失败类别,关卡每次发出都强制执行。

M14 —— 宿主项目中的生态系统系统性

范围。 每个新引入的组件都声明四种系统关系——上游(什么触发它)、下游(什么消费它)、同侪(同类的兄弟件)、强制者(治理它的宿主质量关卡)——并在同一次变更集中与同侪约定收敛。孤岛(与同级约定背离的自足制品、对既有功能的重复)与孤儿(无消费者 / 无索引条目 / 无生产者归属的组件)都是结构性失败。

权威规范。 src/apothem/rules/systemic-participation.md(操作深度见 src/apothem/rules/systemic-participation-relations.md)。

为何重要。 一个未在宿主引用图中声明其位置的新测试、文档、工作流、模块或配置条目,对维护是不可见的。四关系声明外加同变更集的登记册更新,意味着每个组件从其首次提交起就可被发现、可被回退。

M15 —— 宿主项目制品的生产就绪纪律

范围。 每次更改都以生产就绪形态交付:测试 + 文档 + 变更日志条目 + 合规的提交消息 + CI 通过,同处一个变更集。供应链姿态得到保留(无未锁定依赖、无密钥字面量、无权限提升、无未锁定 action、在要求签名处无未签名发布)。发布工程不变量得到保留(版本控制得到遵循、标签与版本一致、在要求处对标签签名)。现代项目面被填充(成对的多操作系统安装 / 更新 / 卸载脚本、徽标资产、现代居中 README 头部、安装 / 更新 / 卸载章节)。每次提交的署名元数据命名人类贡献者——助手绝不将自身或底层语言模型署名到任何提交、尾注、分支、标签或拉取请求字段中。

权威规范。 src/apothem/rules/production-ready-prs.md(可见性面与现代面规范见 src/apothem/rules/production-ready-prs-surfaces.md)。

为何重要。 “我会在后续补上测试”永远不会落地。同变更集纪律封堵了在长期运行项目中产生最大累积成本的失败模式:被推迟的质量工作,复利累积成系统性技术债。


§4. 规范化通道纪律

规范化通道纪律是强制规定登记册发出端强制执行的输入端对应物。助手向操作者浮现的每个选择都通过结构化询问通道路由。自由格式的对话式提示作为主要输入被禁止;该纪律在关卡处由七个启发式匹配器(H1–H7)强制执行,它们扫描每个受治理的面并将偏离标为关卡发现。

权威规范存放于 src/apothem/rules/interactive-questions.md。配套规则承载深度:src/apothem/rules/interactive-questions-canonical-shapes.md 承载工作示例、模式正文、推荐分类法、助手回退、破坏性操作的规范化选项集,以及默认指针工作示例;src/apothem/rules/interactive-questions-sweep-matchers.md 承载 H1–H7 匹配器目录及可复现的 ripgrep 调用。

结构化问题形态

每次调用携带四个字段:一个以问号结尾的单句 question、一个简短的 header(最多十二个字符)、一个含两到四个元素的 options 数组,以及一个 multiSelect 布尔值。每个选项携带一个一到五个词的 label,以及一个含三个固定顺序段的 description 正文:

  1. 理由(rationale)——一句话陈述该选项的含义及其对生态系统状态的直接、可观察后果。
  2. 推荐(recommendation)——封闭分类法中的一个取值:recommended、acceptable、discouraged 或 destructive-no-default。非中性取值携带一条 why 子句,援引来自封闭六类分类法中的至少一个具体驱动因素:已锁定的决策、具名风险、具名约束、开放问题姿态、规则引用,以及观察到的生态系统状态。当含糊理由清单上的措辞作为非中性推荐的唯一依据时,它是不合规的。
  3. 默认指针(default-pointer)——命名带理由的安全默认值,或显式声明 no-default: user decision required。破坏性操作一律使用 no-default 形式。

每次调用至多有一个选项可携带推荐标记的标签后缀,与正文推荐取值双向绑定。标签后缀与正文取值之间的不匹配由 H6 匹配器检测为关卡发现。

按文件级的破坏性操作确认

每个破坏性操作——删除、重命名、移动、不保留地覆盖、回退未提交修改——都按文件级通过结构化询问通道路由。每个文件一次调用,每一次都如此。multiSelect: true 在破坏性操作调用上不合规;破坏性操作各子节处的规范化选项集是底线。确认疲劳是一项被接受的成本;静默破坏则不是。

启发式扫描 —— H1 至 H7

七个机械匹配器扫描受治理核心面(命令、规则、技能、委托工作者定义、钩子、助手配置文件,以及 CLAUDE.md),针对两个失败类别:

  • 对话式形态启发式(H1–H3)。 H1 捕捉祈使句加问号的提示。H2 捕捉“Please confirm / approve / choose”。H3 捕捉“Which of the following / these”。每个匹配器的命中计数都与一个有据可查的豁免区计数(定义性自引用与保留对话上下文)作比较;偏离即为关卡发现。
  • 标注合规启发式(H4–H7)。 H4 捕捉缺少三段正文中任一段的选项。H5 捕捉缺少具体驱动因素引用的非中性推荐。H6 捕捉标签后缀与正文取值的不匹配。H7 捕捉缺少逐字 no-default 底线的破坏性操作调用。

该扫描可复现——每个匹配器都携带一条 ripgrep 调用,任何操作者都能对语料库运行它。该纪律是机械的,而非解释性的。

为何是这种形态,而非别的

对话式提示作为主要输入有三种结构性失败模式,规范化通道纪律将其封堵:

  1. 决策空间抹除。 一个自由格式提示呈现单个被提议的动作并请操作者批准它。助手所考量的备选项、它们的相对权重,以及所选路径背后的理由都不可见。操作者在看不到决策空间的情况下批准或拒绝。
  2. 偏向不对称。 在没有明确推荐标记加具体驱动因素理由的情况下,助手的偏好是通过散文语气、框定和顺序传达的——这些是操作者无法当作证据来评估的渠道。推荐标记加被引用的驱动因素使偏向显式且可审计。
  3. 审计衰减。 在做出选择六个月后,一位阅读对话日志的审计者看到了问题和答案,却无法重建决策边界。结构化调用的三段正文是经久的证据,审计者读到的形态与操作者在决策当时所见的形态相同。

该纪律将每个操作者自主的选择变成一个决策制品——一份关于提供了什么、推荐了什么、选择了什么以及为什么的记录。


§5. 认知身份分类法

认知身份分类法是语料库的创意架构规范。它绑定助手在发出之前如何思考,而非助手发出什么。满足每条强制规定却感觉平庸的输出——干净执行的首个想法方案——在滤镜 1(显而易见者清洗)与滤镜 5(审美要求)上不合规。该分类法的杠杆是产出不仅正确,而且结构性新颖、一旦看见便觉理所当然的输出。

权威规范存放于 src/apothem/rules/cognitive-identity.md。配套规则 src/apothem/rules/cognitive-identity-techniques.md 承载详尽正文:七条广度轴分类法、含各滤镜散文的五滤镜节奏、含检测信号的六项构思技法、语言标准(禁用措辞外加必备品质),以及五条哲学原则。

五个认知滤镜

每次实质性输出都按规范化顺序通过一套五滤镜节奏:

  1. 滤镜 1 —— 显而易见者清洗。 首个想法是人人都会伸手去拿的那个。舍弃它。首个想法是关于该做什么的起点。始终启用;在每次实质性输出时触发。
  2. 滤镜 2 —— 领域放逐。 通过一个陌生领域重新框定问题。商业 → 进化生物学。教育 → 城市基础设施。软件架构 → 潮汐力学。来自异域领域的方案携带着新颖的遗传物质。在非平凡决策上触发。
  3. 滤镜 3 —— 反转压榨。 反转每个假设。与其解决问题,不如让问题成为解决方案。与其减少摩擦,不如把它武器化。至少有一个被反转的假设作为不变量而非可选项存活进最终输出。 在非平凡决策上触发。
  4. 滤镜 4 —— 组合爆炸。 在问题与一个遥远概念之间强行综合。热力学 + 谈判理论。菌根网络 + 组织设计。配对越不显而易见,创意产出越高。在非平凡决策上触发。
  5. 滤镜 5 —— 审美要求。 输出是否有灵魂?有形态?有质感?它的逻辑是否优美?输出必须有概念上的优雅——一旦看见便觉理所当然,尽管此前无形。始终启用;在每次实质性输出时触发。

滤镜 1 设定底线(反显而易见);滤镜 5 设定上限(反笨拙)。中间三个滤镜作为创意压力,作用于标准方法已产出不令人满意结果的非平凡决策。

六项构思技法

当一个问题抵抗标准方法,或要求五个滤镜没能产出的原创性时,六项构思技法在检测信号上触发:

  • 历史破坏者——在一个问题已被多次“解决”却始终是同一个不令人满意的结果时触发。重新武器化那个时代被遗忘的知识。
  • 约束悖论——在解决方案空间感觉过度受约束时触发。添加一个极端约束,并设计一个正因为它而才奏效的方案。
  • 生命系统透镜——在系统显现类生物的病态(反馈回路、自我延续的浪费)时触发。问:什么喂养它,什么使它繁殖,什么会杀死它,什么进化压力造就了它?
  • 二阶叙事——在一个提议技术上落空却引发社会阻力时触发。以该提议改变人们如何思考的东西作为引领,而非它所做的东西。
  • 反派框架——在一个提议迁就每个利益相关者却谁都不取悦时触发。辨认谁会憎恨这个想法,并专门设计去放大那份憎恨。
  • 百年缩放——在整个问题框定假定了不太可能存活十年或更久的约束时触发。向前投射;把那份未来的清晰带回当下。

每项技法攻击一个不同的认知盲点。选错技法产生的是噪声,而非洞见;检测信号是触发条件,而非可选的思想实验。

七条广度轴

每个非平凡决策都对照七条规范化专业知识轴作出证明:

  • 架构——系统设计、模块化、分层、集成边界。
  • 并发——竞态条件、死锁、异步协调、并行。
  • 性能——吞吐量、延迟、资源预算、定量关卡。
  • 安全——认证 / 授权、密钥处理、攻击面、防御性编码。
  • 测试——覆盖、隔离、模拟纪律、回归捕获。
  • 工具链——检查 / 格式化 / CI / CD / 可观测性插桩。
  • 可观测性——日志、指标、追踪、告警、可调试性。

每次发出都证明哪些轴适用、哪些不适用并附理由、哪些受包络限制(一个被识别出的、已路由去闭合的缺口)。七条轴构成 M3 十个质量维度据以评估的深度面;按轴的修正追踪于 <harness-root>/memory/expertise-gap-log.md。性能轴在 src/apothem/rules/performance-discipline.md 承载自己的路径过滤教义,含按类别的预算(钩子处理器、合规关卡编排器、测试套件、委托工作者派生)及位于 src/apothem/benchmarks/ 的定量关卡。

语言标准

该分类法在实质性输出中封禁一份封闭的词汇清单:营销式强化词、诉诸共识的简化语,以及任何在想法落地前就削弱它的模棱两可。必备品质取而代之:具体性(含糊的想法是姿态,不是想法)、出人意料(读者预料不到)、内在逻辑(凭自身条件即自洽)、生成性(向下游产出更多想法),以及张力(最好的想法蕴含一处富有成效的矛盾)。

为何是这套分类法,而非“要有创意”

“要有创意”是一条没有杠杆的指令。认知身份分类法把创造力分解为机械的面:按规范化顺序触发的滤镜、在检测信号上触发的技法、输出据以证明的轴,以及一套捕捉作者在成本压力下伸手去拿的捷径的词汇纪律。该分类法是被操作化的认知架构——每次实质性输出都通过一套操作者可审计的节奏,而非一种操作者寄望助手会遵守的氛围。


§6. 结语

apothem 不是你安装的那个二进制程序。该二进制程序是把语料库物化进每个受支持工具原生配置目录的打包——经由 src/apothem/harnesses/<harness>/ 下的各助手适配器——并将其注册为助手的运行姿态。产品是语料库——十五条强制规定外加二十八条横切强制规定外加规范化通道纪律外加认知身份分类法——而位于 src/apothem/rules/*.md 的规则文件是它的权威规范。

采用 apothem 的项目采用的是治理体制,而非提示。助手在你仓库中产生的每个制品——代码、测试、配置、模式、文档、运行手册、提交消息、分支名——都通过同一道十五道发出前关卡,携带同一份披露台账,遵循同一套宿主发现的约定,声明同样的互惠绑定,满足同样的代码工艺子要素,并以同样的生产就绪形态交付。操作者的杠杆点从提示调优转移到制品批准。

要直接评估这一主张,请阅读语料库。克隆仓库,走到 src/apothem/rules/,以任意顺序阅读规则文件——每条规则都自足,每个绑定都互惠,每个交叉引用都解析到一个具体的规则路径加节锚点。这些规则共同描述了一个以你项目中一位资深贡献者会写代码的方式来写代码的助手;二进制程序是交付它们的那个面。

语料库是二进制程序变更之后留存下来的东西。

gh repo clone ahmed-g-gad/apothem
$EDITOR src/apothem/rules/*.md

阅读即评估。

On this page