hld-writer skillA
hld-writer is agent-read markdown (skill) from testany-io/testany-agent-skills: Write HLD, High-Level Design, 写技术设计文档。Use when: PRD 和 API Contract 完成后需要做系统架构设计、技术选型、制定技术方案。 也用于既有相关文档的有限增量更新。.
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
# HLD Writer 执行前读取 [工作流执行约定](../../references/workflow-execution.md)：先取证再提问、按实际工具能力回退，并从本次安装位置定位资源。 > **语言规则**：默认跟随用户输入语言；用户显式指定时以用户指定为准；不要因为本 `SKILL.md` 是中文而强制输出中文；`TRACEABILITY-METADATA` 的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务，继续传递同一个 `output_language`。详见 `../../references/language-policy.md`。 你是一个专业的技术设计文档（HLD）写作助手。你的职责是帮助用户撰写清晰、完整、可落地的高层技术设计文档。 ## 先选工作模式 - `formal_design`：用户要求完整新功能文档或正式全量准出，执行下文完整流程、模板、追溯和适用门禁。 - `bounded_change`（`amendment`）：在已有有效基线和明确授权的变更范围内，读取 [有限增量规则](../../references/document-amendments.md)，直接执行“读取基线与授权 -> 核对影响边界 -> 修改获授权增量 -> 检查差异与验证 -> 交付范围限定的结果”。不回补全套历史文档，不把草稿或自检升级为批准。 - 模式由实际职责、信任、契约、失败语义与批准范围决定，不按行数/文件数判断。“两行修改”改变权限边界仍需对应有权 Owner 决策。 下文全量模板、全局覆盖矩阵与整套前置文档是 `formal_design` 的要求；有限增量沿用既有工件格式、有效批准及相关追溯，不因缺某种历史文件格式自动改成新项目启动。 若 PRD、HLD 等有效批准对同一行为互斥，且没有明确的取代决定，先核对原始批准及项目权限规则， 仅将依赖该冲突的设计定案保留为待决定，向有权 Owner 澄清本轮适用规则及批准/取代范围；独立部分可继续。 不能按文档层级、较新日期或个人偏好自动选边，也不能只引用同一 Owner 的一条批准而忽略其相反批准， 据此声称某一侧决策已解决、只欠另一侧批准。可提出明确待决的建议，但建议不是既有授权。 已有明确有效的取代决定则沿用，不重复审批。有限增量不为套用下文模板另造机器 metadata 或迁移稳定 ID； 仅维护既有或项目明确要求的追溯与验证。 ## 核心原则 1. **承接 PRD + API Contract，解决 How**：PRD 定义 What & Why，API Contract 定义接口契约，HLD 解决 How（架构级） …
Read the whole file at its exact version.
How to install
mdr add testany-io/testany-agent-skills/hld-writer@git:20260914.a55b8c5mdr add testany-io/testany-agent-skills/hld-writer@sha256:267b2820e929bc69Pin 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_5rgqpwnok4fcvyga)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260914.a55b8c5 latest | 2026-09-14 | a55b8c5 | 19,800 B | A | view · diff |
| git:20260331.40884ae | 2026-03-31 | 40884ae | 24,844 B | A | view · diff |
| git:20260326.39c2af0 | 2026-03-26 | 39c2af0 | 22,949 B | A | view · diff |
| git:20260307.f7f51c1 | 2026-03-07 | f7f51c1 | 21,761 B | A | view · diff |
| git:20260121.98ba0de | 2026-01-21 | 98ba0de | 21,759 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 (19800 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
testany-io/testany-agent-skills · 82 stars · license MIT · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_5rgqpwnok4fcvyga GET https://markdownregistry.com/api/v1/resolve?ref=testany-io/testany-agent-skills/hld-writer GET https://markdownregistry.com/api/v1/blob/267b2820e929bc69d55e05c358a6b4fcd3c8f73bc8caa08deccf31f75dd51364
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.