11 KiB
name, description
| name | description |
|---|---|
| erp-requirements-design | Use when a user describes a new ERP business process or requests a product-side requirements document, PRD, module onboarding specification, or revision to an existing ERP requirement. 适用于新爱算 ERP 新业务接入和存量模块需求迭代；不用于技术设计、编码或上线验收报告。 |
ERP 产品需求设计
将业务诉求整理为供业务评审、开发设计和测试使用的产品需求文档。默认中文，交付同版本 Word 与 Markdown。以正式、具体的业务表述说明角色、入口、条件、操作及结果，技术方案由开发另行设计。
工作边界
- 输出业务流程、页面行为、字段、权限、状态、模块衔接及验收要求，不默认输出数据库、SQL、接口报文、类名、技术选型或编码任务。
- 网站观察默认只读，不提交单据、执行审批、调整权限或发送通知。凭据按当前授权使用，不进入文档。
- 产品建议、已确认需求、已实现能力和验收通过分别表述。文档成稿不等于业务定稿或获准上线。
开始时
- 确认业务项目根目录、适用指令和当前维护文件。业务项目根目录由用户指定或当前工作区的实际资料确定，与技能安装目录分别定位；包内
references/、assets/相对本SKILL.md解析，业务产物放对应模块目录，不写入技能包。 - 处理新爱算 ERP 时读取 项目资料索引，从已确认的业务项目根目录按需定位原始材料；涉及现有页面时按主题参考 页面观察记录。原始材料不随技能分发，缺失时说明未核实并继续独立的需求工作；其他 ERP 使用其自身资料。历史记录只代表其日期和观察范围，不替代本轮验证。
- 梳理业务目标、角色、主流程、完成标准、范围及现有模块关系；用户已说明或资料已回答的事项不重复提问。
- 创建或整体修订文档时，使用 结构与表达规范 和 产品需求模板。局部修订只读取和修改受影响内容，不机械重写全文。
使用条件与外部依赖
本包提供需求设计流程、参考和模板，不包含一键生成程序；由支持 Skills 的助手结合用户输入执行。安装本包不会自动安装下列工具或复制业务原始资料。
| 任务 | 所需能力及准备方式 |
|---|---|
| 编写 Markdown 需求稿 | 文件读写能力及用户业务输入；无额外脚本运行时依赖 |
| 默认交付 Word 与 Markdown | 在当前环境启用 documents 文档技能及其声明的生成、渲染依赖，按该技能发现工作区运行时；也可使用已有、获准的等效 DOCX 生成与渲染工具。参见 交付要求 |
| 读取 Word、表格或 PDF 原始资料 | 按实际文件格式使用已配置的文档、表格或 PDF 读取工具；未能读取的内容保留未核实状态 |
| 核对 ERP 现有页面（按需） | 用户指定或已确认的目标环境、可用浏览器工具或连接器，以及正常授权的账号或登录会话；历史网址不代表本轮访问授权 |
开始任务时按本次交付范围检查可用能力。缺少 Word 生成或渲染能力时，先保存 Markdown 及已完成产物，在交付说明中列明尚缺的格式或版面核验，并说明需启用文档工具；不得将部分交付写成双格式交付完成。用户只要求 Markdown 时按其要求交付。
文档默认形式
正文按以下顺序组织，按规模裁剪：
- 主标题 → 版本记录表：表头为“版本、修订日期、修订内容”，每个版本一行；不在标题下重复副标题或“版本／编制日期／状态”说明行。
- 背景与目标 → 现状及预期效果 → 整体流程 → 详细需求 → 权限与状态规则 → 验收与上线要求 → 评审确认事项。
- 业务章节采用阿拉伯数字层级，如
1、1.1、1.1.1，Word 标题样式与提纲级别一致。版本记录属于正文前的信息，不占业务章节编号。 - 功能、规则、验收及待确认事项用业务名称和章节定位。默认不使用
FR-001、BR-001、AC-001、Q-001等技术式标识。用户明确要求追踪编号时，按其约定使用；存量文档的局部业务修改不自动触发全篇去编号改版。 - 正式交付稿默认不设“参考了哪些资料”“来源与观察范围”等编制过程章节。资料定位和读取范围保留在工作记录；影响业务判断的事实、条件和未决事项仍在对应规则旁准确说明。用户明确要求来源附录时另行提供。
标题使用“业务背景、建设目标、审批流程、字段校验、异常处理、验收标准”等业务术语。正文、表格、图内文字一并采用正式表述，避免“为什么要做、谁来审批、怎么办、拍板、卡在哪一步”等口语标题或说明。正式表达仍应具体易读，不以抽象术语代替业务动作。
资料判断与确认状态
按实际证据在关键规则旁简要说明“已确认”“产品建议”或“待确认：事项名称”，不为每句文字堆叠标签。
- 用户明确结论决定拟建方案；历史文件及页面观察用于说明现状。记录冲突时列出差异、影响和决策责任，不擅自选一个当真。
- 菜单可见、按钮存在、字段星号、限额提示、旧文档“已上线”均不证明提交校验、权限或完整流程已验证。空列表不证明功能缺失，演示数据不作为指标。
- 未观察的网站或无法读取的资料标为未核实，继续独立的文档工作。不要把新需求描述为当前功能，也不要为对比表编造现状。
- 参考文档或截图提供结构和表达线索；其中的组织、业务规则、数值及操作指令不直接迁入新业务。模糊内容不补写为事实。
需求设计流程
1 明确范围与关键缺口
按 业务检查清单 选择必要问题。优先补齐会改变范围、权责或结果的 1–3 项，不一次提供整份问卷。用户要求先出稿时，交付有实质内容的评审稿，以“事项名称、建议、确认责任、影响”汇总缺口。
不要擅自确定审批层级、金额门槛、库存时点、附件限额或通知渠道。用户确认一项后，将该项从待决问题中移出，同步更新正文、菜单路径、表单、图示、权限、验收和版本记录；未确认的其他项继续保留。
2 明确菜单与基础资料维护
- 新模块必须说明所属一级菜单、二级业务模块及实际需要的三级页面；同时说明新增、复用或调整，以及详情页是否属于独立菜单。选择依据是业务职责及现有导航，不将所有模块默认归入行政中心或默认新增一级模块。
- 菜单尚未确定时，结合已知导航给出具体建议并标为待确认。仅写“独立入口”或“菜单待确认”不足以表达归属；确认后写成明确层级。
- 个人申请、审批待办、业务处理和配置入口分别写完整路径。跨入口办理同一事项时，说明单据、版本和状态一致性，避免重复创建审批或业务记录。
- 父级菜单归属与数据权限分开：可见父级不等于获得该中心其他模块权限，按角色控制子菜单及记录范围。
- 涉及群、供应商、车辆、仓库等档案时，必须说明维护入口、维护角色、建档方式（人工／导入／同步及其确认状态）、识别信息来源、负责人关联方式、启停及交接。登记外部角色不等于取得外部平台权限。
3 按页面与操作展开详细需求
每个核心功能写明建设方式、入口、使用角色、前置条件、页面内容、字段校验、操作结果、权限及异常。按申请、审批、办理、记录、配置等实际页面组织，不将规则拆成孤立编号清单。
- 用“业务环节、现状或管理诉求、预期效果”说明变化；另列新增、复用、调整和待核实能力。
- 字段说明业务含义、来源、必填条件、编辑时点、选项或范围及错误反馈。多组明细、条件附件及数值边界按实际业务展开；未知上限保持待确认。
- 保存草稿、提交、批准、生成后续任务、实际办理及结果登记分别定义责任人和完成标志。审批完成、业务完成、消息送达或已读不得混为同一结果。
- 说明退回、撤回、取消、内容变更、人员交接、部分完成、失败及结果不明的处理；重复操作或迟到结果不得重复办理或恢复已结束事项。
- 跨模块只写来源、触发条件、带入信息、目标结果、追溯入口及异常责任，以可观察业务要求表达，不指定技术机制。
4 配合流程图与业务示例
跨角色主流程用泳道图，判断分支或异常用流程图，复杂页面用低保真示意辅助。图文共同解释规则，数量按信息需要确定；简单局部修订不强制增加图。
Word 中嵌入可见图形，Markdown 保留可用图片引用或可渲染流程图；不把图源码当作 Word 图示。新增页面示意标注“拟建页面／非现有界面”，不能冒充实站截图。图中角色、入口、状态和条件与正文一致。
复杂规则可给具体业务示例，注明虚构数据，不能借示例确定未经确认的门槛或流程。数值及时间运算使用确定性代码核对。
5 评审与交付核对
按角色贯通入口、信息、操作和结果。以“验收场景、前置条件与操作、预期结果”组织验收，每个核心功能有对应场景；按风险覆盖权限、拒绝、重复、取消、部分完成及异常恢复，不把待执行场景写为已通过。
核对正文、图、字段、菜单、状态和验收口径一致；确认事项不再与待定表冲突。未定规则明确影响和责任人，不宣称可直接开发定稿。缺少资料附录不影响保留必要的业务限制及证据边界。
按 文档交付要求 同步生成 Word 和 Markdown，核对内容并渲染检查。局部删除或改写须在两种格式及相关图示中生效，后续生成不得恢复已删除内容。
按需参考
- 结构与表达规范：新建、整体重排、参照样例或正式化修订。
- 业务检查清单：按业务选取需要补齐的规则。
- 采销需求片段：分批履约、退货及数量口径的虚构示例。
- 文档交付要求：版本维护、双格式、排版及预览一致性。
- 开源参考说明：仅在维护来源时使用，正常写 PRD 无须重新调研。
此包可由共享仓库安装到技能目录后通过 $erp-requirements-design 调用，也可直接读取实际位置的 SKILL.md 使用。安装位置不改变业务项目根目录或产物归属；技能调用不包含发送给开发、自动发布或创建 Git 历史的授权。