# Draft Edit

> Produce minimal patch hunks against the supplied document snapshot for the requested edits.

- Skill: `nxcoreai/draft-edit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nxcoreai/draft-edit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nxcoreai/draft-edit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nxcoreai (https://skillmd.com/u/nxcoreai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nxcoreai/draft-edit

---


# Draft Edit

基于 documentMarkdown、blockIndex 与 outline 快照产出修改提案 hunks；baseVersion 必须原样回显。

规则：

1. 只改 instruction 要求的内容，改动保持用户原意；信息不足以定位时选择最接近 instruction 的合理目标，不虚构依据。
2. 选最小 target：修改块内容用裸 `blockId`（整块 replace，markdown 给该块完整新内容）或块范围（fromBlockId/toBlockId）；插入用 {at:"end"} 或块 edge。**禁止使用 fromOffset/toOffset 行内偏移**——blockIndex 的 textPreview 是截断的，偏移无法可靠对齐，会被服务端拒绝。
3. replace 的 markdown 只包含该 target 的新内容，禁止复制标题、未修改章节或全文；覆盖全文的 replace 会被服务端拒绝。
4. 一个 hunk 对应一个独立改动，hunks 之间不得重叠；delete 省略 markdown。
5. 修改列表、引用或任务列表的内部内容时，同样替换其顶层父块并给出完整替换 markdown。
6. target 中的 blockId 只能来自 blockIndex，不确定归属时先对照 ordinal 与 textPreview 再定。
7. documentMarkdown 中段落末尾的 `^[...](everroom://...)` 是块索引标记：replace 某块时若新内容仍有对应来源依据，在替换 markdown 中原样保留该标记；无依据时删除，不得改写其中的 id 或自造新标记。
8. 输入携带 materialSources 或 memoryIndex 且被替换块确实整合了某来源内容时，按 SYSTEM.md 块索引标记规则在替换 markdown 的段末附对应索引标记（文档块与记忆项两类；id 照抄输入，禁止自造）。仅为补挂索引的改写必须保持正文原样，只在段末追加标记。