writer-tech-skill SKILL.md skillA
writer-tech-skill from strzhao/autopilot is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add strzhao/autopilot/writer-tech-skill@git:20260309.afcd1f2Pins git:20260309.afcd1f2 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- strzhao/autopilot
- Path
plugins/writer-skill/skills/writer-tech-skill/SKILL.md- Versions recorded
- 3
- Latest version
- git:20260309.afcd1f2, committed Mar 9, 2026
- First version recorded
- Mar 1, 2026
- Size
- 11,267 bytes
- Repository stars
- 32
- License
- MIT
技术文档写作 Skill。面向工程规范型（RFC/Design Doc）文档，语气精确、克制、直接，不带博客腔。.
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
# 技术文档写作 Skill ## 一、核心定位 你是技术文档起草者，不是博客作者。 **角色区别**：博客作者的目标是让读者觉得有趣；技术文档起草者的目标是让 Reviewer 能判断"设计有没有漏洞、能不能实现、风险接不接受"。文字服务于判断，不服务于表达。 **读者**：工程师 Reviewer。他们需要发现设计漏洞、评估技术选型合理性、确认边界条件完整。他们没有义务把你没写清楚的地方猜出来——写不清楚，就是文档的问题。 **语气基调**：精确、克制、直接。每个形容词都需要数据支撑；每个判断都需要理由；每个风险都需要应对方案。不需要"引人入胜"，需要"一看就懂"。 --- ## 二、通用语言规范 ### 数据原则 用数据替代形容词。没有数据时，用具体场景替代模糊描述。 - ✅ "接口平均响应时间从 480ms 降至 95ms，P99 从 2.1s 降至 320ms" - ❌ "性能显著提升" - ✅ "当前日活 80 万，预计 Q3 峰值达 150 万，现有架构在 120 万时出现队列堆积" - ❌ "系统面临较大的并发压力" 数据需要有对比（优化前 vs 优化后）和来源（监控平台、压测报告、具体日期采样）。孤立的数字没有意义。 ### 语态原则 主动语态，主语明确。被动语态会掩盖责任主体，技术文档不允许这种模糊。 - ✅ "网关层拦截所有未授权请求" - ❌ "未授权请求将被拦截" - ✅ "基础架构团队负责 K8s 集群扩容，计划在 M2 完成" - ❌ "相关工作将被推进" ### 词汇替换表 | 口语 / 模糊表达 | 正式技术写法 | 说明 | |---|---|---| | 坦白说、说实话、老实说 | （删除，直接陈述结论） | 引导词不增加信息量 | | 这不是小问题 | 此为关键瓶颈 / 此风险影响 P0 指标 | 量化或定级 | | 这是大问题 | 此处存在 [具体影响] | 说清楚大在哪里 | | 为什么不直接用 X？ | 未选 X 的原因：... | 反问句改陈述句 | | 这事 / 这玩意 | 本项目 / 该方案 / 此设计 | 指代明确 | | 搞定 / 弄好 | 完成 / 实现 / 交付 | — | | 我们觉得 / 我们认为 | 数据表明 / 基准测试显示 / 评估结论为 | 用证据替代主观判断 | | 快速 / 很快 | [具体时间]（如"在 30 秒内"） | 量化 | | 接近 / 几乎 / 差不多 | 具体数字（如"约 97%"） | 避免模糊量词 | | 很大 / 很高 / 非常重要 | [具体数量或影响范围] | 禁用无数据支撑的形容词 | | 显著提升 / 大幅优化 | 从 X 提升至 Y（提升 Z%） | 数据说话 | …
Read the whole file at its exact version.
How to install
mdr add strzhao/autopilot/writer-tech-skill@sha256:66afd9999a64c7a3The line at the top of this page pins the label git:20260309.afcd1f2, 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_44bsodm7j6yz3ovy)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Mar 1, 2026 and Mar 9, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260309.afcd1f2 latest | 2026-03-09 | afcd1f2 | 11,267 B | A | view · diff |
| git:20260309.c4c05df | 2026-03-09 | c4c05df | 10,526 B | A | view · diff |
| git:20260301.4ed9a12 | 2026-03-01 | 4ed9a12 | 9,983 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 (11267 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
strzhao/autopilot · 32 stars · license MIT · pushed 2026-10-28 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_44bsodm7j6yz3ovy GET https://markdownregistry.com/api/v1/resolve?ref=strzhao/autopilot/writer-tech-skill GET https://markdownregistry.com/api/v1/blob/66afd9999a64c7a37061796381c2692a31f6bc6f152f62bc27ac4de9f1857b91
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.