AI Input Compiler — 把模糊输入编译成可直接复制的高质量 Prompt
你花了几百块订阅 AI，却还在用搜索引擎级别的提问方式。
SharpInput 是一个兼容 Hermes Agent 和 Codex 的 skill：它不直接替你回答问题，而是先把模糊输入、提问、想法、方案或需求编译成更清楚、更有约束、更不容易得到废话回答的 Prompt。
你原来这样问：
我们的转化率一直在下降，怎么办？
SharpInput 会把它升级成：
我们是 toB SaaS，注册→付费转化率从 8% 降到 3%，持续 3 个月。流量来源没有明显变化，产品近三个月没有大改。请区分已知事实、关键假设和缺失证据，对产品、市场、销售三个方向的根因按优先级排序。明确推荐第一个排查方向，说明依据、暂时放弃了什么，以及什么新证据会推翻这个排序。最后设计一个 30 天内可验证的低成本实验。
差别不是“文案更漂亮”，而是：目标、背景、约束、判断标准、输出格式和压力测试都被补齐了。
- 经常觉得 AI 回答“看似全面，其实没用”的人
- 产品经理、开发者、创业者、内容创作者
- 想让 AI 给出判断、方案、分析、评审，而不是安全废话的人
- Hermes Agent、Codex 用户，或正在组织个人 AI Agent skill 工作流的人
不适合：
- 你想让 AI 直接执行任务，而不是优化输入
- 你只需要事实查询、代码执行、文件修改
详细安装见 INSTALL.md。
git clone https://github.com/gaoyechen/SharpInput.git
mkdir -p "$LOCALAPPDATA/hermes/skills/sharpinput"
cp SharpInput/SKILL.md SharpInput/AGENT.md "$LOCALAPPDATA/hermes/skills/sharpinput/"
cp -R SharpInput/agents SharpInput/modules SharpInput/references "$LOCALAPPDATA/hermes/skills/sharpinput/"然后在 Hermes 中运行：
/reload-skills
装完对 Agent 说：
帮我优化：我想让 AI 帮我做一件什么事，应该怎么提问？
SharpInput 会自动接管，识别意图、检测场景、补全上下文，输出一个可直接复制的升级版 Prompt。
验证：
hermes chat --skills sharpinput -q "帮我优化：为什么我的 GitHub skill 没有 star？" -QWindows 用户：
$LOCALAPPDATA/hermes/skills/sharpinput通常对应C:\Users\<用户名>\AppData\Local\hermes\skills\sharpinput。
说这些话时，SharpInput 应该接管：
帮我优化这个问题
这样问 AI 行不行？
帮我润色一下这个 prompt
帮我理清这个需求，变成好问题
我想让 AI 帮我做 X，应该怎么提问？
控制深度：
简单优化 → Level 1，轻度改写，少问问题
施压一下 → Level 2，增加约束、判断标准、反废话机制
深度模式 → Level 3，适合高风险决策、方案评审、多路径比较
命令：
hermes chat --skills sharpinput -q "帮我优化：为什么我的 GitHub skill 没有 star？请输出一个可以直接复制给 AI 的提问。" -Q输出节选：
[升级版问题]
> 你是一名熟悉 GitHub 开源项目增长、开发者工具传播、AI Agent/Skill 生态的产品顾问。
>
> 请帮我严厉分析：为什么我这个 GitHub 上的 skill/项目没有 star？
> ...
> 不要默认“没人 star = 项目不好”，也不要默认“多宣传就行”。
这就是 SharpInput 的核心价值：不是替你回答，而是先把“弱问题”变成一个值得被认真回答的问题。
用户弱输入
↓
触发判断
↓
意图识别 → 场景检测 → 上下文补全 → 压力策略选择
↓
Prompt 编译 → Judge（仅 Level 3）→ 质量检查
↓
复制即用的升级版 Prompt
核心能力：
| 能力 | 作用 |
|---|---|
| 意图识别 | 判断用户到底是在求解释、决策、对比、规划、验证还是表达 |
| 场景检测 | 针对电脑选购、AI 订阅、PRD、UI 评审、学习备考等场景补关键槽位 |
| 上下文补全 | 只问真正影响输出质量的问题，避免泛泛追问“背景是什么” |
| Prompt 编译 | 按任务需要选择目标、约束、判断标准、依据和输出格式，避免模板堆砌 |
| 默认答案压力测试 | 防止 AI 输出“看情况”“各有优劣”“建议综合考虑”式废话 |
| Judge 审查 | Level 3 下对高风险决策和方案评审做更严格的质量检查 |
SharpInput 不会做的事：
- 不会直接回答你的底层任务（只输出升级版 prompt）
- 不会发送外部网络请求
- 不会在没有你确认时猜测场景特定事实（预算、受众、平台）
- 未经明确同意不会读取或写入持久化偏好；启用后也只写用户本地状态（见 PRIVACY.md）
- Level 3 只在多路径确实有价值时呈现多条路径
什么时候 SharpInput 会停下来问你：
- 你的意图混合了"优化输入"和"直接回答"
- 关键上下文缺失（预算、受众、约束），用 placeholder 会影响质量
- 存在会显著改变结果的低置信度歧义时，会请你确认意图
SharpInput/
├── SKILL.md # 核心运行契约
├── AGENT.md # 核心契约的详细编排说明
├── agents/openai.yaml # Codex UI 元数据
├── modules/ # 内部能力模块，不会被 Hermes 识别成独立 skills
│ ├── intent-detection.md
│ ├── scenario-detection.md
│ ├── scenario-slot-elicitation.md
│ ├── context-completion.md
│ ├── description-clarifier.md
│ ├── prompt-compiler.md
│ ├── pressure-strategy.md
│ ├── judge-review.md
│ └── output-renderer.md
├── references/ # taxonomy、rubric、模板和隐私安全的示例状态文件
├── examples/ # 示例输入和预期路线
├── tests/ # 回归用例和质量评分标准
├── scripts/ # demo 录制脚本和验证工具
├── INSTALL.md # 安装、升级、卸载和排障
└── PRIVACY.md # 本地状态和隐私说明
设计原则：SKILL 定义唯一契约，AGENT 展开流程，modules 实现能力。 内部模块不作为独立 skill 安装。
SharpInput 不应该把真实用户偏好写进仓库或 skill 包内部。
仓库只提供：
references/user-preferences.schema.json
references/user-preferences.example.json
只有用户明确启用持久化偏好后，真实偏好才存储在用户本地 profile 数据目录，例如：
$HERMES_HOME/data/sharpinput/user-preferences.json
详细说明见 PRIVACY.md。
修改 SKILL.md、AGENT.md、modules/ 或 references/ 后，先运行：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/validate-skill.ps1在 macOS/Linux 且已安装 PowerShell 时使用 pwsh -File scripts/validate-skill.ps1。
再检查：
tests/regression-cases.md
references/quality-rubric.md
关键标准：
- 只在“优化输入/Prompt”场景触发
- 不直接回答底层任务
- 输出必须包含一个完整、可复制的升级版 Prompt
- Level 2 只追问会反转或误导下游判断的关键上下文
- 不应该强行反共识或过度施压
- 统一状态机：场景检测和上下文补全先于压力选择，压力选择先于 Prompt 编译
- 将
clarify_first改为临时状态，统一 Level 2 追问与占位符规则 - 统一 Judge JSON 协议和质量阈值
- 删除强制展示推理过程、强制角色和 Level 1+ 全量结构模板
- 输出改为 Prompt 优先、按 Level 递增信息密度
- 持久化偏好改为显式 opt-in
- 新增 Codex
agents/openai.yaml和静态验证脚本
- Darwin 9 维评估优化（6.73 → 7.56，+0.83）
- dim4 检查点：插入 3 个显性标记（混合意图/Level 3/质量门）
- dim8 路由一致性：Level 2 上下文不足不再降级为 Clarify First
- dim9 反例：新增 DON'T 节（10 条反例覆盖输出风格/格式/路由）
- Luban 鲁班打磨：结构清理 + showcase 升级
- SKILL.md/AGENT.md 重叠率从 ~40% 降至 ~5%
- modules/*.md frontmatter 修复（防止被识别为独立 skill）
- README 增加安全边界、致谢、装完第一句话
- 新增 scripts/ 目录（demo 录制脚本 + vhs tape）
- 将内部能力文件从
skills/*/SKILL.md移到modules/*.md，避免被 Hermes 识别成多个独立 skills - 主 skill canonical name 改为
sharpinput - 移除仓库中的真实
user-preferences.json，改为 schema/example - 补充安装、隐私和真实运行说明
- README 中的版本、模块数和结构说明与实际仓库对齐
- 从单体 prompt 重构为 Agent + 模块化能力文件
- 新增意图识别、场景模板、上下文补全、压力策略、Judge 审查和回归用例
- Prompt engineering best practices：受 Anthropic、OpenAI 的 prompt 工程指南启发，但 SharpInput 的核心创新是"自动编译"而非"手动优化"
- DSPy / PromptWizard：自动 prompt 优化的研究方向提供了理论基础；SharpInput 选择了 agent-native 形态而非框架形态
- prompt-optimizer（30K⭐）：验证了"prompt 优化"品类的真实需求
- Hermes Agent：提供了 skill 系统、触发路由和 handoff 机制的运行时基础
MIT —— 随便用，随便改。
如果你受够了 AI 给你灌水，先别急着换模型，先把问题问锋利。