Skip to content

martin1847/evolab / skills/agent-backend-standard

agent-backend-standard

Verified

后端架构与工程规范。适用于构建或评审 agent/LLM 后端、任何涉及数据库(DB)的后端,以及建立或评审后端仓库工程门禁。

references/governance.md

View on GitHub
# III-12 — 规范治理(手册如何用、偏离、演化)

> hub `agent-backend-standard` 的一章。模仿 Google C++ Style Guide 的 "Exceptions to the Rules" 收尾。

## 1. 怎么用本手册
- SKILL.md 是 ToC,**按需读单章** references/,别全量加载(context 经济)。
- 章分三类:已写实(读即用)/ *TBD*(占位,无内容别假装有)/ 交叉引用(去独立 skill:`observability-standard`/`git-workflow-standard`/A2A 对外契约规范)。

## 2. 偏离 / 例外(escape hatch)
- 规则是默认不是铁律。**偏离 MUST 显式记录**:在该仓 `AGENTS.md` 或对应 ADR 写明"偏离哪条 + 为何 + 范围",别静默不守。
- 某仓有正当理由覆盖默认(如集成策略、记账写阈值)→ 走 per-repo 声明(参见 per-repo 模式)。

## 3. 双层 + canonical-home(贯穿全手册)
- **双层**:本手册是软层(write-time 预防);硬层(CI 门禁/ruleset/清扫 bot)归 你的 IaC 仓。软层不作不可逆动作唯一防线。
- **canonical-home**:一条规则一个家,别处 `见 X` 引用不复制。横切规则(secret 不进 repo、honest span)各有 canonical(observability / AGENTS.md redaction)。

## 4. 手册如何演化
- 新章 / 改章:走 本规范仓 治理(AGENTS.md)——动命名/结构/边界以 ADR + module 为权威。
- 新增 concern 先判粒度:**触发动词不同 → 独立 skill;同属"写·评审 agent 后端代码" → 本 hub 加章**。
- *TBD* 章在有真实落地素材(案例 / 来信 / 决策)后写实,不空写通用建议(零投机)。
- owner:本规范仓 维护方;跨仓硬层 follow-up 发对应 CTO(如 你的 IaC 仓)。

## 5. 规则如何到达 executor(交付 / triggering)—— 软层的命门
**规则写进手册 ≠ 被执行。** 两条常见断链:
- **触发域要够宽**:hub 名带 "agent" 不代表规则只适用 agent 后端。**通用后端规则**(连接/事务/数据访问)的 SKILL.md 描述 MUST 让写**任何**相关代码时都命中——把通用规则圈进窄触发词("agent/LLM 后端"),普通业务微服务就不加载、永远漏。
- **接上 executor**:若编排是"编排者派 subagent 吃 goal 文档写代码",**subagent 读不到编排者 session 的 skill**——规则再对也到不了写代码的手。落地二选一:① 派工 goal MUST 显式引用相关 skill 章节(canonical-home 指针、别复制正文);② 编排层 dispatch 相关后端 agent 时加 hook 自动注入本 hub(机制见 `cto-orchestration`)。**只把规则写进 skill、不接触达路径 = 软层空转。**

## 一句话
> 按需读、偏离要显式记、规则有 canonical-home、空章不空写;新 concern 按粒度规则判"独立 skill vs hub 加章";**规则要真到达 executor(触发域够宽 + goal 引用/hook 注入),否则软层空转**。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall