writing-skills SKILL.md skillA
writing-skills from jnmetacode/superpowers-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jnmetacode/superpowers-zh/writing-skills@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jnmetacode/superpowers-zh
- Path
skills/writing-skills/SKILL.md- Versions recorded
- 8
- Latest version
- v1.0.0, committed Sep 28, 2026
- First version recorded
- Mar 20, 2026
- Size
- 25,561 bytes
- Repository stars
- 8,348
- 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
# 编写技能 ## 概述 **编写技能就是将测试驱动开发应用于流程文档。** **个人技能存放在你所用运行环境的技能目录中**（Claude Code 上是 `~/.claude/skills/`）——其他运行环境的路径见 [codex-tools.md](../using-superpowers/references/codex-tools.md) 或 [gemini-tools.md](../using-superpowers/references/gemini-tools.md)。Codex、Copilot CLI 和 Gemini CLI 也都认 `~/.agents/skills/`，作为跨运行环境的别名。 你编写测试用例（带子智能体的压力场景），观察它们失败（基线行为），编写技能（文档），观察测试通过（智能体遵守规则），然后重构（堵住漏洞）。 **核心原则：** 如果你没有观察到智能体在没有该技能时失败，你就不知道这个技能是否教了正确的东西。 **必需背景：** 在使用此技能前，你必须理解 test-driven-development。该技能定义了基本的红-绿-重构循环。本技能将 TDD 适配到文档编写中。 **官方指南：** Anthropic 官方的技能编写最佳实践请参见 anthropic-best-practices.md。该文档提供了补充本技能 TDD 导向方法的额外模式和指南。 ## 什么是技能？ **技能**是经过验证的技术、模式或工具的参考指南。技能帮助未来的 Claude 实例找到并应用有效的方法。 **技能是：** 可复用的技术、模式、工具、参考指南 **技能不是：** 关于你某次如何解决问题的叙事 ## TDD 映射到技能 | TDD 概念 | 技能创建 | |----------|---------| | **测试用例** | 带子智能体的压力场景 | | **生产代码** | 技能文档（SKILL.md） | | **测试失败（红）** | 智能体在没有技能时违反规则（基线） | | **测试通过（绿）** | 智能体在有技能时遵守规则 | | **重构** | 在保持合规的同时堵住漏洞 | | **先写测试** | 在编写技能之前先运行基线场景 | | **观察失败** | 记录智能体使用的确切合理化借口 | | **最小代码** | 编写针对那些具体违规行为的技能 | | **观察通过** | 验证智能体现在遵守规则 | | **重构循环** | 发现新的合理化借口 → 堵住 → 重新验证 | 整个技能创建过程遵循红-绿-重构。 ## 何时创建技能 **创建条件：** - 技术对你来说不是直觉上显而易见的 - 你会在不同项目中反复引用 - 模式具有广泛适用性（非项目特定） …
Read the whole file at its exact version.
How to install
mdr add jnmetacode/superpowers-zh/writing-skills@sha256:ed55830f109a2806The line at the top of this page pins the label v1.0.0, 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_vvw6um4o47xj7laf)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 8 versions of this file, between Mar 20, 2026 and Sep 28, 2026, about one every 28 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-09-28 | 0599c89 | 25,561 B | A | view · diff |
| v1.0.0 | 2026-09-26 | 40b0d4f | 25,302 B | A | view · diff |
| v1.0.0 | 2026-09-06 | ee2bb93 | 25,011 B | A | view · diff |
| v1.0.0 | 2026-08-07 | 3f6ffd5 | 25,059 B | A | view · diff |
| v1.0.0 | 2026-08-07 | 02d2551 | 21,564 B | A | view · diff |
| v1.0.0 | 2026-06-16 | 952fc29 | 21,938 B | A | view · diff |
| git:20260327.4a55cbf | 2026-03-27 | 4a55cbf | 21,854 B | A | view · diff |
| git:20260320.80bc100 | 2026-03-20 | 80bc100 | 21,687 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 (25561 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
jnmetacode/superpowers-zh · 8,348 stars · license MIT · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_vvw6um4o47xj7laf GET https://markdownregistry.com/api/v1/resolve?ref=jnmetacode/superpowers-zh/writing-skills GET https://markdownregistry.com/api/v1/blob/ed55830f109a2806bc14d220e0854d385e3a90bb33b375a41a878d6466b762f4
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.
More from jnmetacode/superpowers-zh
Every file in jnmetacode/superpowers-zh