Home / gzx2211 / dsh-visual-workflow · GitHub

AGENTS.md@src/host/agentA

AGENTS.md@src/host/agent from gzx2211/dsh-visual-workflow is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned

mdr add gzx2211/dsh-visual-workflow/src/host/agent/AGENTS.md@git:20260928.0bc633c

Pins git:20260928.0bc633c in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: AGENTS.md file
Repository: gzx2211/dsh-visual-workflow
Path: src/host/agent/AGENTS.md
Versions recorded: 5
Latest version: git:20260928.0bc633c, committed Sep 28, 2026
First version recorded: Sep 22, 2026
Size: 2,440 bytes
Repository stars: 65
License: MIT

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

# Agent Module Rules

## 范围与职责

适用于 `src/host/agent/`。

治理「一个角色节点 ⇄ 一个可延续子代理」这一执行单元，并承担父代理会话能力的宿主适配：

- 把节点配置确定性翻译为官方子代理运行时的创建参数；
- 创建/复用节点子代理，并把本轮任务块投递进去；
- 在该子代理作用域内注入 Agent 语义；
- 为编排层与工具层提供父代理会话宿主能力。

判断归属：该修改是否改变「节点 → 子代理」的创建/复用/投递/作用域装配语义，或改变本模块对官方 Agent 能力的适配契约？若主要属于其他领域，应放到对应模块。

## 依赖边界

- 官方能力仅经 `ctx.get()` / 注入缝**运行时解析**，并以本模块自带的最小结构守卫收窄；允许 `import type` 官方纯类型（如 `Context`），不得有官方运行时 import；
- orchestrator 仅允许**类型**导入其公共入口（`NodeRunner` / `AgentHost` / `NodeStartInput` 等契约缝）；本模块不得成为 orchestrator 的运行时依赖；

## 生命周期

执行单元生命周期：创建 → 复用派发 → 进行中（不等待）→ 结束/失败/中断 → 清理（宿主统一）。

必须保证：
- **复用由配置签名决定**：签名必须覆盖一切影响子代理组成的输入。
- 创建/复用路径**不得等待子代理完成**；完成事实只经官方事件观察，由编排层回写。
- 中断是**尽力而为**：目标不存在或已停止视为成功；调用方不得依赖中断同步生效。
- **重建子代理时，旧子代理的处置语义必须明确**（保留/中断/归属回收），并在注释中说明其事件对节点结论的影响；不得让旧子代理的事件静默影响新子代理。

## 验证补充

- 涉及官方适配、宿主装配或产物契约时追加构建验证；
- 复用签名组成与作用域装配（安装/撤销）有测试锁定；
- 面向模型文本与工具白名单未意外改变。

## 核心原则

1. 节点配置确定性映射为官方子代理调用。
2. 复用由签名决定，签名必须完整。
3. 作用域装配的生命周期归宿主，模块不私建撤销表。
4. 创建即推理、不等待完成，完成只经事件观察。
5. 每子代理状态必须有释放条件与上界。
6. 面向模型的文本、工具白名单与官方消息 payload 是对外契约。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add gzx2211/dsh-visual-workflow/src/host/agent/AGENTS.md@sha256:e92e4d6c8f163523

The line at the top of this page pins the label git:20260928.0bc633c, 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.

Badge

[![mdr](https://markdownregistry.com/badge/art_hwn5a7dcmdrvwnon.svg)](https://markdownregistry.com/a/art_hwn5a7dcmdrvwnon)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Sep 22, 2026 and Sep 28, 2026, about one every 2 days.

version	committed	commit	size	audit
git:20260928.0bc633c latest	2026-09-28	0bc633c	2,440 B	A	view · diff
git:20260926.ad6eabb	2026-09-26	ad6eabb	2,997 B	A	view · diff
git:20260923.4575b13	2026-09-23	4575b13	3,225 B	A	view · diff
git:20260922.cf8e5a9	2026-09-22	cf8e5a9	11,176 B	A	view · diff
git:20260922.6d7169a	2026-09-22	6d7169a	11,179 B	A	view

Audit of the latest version

A 14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Size between 200 bytes and 200 KB (2440 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

GitHub

gzx2211/dsh-visual-workflow · 65 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hwn5a7dcmdrvwnon
GET https://markdownregistry.com/api/v1/resolve?ref=gzx2211/dsh-visual-workflow/src/host/agent/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/e92e4d6c8f163523de6d766c3dada6dc08427ac7306d7095101f6e7123406b7a

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.