spec-write SKILL.md skillA

spec-write from hhu3637kr/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hhu3637kr/skills/spec-write@git:20261106.f67a3a4

Pins git:20261106.f67a3a4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hhu3637kr/skills
Path
spec-write/SKILL.md
Versions recorded
10
Latest version
git:20261106.f67a3a4, committed Nov 6, 2026
First version recorded
Aug 8, 2026
Size
12,811 bytes
Repository stars
146
License
none declared

撰写代码实现计划(writer/plan.html)。由角色 spec-writer 调用。 触发条件:(1) 角色 spec-writer 需要创建设计方案、API 规范、数据模型、架构设计、重构方案, (2) 用户说"创建 Spec"/"撰写设计文档"/"写技术规格"/"设计方案", (3) 当前 Spec 目录下需要新建 writer/plan.html。 注意:v2.0 起 writer/plan.html 不含测试计划章节(由 spec-tester 用 spec-test 单独创建), execution_mode 固定为 single-agent,且仅表示实现阶段执行模式,不否定项目级角色协作。 如果目录下已有 executor/summary.html 且仍在该 Spec 的活跃分支内,应使用 spec-update 而非本 Skill;若原分支已合并/关闭,后续需求默认新建 Spec。.

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

# Spec Write

## 运行契约

> 进入核心规则前先对齐这张表。它把本 Skill 当成一个有边界的循环单元:明确读什么、能动什么、怎么算完成、什么时候停、什么时候交还给人。

| 项 | 本 Skill 的约定 |
|----|----------------|
| 输入 | `explorer/exploration-report.html`、与 spec-tester 讨论的接口边界、TeamLead 提供的 Git 元数据、`html-report` skill 的报告契约 |
| 权限 | 只写 `writer/plan.html`(设计方案);不写测试计划、不实现代码、不归档、不提交;目录分类错误时通过 TeamLead 请求修正 |
| 验证 | plan 含 7 个必需章节、版本目录归属正确、命名为 `YYYYMMDD-HHMM-属性-任务描述`(中文任务描述)、分支字段与当前分支一致、HTML 骨架与修订标记符合 `html-report` 规范;plan 必须含接口签名、数据结构、文件清单、每个任务的验证命令,缺任一项不得进入实现 |
| 停止 | plan 定稿且通过确认即停止,不在确认前编写代码、不"顺手"加 Spec 未要求的设计 |
| 升级 | 探索背景不足、接口边界与 spec-tester 无法对齐、或需求超出当前 Spec 范围时,交回 TeamLead 由用户决策 |
| 参考 | plan 定稿前 → 必读 `references/plan-quality.md` |

## 核心规则

### 确认方式随模式(必须执行)

**确认方式随模式**:`gated` 模式下完成 `writer/plan.html` 撰写后必须用当前运行环境的确认方式向用户确认;`autopilot` 模式下由「plan 完备度闸门(接口签名/数据结构/文件清单/每任务验证命令四项齐备)+ Spec 自审四问全部通过」替代该确认,两者缺一不可放行。四项与四问的细则见 [references/plan-quality.md](references/plan-quality.md)。

`gated` 模式的确认话术:

```text
确认目标:writer/plan.html 已创建完成,请确认设计方案是否可以开始实现?
确认选项:
- 确认,开始实现
- 需要修改(请说明修改要求)
```

`autopilot` 模式下把闸门四项与自审四问的逐条结论写入账本,任一项不齐或任一问未过即停止,不得放行到实现阶段。

### 需求性质与命名规范
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hhu3637kr/skills/spec-write@sha256:c7cc06fb7bfe6dfd

The line at the top of this page pins the label git:20261106.f67a3a4, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_f6zifvixl73xs6ck.svg)](https://markdownregistry.com/a/art_f6zifvixl73xs6ck)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Aug 8, 2026 and Nov 6, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20261106.f67a3a4 latest2026-11-06 f67a3a4 12,811 BA view · diff
git:20261105.3ebe4fe2026-11-05 3ebe4fe 12,880 BA view · diff
git:20261105.6c96fc32026-11-05 6c96fc3 12,879 BA view · diff
git:20260922.b9191a22026-09-22 b9191a2 12,286 BA view · diff
git:20260921.ee097b42026-09-21 ee097b4 11,986 BA view · diff
git:20260916.4e6c7272026-09-16 4e6c727 11,785 BA view · diff
git:20260911.414b35f2026-09-11 414b35f 11,666 BA view · diff
git:20260908.b554d332026-09-08 b554d33 11,378 BA view · diff
git:20260809.55297812026-08-09 5529781 11,857 BA view · diff
git:20260808.cc3dbc12026-08-08 cc3dbc1 10,824 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12811 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

GitHub

hhu3637kr/skills · 146 stars · license none declared · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_f6zifvixl73xs6ck
GET https://markdownregistry.com/api/v1/resolve?ref=hhu3637kr/skills/spec-write
GET https://markdownregistry.com/api/v1/blob/c7cc06fb7bfe6dfd6f0a072e7810a57b8244d330c3567be85096b6523aa5c113

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 hhu3637kr/skills

AGENTS.md AGENTS.md file
hhu3637kr/skills · AGENTS.md
git:20260908.b554d33 · audit A · 146 stars
CLAUDE.md CLAUDE.md file
hhu3637kr/skills · CLAUDE.md
git:20260809.5529781 · audit A · 146 stars
android-native-dev SKILL.md skill
hhu3637kr/skills · android-native-dev/SKILL.md · Use when the user is developing, reviewing, or troubleshooting a native Android app, especially Kotlin/Compose…
v1.0.0 · audit A · 146 stars
book2skill SKILL.md skill
hhu3637kr/skills · cangjie-skill/SKILL.md · Distill a book into a coherent set of executable skills. Use when the user asks to "拆书" / "蒸馏一本书" / "把 XX 书做成 skill" /…
git:20260616.4e81a9c · audit A · 146 stars
darwin-skill SKILL.md skill
hhu3637kr/skills · darwin-skill/SKILL.md · Darwin Skill (达尔文.skill): autonomous skill optimizer inspired by Karpathy's autoresearch. Evaluates SKILL.md files…
git:20260616.4e81a9c · audit A · 146 stars
exp-reflect SKILL.md skill
hhu3637kr/skills · exp-reflect/SKILL.md · 当任务完成、解决困难问题、用户要求总结经验/记录项目理解/更新项目规范,或 spec-end/spec-update 需要从当前 Spec 文档判断是否沉淀经验、知识、SOP、工具记忆、长期项目规范时使用。本 Skill 只做识别 +…
git:20260923.a4b35af · audit A · 146 stars
exp-search SKILL.md skill
hhu3637kr/skills · exp-search/SKILL.md · 经验检索 Skill,根据关键词搜索项目历史记忆(经验记忆+知识记忆+程序记忆SOP+工具记忆+Auto Memory只读)。触发场景:开始复杂任务前、遇到问题时、需要查找历史解决方案、查找项目理解文档。
git:20260808.cc3dbc1 · audit A · 146 stars
exp-write SKILL.md skill
hhu3637kr/skills · exp-write/SKILL.md · 记忆写入 Skill,将重大经验写入 spec/context/experience/ 或知识记忆写入 spec/context/knowledge/,并更新对应索引(不写 MEMORY.md)。触发场景:`/exp-write…
git:20260923.a4b35af · audit A · 146 stars
find-skills SKILL.md skill
hhu3637kr/skills · find-skills/SKILL.md · Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is…
git:20260622.71b252e · audit A · 146 stars
frontend-dev SKILL.md skill
hhu3637kr/skills · frontend-dev/SKILL.md · Use when the user asks to build a polished web UI or frontend experience: landing pages, marketing/product sites…
v1.0.0 · audit A · 146 stars
fullstack-dev SKILL.md skill
hhu3637kr/skills · fullstack-dev/SKILL.md · Full-stack backend architecture and frontend-backend integration guide. TRIGGER when: building a full-stack app…
v1.0.0 · audit A · 146 stars
gif-sticker-maker SKILL.md skill
hhu3637kr/skills · gif-sticker-maker/SKILL.md · Convert photos (people, pets, objects, logos) into 4 animated GIF stickers with captions. Use when: user wants to…
v1.2 · audit A · 146 stars

Every file in hhu3637kr/skills

Browse by kind, by grade A, or by owner.