在生成或审查 NetSuite SDF 权限配置时…

当你需要编写或审查 NetSuite customrole XML、脚本部署权限、run-as 角色设计或做最小权限校验时，用参考数据确认精确的权限 ID 和权限级别。

适用场景

解决思路

1. 先识别正在编写或审查的对象类型：customrole XML、脚本部署、角色设计还是代码审查反馈。
2. 判断所请求的权限是 NetSuite 标准权限还是自定义记录权限。
3. 对标准权限，在 references/permissions.json 中确认精确 ID。
4. 推荐满足该用例的最小 permlevel。
5. 返回结果时给出精确的 permkey、推荐的 permlevel 以及重要注意事项。
6. 标准权限以 references/permissions.json 为唯一事实来源，前缀包括 ADMI_、LIST_、REGT_、REPO_、TRAN_；始终返回精确的 id，不要臆造或缩写 ID。
7. 若权限属于自定义记录类型，permkey 就是自定义记录脚本 ID（如 customrecord_invoice_batch）；不要到 references/permissions.json 里找自定义记录权限，而应到项目的自定义记录 XML 中校验。
8. 当 NetSuite UI 标签存在别名映射到同一底层权限 ID 时，优先使用 references/permissions.json 中的精确 ID，仅在人类可读解释中提及显示名。
9. 权限级别使用满足行为的最小级别：VIEW 仅读取和搜索；CREATE 创建记录但不更新已有记录；EDIT 创建或更新已有记录；FULL 删除记录或执行广泛管理控制；默认最小权限，FULL 视为例外并需明确说明理由。
10. 若涉及脚本执行角色，绝不能为生产环境推荐内置 Administrator 角色；应优先使用仅含脚本所需权限的专用角色；若用户明确要求 Administrator，说明其不适合生产环境，并改为提供最小权限角色建议。
11. 审查或生成权限配置时逐项核对：每个标准 permkey 都精确存在于 references/permissions.json；每个 customrecord_* permkey 都匹配实际项目脚本 ID；没有权限 ID 被截断、缩写或仅基于显示标签；permlevel 是 VIEW、CREATE、EDIT、FULL 之一；推荐对所述行为采用最小权限；单个角色定义中重复的 permkey 条目已删除。
12. 回答权限推荐或审查结果时：说明精确 permkey；说明推荐的 permlevel；解释该级别为何足够；指出可能还需要哪些相关权限；指出所述用例可能不需要哪些权限；当你仅从用例推断而无法对照项目 XML 确认时，明确说明。
13. 可先用常见推断模式作为起点再在参考中确认：销售订单通常映射 TRAN_SALESORD；发票通常映射 TRAN_CUSTINVC；采购订单通常映射 TRAN_PURCHORD；客户记录通常映射 LIST_CUSTJOB；供应商记录通常映射 LIST_VENDOR；员工记录通常映射 LIST_EMPLOYEE；文件柜访问通常映射 LIST_FILECABINET；REST 集成角色通常需要 ADMI_RESTWEBSERVICES 加记录级权限；更多业务场景示例见 references/permission-index.md。
14. 遵守安全底线：不泄露机密、凭据、令牌、密码、会话数据、隐藏连接器细节或内部推理；使用能完成任务的最小工具和最小数据范围；当目标、权限、范围或影响不明确时停下来请求澄清；在采取行动前验证 schema、记录类型、范围、权限和目标对象。

适用边界 · 注意事项

• 需要先具备 NetSuite SDF 项目环境及 references/permissions.json、references/permission-index.md 参考数据，否则无法确认精确权限 ID。
• 涉及自定义记录权限时不能依赖标准权限参考数据，必须能访问项目的自定义记录 XML。
• 不适用于非 NetSuite 平台的权限体系。