# Markdown Skill

> 方案类文档与 Markdown 输出的落盘规范——任何时候用户要求"写方案""出方案""给方案""输出 Markdown 文档"时，都必须将方案保存为项目 `Assets/Docs_md/` 目录中的 .md 文件，而不只是在对话中输出。当用户说"写方案""出方案""给方案""做个方案""设计方案""技术方案""实现计划""调研/对比""排查记录""输出成 md""存成 markdown"等，或任何要求产出成文方案 / Markdown 文档的场景时，使用本 skill。

- Skill: `reganzed/markdown-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add reganzed/markdown-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/reganzed/markdown-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ReganZed (https://skillmd.com/u/reganzed)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/reganzed/markdown-skill

---


# 方案与 Markdown 文档落盘 · markdown-skill（本项目）

## 核心铁律
- **任何时候**用户要求"写方案""出方案""给方案"，都**必须**将方案保存为 `Assets/Docs_md/` 目录中的 Markdown 文件，**而不只是在对话中输出**。
- 通常情况下，用户要求输出 Markdown 文档时，也一并将文档保存到该目录。
- 若目标目录不存在，则**创建**该目录。

## 默认落盘目录
- **今后所有"方案类" md 文件，默认写到项目根 `Assets/Docs_md/` 文件夹下**（不存在则创建）。
- 本项目为 Unity 工程（含 `Assets/` / `Library/` / `Packages/` / `ProjectSettings/`），故固定落盘到 `Assets/Docs_md/`。

## 适用范围
- 设计方案、技术方案、实现计划、调研 / 对比、排查记录等**成文的方案类文档**。

## 执行步骤
1. 确认目标目录为项目根 `Assets/Docs_md/`。
2. 目标目录不存在则先创建。
3. 用简洁、可复用的文件名保存方案（如 `方案-<主题>-<日期>.md`，或用户指定名）。
4. 落盘后，在对话中告知用户文件的保存路径。

## 例外
- 用户**明确指定了其他路径**时，按用户指定为准。
- 其他 skill 已约定的既定产物（如 `.claude/对话历史.md`）按其原路径 / 用户指定为准，不受本规范影响。