writing-plans SKILL.md skillA
writing-plans 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-plans@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-plans/SKILL.md- Versions recorded
- 8
- Latest version
- v1.0.0, committed Sep 26, 2026
- First version recorded
- Mar 20, 2026
- Size
- 9,853 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
# 编写计划 ## 概述 为一位没见过这个代码库、也没见过这份规格的工程师编写实现计划。假设他们一旦知道确切的接口和确切的测试，就能用项目所用的语言写出地道的代码；也假设在计划留出选择余地的地方，他们会做出合理的选择。他们无从知道的，是你已经决定了什么：哪些文件、哪些名字和签名、规格里的哪些取值、哪些测试证明每个任务。把这些记下来。将整个计划拆成小步骤任务。DRY。YAGNI。TDD。频繁 commit。 **开始时宣布：** "我正在使用 writing-plans 技能创建实现计划。" **上下文：** 此技能应在专用 worktree 中运行（由 brainstorming 技能创建）。 **计划保存位置：** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md` - （用户对计划位置的偏好优先于此默认值） ## 范围检查 如果规格涵盖了多个独立子系统，它应该在头脑风暴阶段就被拆分为子项目规格。如果没有，建议将其拆分为独立的计划——每个子系统一个。每个计划应该能独立产出可工作、可测试的软件。 ## 文件结构 在定义任务之前，先列出将要创建或修改的文件以及每个文件的职责。这是锁定分解决策的地方。 - 设计边界清晰、接口定义良好的单元。每个文件应有一个明确的职责。 - 你对能一次放入上下文的代码推理得最好，文件越专注你的编辑越可靠。优先选择小而专注的文件，而非承担过多功能的大文件。 - 一起变更的文件应放在一起。按职责拆分，而非按技术层级拆分。 - 在现有代码库中，遵循已有模式。如果代码库使用大文件，不要单方面重构——但如果你正在修改的文件已经变得难以管理，在计划中包含拆分是合理的。 此结构决定了任务分解。每个任务应产出独立的、有意义的变更。 ## 任务粒度定界 一个任务是**能独立承载自己那一轮测试循环、且值得一个全新审查者把关**的最小单元。划任务边界时：把搭建、配置、脚手架和文档这些步骤，折进那个真正需要它们的交付物所在的任务里；只在「审查者有可能否掉这个任务、同时批准它旁边那个」的地方才拆开。每个任务都以一个**可独立测试的交付物**结束。 ## 步骤粒度 **每步是一个操作，并有一个可检查的结果：** - "编写失败的测试" - 一步 - "运行它确认失败" - 一步 - "实现最少代码让测试通过" - 一步 - "运行测试确认通过" - 一步 - "Commit" - 一步 ## 计划文档头部 **每个计划必须以此头部开始：** ```markdown # [功能名称] 实现计划 …
Read the whole file at its exact version.
How to install
mdr add jnmetacode/superpowers-zh/writing-plans@sha256:6be69b0ee946d23eThe 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_ucadgsyem54p6dvf)
5 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 26, 2026, about one every 27 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-09-26 | 40b0d4f | 9,853 B | A | view · diff |
| v1.0.0 | 2026-09-07 | ab9f1c2 | 6,484 B | A | view · diff |
| v1.0.0 | 2026-09-06 | ee2bb93 | 6,087 B | A | view · diff |
| v1.0.0 | 2026-08-07 | 3f6ffd5 | 6,135 B | A | view · diff |
| v1.0.0 | 2026-08-07 | 02d2551 | 5,691 B | A | view · diff |
| v1.0.0 | 2026-06-16 | 952fc29 | 5,903 B | A | view · diff |
| git:20260327.4a55cbf | 2026-03-27 | 4a55cbf | 5,817 B | A | view · diff |
| git:20260320.80bc100 | 2026-03-20 | 80bc100 | 5,195 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 (9853 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_ucadgsyem54p6dvf GET https://markdownregistry.com/api/v1/resolve?ref=jnmetacode/superpowers-zh/writing-plans GET https://markdownregistry.com/api/v1/blob/6be69b0ee946d23e5379a31f601fb7001db77e32973f6a7cec5bdc6c069eb216
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