writing-plans SKILL.md skillA
writing-plans from jimyag/dotfiles is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jimyag/dotfiles/writing-plans@git:20261015.f79eac0Pins git:20261015.f79eac0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jimyag/dotfiles
- Path
skills/writing-plans/SKILL.md- Versions recorded
- 7
- Latest version
- git:20261015.f79eac0, committed Oct 15, 2026
- First version recorded
- Sep 5, 2026
- Size
- 9,038 bytes
- Repository stars
- 11
- 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
# 编写执行计划 ## 目标 把一个多步骤任务拆成清晰、可执行、可验证的计划，方便后续直接实现。 ## 何时使用 - 实现存在多阶段依赖或跨模块联动，需要先明确顺序与验证方式 - 存在错了会造成高成本返工的决策 - 用户希望先出计划再实现 ## 何时不要使用 - 只是很小的单点改动 - 需求本身还没讲清楚 - 用户明确要求直接动手，不先写计划 ## 计划要求 计划只展开当前任务需要的部分，避免把以下问题机械写成固定章节： - 要做什么 - 为什么这么拆 - 每一步改哪些文件 - 每一步怎么验证 - 哪些地方有风险或前置依赖 - 计划依赖的最脆弱假设是什么 - 哪些决策错了代价高，是否需要先写设计文档或 ADR ## 依赖决策 当任务需要新增库、CLI、代码生成器、服务或其他外部能力时，补一个轻量的 build-vs-buy 判断；不要为标准库、项目已有依赖或明显的机械工具选择制造长篇比较。 至少记录： - 要解决的具体能力，而不是只写依赖名称； - 候选方案，包括复用现有实现、采用成熟依赖或少量本地实现； - 最终选择及理由：维护状态、版本兼容、安全/许可证、运行成本和回滚难度； - 选定依赖需要查阅的官方文档或源码； - 依赖不可用、版本不兼容或方向判断错误时，计划在哪一步停止或回退。 这是决策记录，不是要求每个小改动都做形式化调研。优先复用当前项目已有模式；不要为了证明“build-vs-buy”而引入新依赖。 ## 可选结构 按任务取用下面的章节，删除没有内容的部分： ```markdown # <任务名> 实现计划 ## 目标 <一句话说明要完成什么> ## 前置条件（存在时） - <依赖 1> - <依赖 2> ## 步骤 ### 1. <步骤名> - 修改文件：`path/to/file` - 主要动作：... - 验证方式：... ### 2. <步骤名> - 修改文件：`path/to/file` - 主要动作：... - 验证方式：... ## 风险与注意事项（存在时） - ... ## 依赖决策（新增外部能力时） | 能力 | 候选方案 | 选择 | 理由与代价 | 官方文档/验证 | |---|---|---|---|---| | ... | ... | ... | ... | ... | ``` ## 编写原则 - 步骤按执行顺序排列 - 明确可验证的交付节点；紧密依赖的步骤可以合并验证 - 不要写成空泛口号，要写清文件、动作和验证 - 多文件实现优先拆成垂直切片，每个切片都应能交付一个可运行、可验证的路径 - 对非平凡决策写清主张和约定；计划里要能看出什么证据会推翻这个决策 - 复杂任务优先拆成小步，不要一个步骤包太多事 …
Read the whole file at its exact version.
How to install
mdr add jimyag/dotfiles/writing-plans@sha256:499faa3fc2d1af0eThe line at the top of this page pins the label git:20261015.f79eac0, 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_fswh2jz5oeoel3xi)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 7 versions of this file, between Sep 5, 2026 and Oct 15, 2026, about one every 7 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261015.f79eac0 latest | 2026-10-15 | f79eac0 | 9,038 B | A | view · diff |
| git:20261015.b377f6b | 2026-10-15 | b377f6b | 7,302 B | A | view · diff |
| git:20260920.97cad83 | 2026-09-20 | 97cad83 | 4,592 B | A | view · diff |
| git:20260920.878daed | 2026-09-20 | 878daed | 4,546 B | A | view · diff |
| git:20260918.f8de0f4 | 2026-09-18 | f8de0f4 | 4,466 B | A | view · diff |
| git:20260905.64eb187 | 2026-09-05 | 64eb187 | 3,415 B | A | view · diff |
| git:20260905.751659e | 2026-09-05 | 751659e | 3,215 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 (9038 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
jimyag/dotfiles · 11 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fswh2jz5oeoel3xi GET https://markdownregistry.com/api/v1/resolve?ref=jimyag/dotfiles/writing-plans GET https://markdownregistry.com/api/v1/blob/499faa3fc2d1af0ef445ce58872aa9309755facfd8f8643bfa1dac755347a49e
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.