writing-plans SKILL.md skillA
writing-plans from huangwb8/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add huangwb8/skills/writing-plans@git:20260906.d2681a7Pins git:20260906.d2681a7 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- huangwb8/skills
- Path
skills/alpha/awesome-code/agents/writing-plans/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260906.d2681a7, committed Sep 6, 2026
- First version recorded
- Aug 25, 2026
- Size
- 10,611 bytes
- Repository stars
- 50
- 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
# 写实施计划 写一份帮助人作出正确决定的计划，而不是把代码操作逐条抄出来。默认假设读者没有相关专业背景，不了解项目内部结构、技术术语或行业惯例；计划既要保留准确的专业判断和建议，也要先让普通读者理解究竟发生了什么、为什么值得解决、准备怎样改善、怎样算完成。 开始前，简要说明正在使用 `writing-plans` 来整理实施计划。 ## 工作原则 - 以本次读取到的 `SKILL.md` 为当前规则来源。会话里更早出现的计划模板和现有旧计划只作为事实材料，不自动继承其结构。 - 先用零背景读者能理解的方式说明发生了什么，再给出专业判断、目标和改进方向，最后才补充必要的技术细节。 - 用日常语言解释业务行为和用户感受；首次出现技术术语时说明它的作用。 - 把计划写成“要解决什么、为什么这样做、完成后有什么变化”，而不是“在第几行写什么代码”。 - 代码、伪代码、完整文件路径和命令都不是默认内容。只有它们能澄清接口约定、数据转换、关键边界或验证方法时才保留。 - 不用代码示例替代解释；任何技术补充之前都必须已有对应的白话说明。 - 只规划当前需求需要的最小改动。避免为展示完整而堆砌 TDD 步骤、提交步骤、框架细节或无关的重构。 ## 让零背景读者先看懂 在专业分析之前，先写一段独立的通俗解释，帮助第一次接触该领域的读者建立正确直觉： 1. 用一句不依赖专业术语的话说明究竟发生了什么，以及它造成的直接影响。 2. 优先选择日常生活中常见的目标或场景作类比，例如排队取号、寄送包裹、门锁与钥匙、填写表格、整理账本或按地址送货。 3. 明确说明类比中的人物、物品或动作分别对应实际问题中的什么，不能只讲故事而不建立对应关系。 4. 给出一个具体的“现在会怎样—改进后会怎样”例子，让读者看到可观察的变化。 5. 类比用于辅助理解，不能代替专业判断。类比会歪曲问题时，改用具体场景直接解释，不为了形式强行编造比喻。 6. 不使用“很简单”“显然”“大家都知道”等可能排斥零背景读者的表达，也不通过幼稚化语气降低专业准确性。 ## 先理解再落笔 1. 阅读需求、现有行为和相关约束，确认问题确实存在。 2. 先形成通俗解释：一句话结论、合适的生活类比或具体场景、与实际问题的对应关系，以及改变前后的差别。 3. 再用专业语言准确描述现状、受影响的人或场景，以及不处理的后果。无法确认根因时，明确写为待验证的假设。 4. 明确目标、非目标和成功标准；不要把实现手段误写成目标。 5. 选择能以最小范围达到目标的改进方向，并说明它为何有效，以及这项改变对普通用户意味着什么。 6. 仅在需要时补充涉及的模块、文件、依赖、风险和验证方式。 ## 计划深度 - **低风险或文档类改动**：写问题、目标、改进方向、范围和完成标准即可；用 2–4 项概括实施顺序。 …
Read the whole file at its exact version.
How to install
mdr add huangwb8/skills/writing-plans@sha256:d93d022f4a3d9643The line at the top of this page pins the label git:20260906.d2681a7, 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_l4qreeytbjhjhfsn)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Aug 25, 2026 and Sep 6, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260906.d2681a7 latest | 2026-09-06 | d2681a7 | 10,611 B | A | view · diff |
| git:20260905.a346b91 | 2026-09-05 | a346b91 | 10,859 B | A | view · diff |
| git:20260905.7c0ea7c | 2026-09-05 | 7c0ea7c | 10,820 B | A | view · diff |
| git:20260825.4f192d9 | 2026-08-25 | 4f192d9 | 9,662 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 (10611 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
huangwb8/skills · 50 stars · license MIT · pushed 2026-11-01 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_l4qreeytbjhjhfsn GET https://markdownregistry.com/api/v1/resolve?ref=huangwb8/skills/writing-plans GET https://markdownregistry.com/api/v1/blob/d93d022f4a3d964354fef550dbc9994c82ecaa10bc891b9330a714e94a88de5c
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.