enterprise-prompt-development-spec

Category: Development & Coding | Uploader: 854771076 | Downloads: 0 | Version: v1.0（Latest）
企业级AI提示词全生命周期开发规范，包含需求设计、开发编写、版本管控、测试验收、安全合规全流程，适用于企业级提示词项目开发
Changelog: Source: GitHub https://github.com/854771076/oh-my-claude-roles
Directory Structure

Current level: tree/master/packages/ai/Prompt/v1.0.0/skills/enterprise-prompt-development-spec/
📄 reference.md 12.7 KB
📄 SKILL.md 6.7 KB
SKILL.md

---
name: enterprise-prompt-development-spec
description: 企业级AI提示词全生命周期开发规范，包含需求设计、开发编写、版本管控、测试验收、安全合规全流程，适用于企业级提示词项目开发
---

# 企业级AI提示词开发规范

本规范基于2026年大模型应用开发生态、企业级安全合规标准与生产实践制定，与TypeScript+Next.js全栈开发规范、以太坊开发规范、LangChain/LangGraph技术栈完全兼容对齐。所有标注「必须」的条款为强制执行项，特殊场景需AI技术委员会与安全合规委员会双审批后方可调整。

## 核心原则

1. **安全合规优先**：所有提示词开发以数据安全、系统安全、合规风控为最高优先级，杜绝提示词注入、越狱、敏感信息泄露、违规内容生成等风险
2. **类型安全与标准化**：全链路与企业现有TS技术栈对齐，强制结构化输入输出，实现编译时+运行时双校验，杜绝格式断层导致的业务故障
3. **可复现可审计**：所有提示词必须可稳定复现输出效果，全生命周期变更、调用、测试记录可追溯、可审计
4. **业务确定性优先**：企业级提示词以输出确定性、稳定性为核心目标，优先保障业务规则落地，而非创意性发散
5. **资产化管理**：所有提示词为企业核心数字资产，必须纳入统一的版本、权限、运维管理体系，禁止散落在业务代码、个人文档中

## 首选技术栈规范

严格遵循企业技术栈统一原则，禁止使用未纳入首选清单的工具/框架：

| 开发方向             | 唯一首选技术栈                     | 禁止/不推荐替代方案              |
| -------------------- | ---------------------------------- | -------------------------------- |
| 提示词核心框架       | LangChain.js ChatPromptTemplate    | 硬编码字符串模板、自定义模板封装 |
| 输入输出类型校验     | Zod                                | Yup、Joi、无校验方案             |
| 提示词版本管理       | Git + 语义化版本                   | 在线文档、本地文件、无版本管控   |
| 提示词测试与可观测性 | LangSmith                          | 自定义测试脚本、无测试方案       |
| 提示词安全防护       | Lakera Guard + Zod输出校验         | 无防护方案、自定义过滤规则       |
| 结构化输出           | LangChain.js 结构化输出 + Zod      | 纯文本格式约束、无结构化方案     |
| 提示词编排           | LangGraph.js                       | 线性Chain、自定义流程封装        |
| 环境与配置管理       | Next.js 环境变量 + Vercel 环境隔离 | 硬编码密钥、环境混用             |
| 日志与审计           | Pino + Sentry                      | console.log、无日志方案          |

## 标准化编写规范

企业级提示词必须采用固定的8模块结构，顺序固定，无对应内容需标注「无特殊要求」，禁止省略模块：

1. **角色定位**：必须精准定义模型的身份、专业领域、能力边界，与业务场景强绑定
2. **核心目标**：必须用1-2句话明确唯一核心任务，禁止多目标混杂，明确交付标准
3. **执行规则**：必须分点列出可落地、可校验的执行步骤，明确顺序、判断逻辑、处理规则
4. **输入规范**：必须明确所有输入变量的含义、类型、约束，与Zod Schema、TS类型完全一致
5. **输出规范**：必须明确输出格式、结构、字段要求，与Zod Schema完全一致，明确异常场景格式
6. **约束与禁忌**：必须明确绝对禁止的行为、内容、输出，包含合规、安全、公司规范要求
7. **异常处理规则**：必须明确所有异常场景的标准处理方式，输出固定格式
8. **参考示例（Few-Shot）**：复杂场景必须提供2-3组高质量输入-输出示例，覆盖正常、边界、异常场景

### 编写强制红线

1. 禁止在提示词中硬编码敏感信息，所有敏感信息必须通过环境变量管理
2. 禁止使用模糊、模棱两可、主观化的描述，所有规则必须可落地、可校验、可复现
3. 禁止在系统提示词中允许模型突破约束，禁止出现「除非用户要求」「特殊情况可例外」等表述
4. 禁止无边界的泛化任务，必须明确模型的能力边界，禁止允许模型执行未授权的操作
5. 禁止在提示词中要求模型编造、虚构信息，RAG场景必须明确要求模型仅使用提供的上下文信息
6. 禁止使用纯自然语言约束输出格式，必须配合Zod Schema实现结构化输出强制约束

## 类型安全强制规范

1. 所有提示词的输入变量必须定义TS类型与Zod校验Schema，输入必须先经过Zod校验，校验不通过直接拦截
2. 所有提示词的输出必须定义Zod Schema，强制使用LangChain结构化输出能力约束模型
3. 输出内容必须经过Zod二次校验，校验不通过直接触发异常处理，禁止将不符合格式的内容传入下游
4. Schema定义必须与业务代码复用同一套类型定义，禁止重复定义导致类型不一致
5. 工具调用场景的提示词，必须与Zod定义的工具入参Schema完全一致

## 安全合规核心要求

### 输入层防护
- 所有用户输入必须先经过Zod Schema校验，接入Lakera Guard检测注入攻击、越狱尝试、敏感信息
- 必须对用户输入做角色隔离，严格区分用户输入与系统提示词，禁止用户输入覆盖系统规则

### 模型层防护
- 系统提示词必须加入角色锁定规则，禁止模型泄露、翻译、复述、修改系统提示词
- 必须明确模型的能力边界，禁止模型执行未授权的操作、访问未授权的资源
- 工具调用场景必须严格限制工具权限范围，工具执行前必须经过二次权限校验

### 输出层防护
- 所有模型输出必须经过Zod Schema校验，不符合格式直接拦截
- 必须对输出内容做合规审核、敏感信息过滤，高风险场景输出必须经过人工审核

## 测试验收标准

所有提示词必须通过全流程测试，缺一不可：

| 测试类型    | 验收标准 |
| ----------- | -------- |
| 单元测试    | 格式合规率100%，业务准确率≥95%，异常场景处理覆盖率100%，测试用例通过率100% |
| 集成测试    | 全链路业务流程通过率100%，上下游交互无格式断层、无数据异常 |
| 安全测试    | 注入攻击拦截率100%，敏感信息零泄露，违规内容生成率0，无越权操作风险 |
| 性能测试    | 响应延迟≤2s，token消耗控制在预算，并发场景稳定性100% |
| 灰度A/B测试 | 新版本效果不低于旧版本，异常率更低，无用户投诉，性能成本符合预期 |
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
enterprise-prompt-development-spec

Directory Structure

SKILL.md

Report

Notice
