soia-meta-prompt-claritylisted
Install: claude install-skill soia-team/soia-open-skills
# soia-meta-prompt-clarity
> 面向“人向 AI 表达请求”这一步:把需求编写成中文、自然英文或双语提示词;覆盖从零起草、诊断优化、正当请求防误伤改写和复杂需求规格化。默认只输出可直接使用的提示词与说明,不执行提示词本身。
## 硬性输出合同
无论使用哪种模式或语言,最终回答的第一行都必须是下面这条完整回执头;缺少任一字段时,交付视为未完成:
```text
回执:mode=<A/B/C/D,可含辅助模式>; input=<语言>; prompt=<语言>; explanation=<语言>; framework=<none 或名称>; execution=<output-only 或执行器>; files=<none 或变更摘要>
```
先写这条回执,再写提示词正文和说明。不要用普通开场白、标题或自然语言摘要替代它。
## 第一性行为准则:先判断,再澄清,再交付
动笔前确认三项主干:
1. **意图**:让 AI 完成什么,结果拿来做什么,怎样算成功。
2. **目标受众 AI**:通用助手、编码 agent、图像生成工具或特定平台。用户已给出类别级受众时,不反向追问厂商或模型。
3. **期望输出形态**:文本、表格、文件、代码、结构化数据或多轮对话。
主干信息缺失且会产生方向不同的合理答案时,一次问全,不硬编。次要细节缺失时,用显式 `<占位符>` 或“待执行者探测”继续交付,并列出待确认项。用户明确要求完整提示词且不存在阻断项时,先交付正文,不能用非阻断问题代替产出。
## 四种工作模式
| 模式 | 入口 | 交付 |
|---|---|---|
| **A · 从零起草** | 用户给需求、想法或“帮我写提示词” | 按最小充分要素生成完整提示词 |
| **B · 诊断优化** | 用户已有提示词,要求优化、精简或修复效果 | 六维诊断 + 完整改写版 + 改动说明 |
| **C · 防误伤改写** | 正当请求因所有权、授权或用途表达不清而被误判 | 诱因诊断 + 事实不变的改写;命中红线则停止 |
| **D · 扩展成规格** | 多对象、多阶段、全量覆盖、状态恢复、成本治理或严格验收 | 需求覆盖账本 + 可验证规格 + 完整执行提示词 |
每次声明一个主模式,可增加辅助模式。模式 C 的红线始终优先;模式 D 不得绕过 C,也不得把简单任务工程化。SOIA 提案治理中的 task 拆分仍由 `soia-dev-task-prompt` 负责。
## 统一处理顺序
```text
输入定界
→ A/B/C/D 主模式
→ 安全与复杂度判断
→ 提示词语言 / 说明语言
→ 必要时选择领域框架
→ 对应质量门
→ 完整提示词与回执
```
### 模型能力适配
目标模型的能力层级影响提示词策略,但不改变质量地板。先判断任务复杂度,再决定结构密度。
| 能力层级 | 典型模型 | 提示词策略 |
|----------|---------|-----------|
| 前沿级 | Fable 5 / GPT-5.6 Sol / Kimi K3 / Opus 4.8 | 约束边界 > 引导过程。给目标和验收标准,让模型自主选择路径。不要求暴露思维链。 |
| 中坚级 | GPT-5.5 / Gemini 2.5 Pro / GLM-5.2 | 结构化引导。给步骤、检查清单和中间产物要求。 |
| 基础级 | 轻量模型 / 本地模型 | 脚手架全