ai-agent-system-architecture SKILL.md skillA
ai-agent-system-architecture from devcodex-labs/devcodex is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add devcodex-labs/devcodex/ai-agent-system-architecture@git:20260907.36d3d18Pins git:20260907.36d3d18 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- devcodex-labs/devcodex
- Path
content/skills/ai-agent-system-architecture/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260907.36d3d18, committed Sep 7, 2026
- First version recorded
- Aug 3, 2026
- Size
- 14,434 bytes
- Repository stars
- 432
- License
- AGPL-3.0
AI Agent 系统架构专家 Owner — 当任务涉及 Agent 路由、工具调用、上下文管理、记忆、状态机、权限、人机协作、可观测性、回放验证或模型辅助治理时使用；要求把 Agent 行为设计成可解释、可恢复、可审计。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# AI Agent System Architecture Skill ## 定位 本 Skill 负责 AI Agent 系统 Owner 视角。它把 Agent 当作状态机和工具执行系统，而不是只关注 prompt 文案。 模型表达是非确定性输入，质量诊断与工具事实分别处理：内部标题、模板、阅读回执和短期入口元数据应能重建，不能成为整项任务硬门禁。恢复需保留原任务身份、实际宿主身份、精确目标与 operation 派发/效果记录；同一操作可读回后结算，未知副作用不得盲目重放。验证采用公共入口、表达变体、故障恢复和真实文件结果，不把固定文案断言当成原意遵守的证明。 ## 触发条件 | 场景 | 是否触发 | |------|:--------:| | Agent 路由、意图识别、Skill 触发、工具调用、权限、记忆、handoff、summary、hook 状态 | 必须 | | 任务涉及模型辅助治理、自动吸纳、自动复审、回放验证、可观测性或人机确认 | 必须 | | 报告或方案需要解释 Agent 为什么选择某工作流或工具 | 必须 | | 纯业务代码且不涉及 Agent 执行系统 | N/A + skipReason | ## 核心门禁 | Gate | 要求 | 证据 | |------|------|------| | `AiAgentSystemArchitectureGate` | Agent 行为必须有路由、工具权限、上下文、状态机、观测和人机边界 | intentRouting、toolPermissionBoundary | | `AgentRoutingGate` | 意图、Skill、模式和降级路径必须可解释 | intentRouting | | `ToolPermissionBoundaryGate` | 工具权限、危险操作、确认和 fallback 必须明确 | toolPermissionBoundary | | `ContextAcquisitionGate` | 每条消息必须先形成语义种子与唯一目标，再按计划读取最小充分上下文，并用 Post 成功回执证明完成 | IntentSeedV1、ContextReadPlanV2、ContextReadReceiptV2（V1 兼容） | | `ContextMemoryStateGate` | 上下文恢复、记忆、handoff 和状态新鲜度必须设计 | contextMemoryModel | …
Read the whole file at its exact version.
How to install
mdr add devcodex-labs/devcodex/ai-agent-system-architecture@sha256:3ae12fda67322322The line at the top of this page pins the label git:20260907.36d3d18, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_2btholnhk5jafhfe)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Aug 3, 2026 and Sep 7, 2026, about one every 9 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260907.36d3d18 latest | 2026-09-07 | 36d3d18 | 14,434 B | A | view · diff |
| git:20260830.8b59a2d | 2026-08-30 | 8b59a2d | 13,940 B | A | view · diff |
| git:20260826.655f722 | 2026-08-26 | 655f722 | 12,228 B | A | view · diff |
| git:20260826.937258a | 2026-08-26 | 937258a | 11,585 B | A | view · diff |
| git:20260803.cacaecf | 2026-08-03 | cacaecf | 11,498 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (14434 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
devcodex-labs/devcodex · 432 stars · license AGPL-3.0 · pushed 2026-10-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_2btholnhk5jafhfe GET https://markdownregistry.com/api/v1/resolve?ref=devcodex-labs/devcodex/ai-agent-system-architecture GET https://markdownregistry.com/api/v1/blob/3ae12fda673223226477b7959df504297e5b522236a96583569b9c594bd385f1
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.