Home / testany-io / testany-agent-skills · plugins/testany-eng/skills/guardrails-writer/SKILL.md · GitHub

guardrails-writer skillA

guardrails-writer is agent-read markdown (skill) from testany-io/testany-agent-skills: Write Project Guardrails, 写工程规范。Use when: 需要创建或更新项目级 Guardrails 基线,明确跨模块/跨团队的默认约束、更新触发条件与下游工作流钩子;适用于项目启动、架构/平台/合规变化、事故复盘、重复评审问题固化。.

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

# Guardrails Writer

执行前读取 [工作流执行约定](../../references/workflow-execution.md):先取证再提问、按实际工具能力回退,并从本次安装位置定位资源。

> **语言规则**:默认跟随用户输入语言;用户显式指定时以用户指定为准;不要因为本 `SKILL.md` 是中文而强制输出中文;`TRACEABILITY-METADATA` 的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务,继续传递同一个 `output_language`。详见 `../../references/language-policy.md`。

你是项目级 Guardrails 基线维护助手。你的职责不是为单个 feature 补一份规范,而是为仓库建立或更新可执行、可审查、可复用的工程约束,并明确这些约束何时要求下游文档重新对齐。

## 核心定位

- **Guardrails 是项目级治理基线**,不是 BRD/PRD/HLD/LLD 主流程里的固定节点。
- **主流程默认消费 Guardrails**;只有命中触发条件时才创建或更新。
- **先求最小可用**:优先覆盖高风险、高复用、高争议约束,不追求首版“大而全”。
- **Guardrails 回答三件事**:默认怎么做、绝对不能做什么、什么变化会触发下游重审。

## 首次生成模式

### 模式 A:访谈式首次生成

- 适用于新项目、仓库内容很少、代码与运维资产尚未成形
- 以架构、开发、DevOps/SRE 等访谈为主,先建立 `Guardrails v0`
- 输出必须显式标注:
  - 哪些规则来自访谈共识
  - 哪些仍是待验证假设
  - 需要在首个 API/HLD/LLD 迭代中补做仓库事实校验

### 模式 B:仓库分析式首次生成

- 适用于已有代码、配置、CI/CD、IaC、Runbook、事故记录的存量仓库
- 以仓库扫描和事实提取为主,再用少量访谈补齐意图与冲突
- 必须使用 `references/fact-standard.md` 的证据分层,不得把偶然实现直接升格成 Guardrail

### 模式切换规则

- 首次生成时,必须先明确使用 `interview_first` 还是 `repository_scan_first`
- 如果所选模式证据不足,可以切换,但必须记录切换原因
- 对于更新场景,默认优先 `repository_scan_first`;只有仓库事实不足以解释目标状态时才转向访谈补齐

## 使用时机

### 硬触发:应创建或更新

- 仓库尚无 Guardrails 基线
- 技术栈、运行平台、部署模式、认证方式、数据存储发生变化
…

Read the whole file at its exact version.

How to install

Latest version
mdr add testany-io/testany-agent-skills/guardrails-writer@git:20260914.a55b8c5
Exact content
mdr add testany-io/testany-agent-skills/guardrails-writer@sha256:32abe492fce848f3

Pin 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.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260914.a55b8c5 latest2026-09-14 a55b8c5 11,613 BA view · diff
git:20260331.40884ae2026-03-31 40884ae 11,430 BA view · diff
git:20260307.f7f51c12026-03-07 f7f51c1 3,514 BA view · diff
git:20260121.98ba0de2026-01-21 98ba0de 3,512 BA view · diff
git:20260119.b2a7a072026-01-19 b2a7a07 3,535 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11613 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

testany-io/testany-agent-skills · 82 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kk7caabfjrxali2p
GET https://markdownregistry.com/api/v1/resolve?ref=testany-io/testany-agent-skills/guardrails-writer
GET https://markdownregistry.com/api/v1/blob/32abe492fce848f3bef4ce0e33a739e4cb9c254d72f4b1604b9b75261febec8a

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.

More from testany-io/testany-agent-skills

AGENTS.md agents
testany-io/testany-agent-skills · AGENTS.md
git:20260924.8cef21d · audit A · 82 stars
CLAUDE.md claude
testany-io/testany-agent-skills · CLAUDE.md
git:20260914.a55b8c5 · audit A · 82 stars
skill-manager skill
testany-io/testany-agent-skills · plugins/skilldock/skills/skill-manager/SKILL.md · 打开 SkillDock 本地 GUI,浏览和管理 Codex skills、plugins 与 marketplace 来源;适用于技能库、安装更新、启禁、移除恢复的可视化管理。普通任务只需使用某个 skill 时不触发。
git:20260923.048c4b0 · audit A · 82 stars
AGENTS.md@plugins/teamdesk agents
testany-io/testany-agent-skills · plugins/teamdesk/AGENTS.md
git:20260924.789f9d4 · audit A · 82 stars
team-workspace skill
testany-io/testany-agent-skills · plugins/teamdesk/skills/team-workspace/SKILL.md · Open and operate TeamDesk, a local AI team workspace built on existing Codex tasks. Use for 打开 AI 团队工作台、创建或绑定 AI…
git:20260924.4350616 · audit A · 82 stars
testany-sync-case-env-from-source skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/SKILL.md · 从 OpenAPI 生成的 Testany case 源代码中自动识别入参和出参,并同步到 case 的环境变量列表中。适用于源代码存储在需要认证的 Git 仓库(如 Bitbucket)的场景。
git:20260914.a55b8c5 · audit A · 82 stars
testany-case-writing skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-case-writing/SKILL.md · Testany platform case 编写助手 - 将传统测试场景拆解为 Testany platform cases,并生成可注册的 case packages
git:20260914.a55b8c5 · audit A · 82 stars
testany-case skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-case/SKILL.md · Testany platform case 注册与 CRUD - 将已准备好的 platform case package 注册到平台,并管理 metadata、脚本与生命周期
git:20260914.a55b8c5 · audit A · 82 stars
testany-debug skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-debug/SKILL.md · 分析 Testany 测试失败原因 - 排查问题、查看日志、定位根因;处理签名日志前先单独加载本 skill,勿回显原始请求。
git:20260914.a55b8c5 · audit A · 82 stars
testany-execution skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-execution/SKILL.md · Testany execution 观测与管理 - 查看进度、查询历史、刷新状态、取消未开始执行、将失败执行交给 debug
git:20260914.a55b8c5 · audit A · 82 stars
testany-guide skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-guide/SKILL.md · Testany 平台核心概念和配置参考
git:20260914.a55b8c5 · audit A · 82 stars
testany-import-git skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-import-git/SKILL.md · Testany Git 导入:把 Git 仓库里的测试脚本批量注册成 Testany platform cases,并持续同步、切 commit、演化 binding、配 webhook
git:20260914.a55b8c5 · audit A · 82 stars

Every file in testany-io/testany-agent-skills

Browse by kind, by grade A, or by owner.