martin1847/evolab / skills/agent-backend-standard
agent-backend-standard
Verified后端架构与工程规范。适用于构建或评审 agent/LLM 后端、任何涉及数据库(DB)的后端,以及建立或评审后端仓库工程门禁。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.5 KB |
| references/agent-foundations.md | markdown | 2.3 KB |
| references/caching-discipline.md | markdown | 3.9 KB |
| references/code-dependency-lifecycle.md | markdown | 9.5 KB |
| references/data-write-discipline.md | markdown | 9.9 KB |
| references/engineering-interface.md | markdown | 10.9 KB |
| references/evals.md | markdown | 2.6 KB |
| references/governance.md | markdown | 2.7 KB |
| references/hitl-resume-safety.md | markdown | 2.7 KB |
| references/observability-cost.md | markdown | 1.2 KB |
| references/prompt-context.md | markdown | 1.6 KB |
| references/resilience.md | markdown | 3.9 KB |
| references/safety-bounded-execution.md | markdown | 4.5 KB |
| references/secrets-discipline.md | markdown | 2.5 KB |
| references/selfcheck-gates.md | markdown | 4.4 KB |
| references/state-durability.md | markdown | 2.6 KB |
| references/tool-design.md | markdown | 2.8 KB |
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 注入),否则软层空转**。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |