spec-coding-skills/.claude/skills/mr/SKILL.md

name	description
mr	增量修改 RequirementsDoc.md，根据用户指令在现有内容基础上更新需求文档。

Modify RequirementsDoc

当用户调用 /mr 时，执行以下步骤：

1. 读取目标文档

读取 doc/RequirementsDoc.md 文件。

如果文件不存在，提示用户：

RequirementsDoc.md 不存在，请先使用人工方式创建需求文档。

2. 获取修改指令

向用户确认修改内容。用户应提供以下信息之一：

• 具体的修改描述（如"在第3节增加性能需求"）
• 评审报告路径（如 doc/review-RequirementsDoc-claude.md）
• 直接的修改内容

如果用户未提供修改指令，询问：

请说明需要修改的内容，或提供评审报告路径。

3. 修改原则

3.1 增量修改

• 保留原有内容结构和格式
• 仅修改/新增指定部分
• 不删除未明确要求删除的内容

3.2 新增内容标记

对于新增的段落或章节，使用 HTML 注释标记：

<!-- NEW START -->
新增内容...
<!-- NEW END -->

对于行内新增，使用：

原有内容 <!-- NEW --> 新增内容

3.3 修改内容标记

对于修改的内容，保留原文作为注释：

<!-- MODIFIED: 原内容为 "xxx" -->
修改后的内容

4. 执行修改

按照用户指令修改文档：

1. 定位到需要修改的位置
2. 执行增量修改
3. 添加相应的标记
4. 保持文档格式一致性

5. 保存并验证

1. 保存修改后的文档到 doc/RequirementsDoc.md
2. 使用 git diff 展示变更内容
3. 向用户确认修改是否符合预期

6. 输出摘要

向用户展示修改摘要：

• 修改位置（章节/行号）
• 修改类型（新增/修改/删除）
• 修改内容概要

---

注意事项

• RequirementsDoc 是文档链源头，修改会影响所有下游文档
• 修改前确认用户意图，避免误改
• 保持现有文档风格（标题层级、表格格式、列表样式）
• 重大修改建议先运行 /rr 评审确认影响范围
• 修改完成后，建议用户检查下游文档是否需要同步更新

标记清理

当用户确认修改无误后，可手动删除 <!-- NEW --> 和 <!-- MODIFIED --> 标记，或保留作为变更历史参考。

通过 git 可追溯完整修改历史。