AGENTS.md@vega agentsA
AGENTS.md@vega is agent-read markdown (agents) from openbkn-ai/bkn-foundry.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# VEGA Agent 协作规范 本文件适用于 `vega/` 子系统。开始工作前必须先读取仓库根目录的 `AGENTS.md`、相关 `rules/`，以及目标目录下更具体的 `AGENTS.md` 或 `CLAUDE.md`。规则冲突时，以更具体目录的规则为准。 ## 强制语言规范 - 与用户的沟通、计划、进度、分析、结论和交付说明必须使用中文。 - 日志文本遵循目标模块既有风格，同一调用链内不得混用语言；除非兼容性或既有约定要求，不得仅为翻译日志制造无关 diff。 - 用户明确要求其他语言，或外部制品规范强制使用其他语言时，可以例外，并在交付说明中注明原因。 ## 工作方式 1. 编写代码前，先用中文说明实现方法；需要实质性判断或范围选择时，等待用户批准。 2. Plan 模式默认给出验收清单和失败条件。 3. 需求中的歧义会实质影响范围、行为或风险时，先提出澄清问题；其余情况说明合理假设后继续。 4. Bug 修复应先增加或更新能够复现问题的回归测试，再完成修复直至测试通过；确实无法先写测试时必须说明原因。 5. 修改完成后，列出相关边界场景、已覆盖测试和仍存在的测试缺口。 6. 预计修改超过 3 个文件时，先说明拆分方案和文件范围，避免把无关重构混入同一变更。 7. 用户纠正工作方式后，应反思原因并把可长期复用的约束更新到相应 `AGENTS.md`，但仍须先提供 diff 供 review。 8. 回答历史工作或决策问题前，必须先查阅仓库记录、Issue、PR 或可用的记忆文件，不得仅凭印象回答。 9. 完成修改和验证后先向用户提供 diff；未经明确批准，不得 commit、push、创建或更新 PR，也不得写回 Issue/PR。 ## 工程原则 - 优先解决根因，避免叠加临时补丁。 - 遵循 VEGA 既有六边形架构：`interfaces` → `logics` → `driveradapters` / `drivenadapters`。 - 保持 diff 聚焦，不做与任务无关的格式化、重命名、文件移动或依赖升级。 - 新模式必须说明必要性；能复用既有实现、测试 helper 和错误处理模式时优先复用。 - Go 代码必须通过 `gofmt`；新增日志、错误处理和 tracing 行为应与所在包保持一致。 - 不得修改、覆盖或提交工作区中属于用户的无关改动。 ## 列表接口的权限过滤 挂在目录下的列表（构建任务、探查任务、语义理解任务，以及此后新增的同类接口）**一律按这一套写**，这是统一设计，不要另起炉灶。 ### 规则 **可见的目录集在 service 层解析出来，下推进查询；不要对取回的页做过滤。** ```go …
Read the whole file at its exact version.
How to install
mdr add openbkn-ai/bkn-foundry/vega/AGENTS.md@git:20260922.010fbb0mdr add openbkn-ai/bkn-foundry/vega/AGENTS.md@sha256:6eb8dbca8bfe1347Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_tvsvzs4vmgacy6vt)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260922.010fbb0 latest | 2026-09-22 | 010fbb0 | 10,204 B | A | view · diff |
| git:20260922.d898021 | 2026-09-22 | d898021 | 10,196 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (10204 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
openbkn-ai/bkn-foundry · 569 stars · license NOASSERTION · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_tvsvzs4vmgacy6vt GET https://markdownregistry.com/api/v1/resolve?ref=openbkn-ai/bkn-foundry/vega/AGENTS.md GET https://markdownregistry.com/api/v1/blob/6eb8dbca8bfe13471a574e667f69fdf658ab36b50e46c60109475561973d8112
Your agent 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.