把技术 PR、架构变更、事故报告、成本优化和安全/合规变更翻译成老板看得懂的决策简报。
🌐 中文 · English
exec-translate 是一个 Agent Skill，用来把工程细节翻译成管理层真正需要的决策语言：影响、风险、成本、紧急程度、兜底方案，以及到底该批准、延后、拒绝、升级，还是先补信息。
它适合那种“技术内容是准确的，但老板看完仍然不知道要不要拍板”的场景。 它不是摘要器，而是把材料整理成可以拍板的判断：建议动作、置信度、red flags 和会改变决策的缺失信息。
技术材料常常这样写：
重构 checkout 库存校验逻辑，改为使用缓存库存快照。
老板真正需要的是：
如果业务能接受最多 45 秒的库存滞后，可以批准灰度。这个改动预计降低结账延迟，但存在轻微超卖风险；已有 feature flag 可以回滚。
exec-translate 会保留技术事实，去掉不影响决策的实现细节，并明确标出未知信息，不会编造指标、损失或 ROI。
输入来自 examples/incident-report.md：10:04-10:21 登录对部分用户失败，回滚后恢复；根因仍在验证，影响用户数和客户投诉未知，复发预防没有 owner。
exec-translate 不会停在“已经回滚”，而是把老板真正要处理的事提出来：
| Item | Readout |
| --- | --- |
| Recommended action | Escalate |
| Urgency | Today |
| Confidence | Low |
| Decision red flags | 影响范围未知、根因未验证、复发预防无 owner |更多输出示例可以直接查看：Markdown 简报 · HTML 简报 · PPT 大纲。
- 支持 PR、代码变更、架构方案、发布说明、事故报告、成本优化、安全/合规和复盘材料。
- 输出业务影响、风险兜底、成本收益、紧急程度、审批建议和缺失信息。
- 固定区分
Confirmed、Inferred、Unknown，让简报可追溯、可审计。 - 支持 CEO、CTO、CFO、产品、客服、法务/合规等不同领导视角。
- 内置决策动词、置信度规则和 red flag 检测，避免“看起来像汇报、实际不能拍板”。
- 支持聊天/邮件短版、领导可读性检查、精致 standalone HTML 简报、PPT-ready 汇报结构。
- 内置 HTML 模板和 PPT 汇报模式，方便直接产出可展示的老板版材料。
- 可以和
ppt-master配合生成实际 PPTX，但本 Skill 不内置 PPT 引擎。 - 使用时只需自然语言触发，不需要额外 CLI、API key 或服务端。
exec-translate 遵循开放的 Agent Skills 格式，可运行在兼容 skills 的 AI agent runtime 中。
打开你正在使用的 agent，比如 Codex、Claude Code、Cursor、OpenClaw、Gemini CLI 或其他兼容 runtime，告诉它：
帮我安装这个 skill: https://github.com/luanluan1/exec-translate
英文也可以：
Install this skill: https://github.com/luanluan1/exec-translate
使用开放的 skills 安装器：
npx skills add luanluan1/exec-translate安装器会自动识别当前 agent runtime。需要显式指定时：
npx skills add luanluan1/exec-translate --skill exec-translate --agent codex其他 agent 名称可能包括 claude-code、cursor，或你的 skills CLI 支持的 runtime。
如果你的 runtime 暂不支持自动安装 Agent Skill，可以直接把 skills/exec-translate/SKILL.md 的内容复制到对话上下文里。它本质上是一份带 YAML frontmatter 的 Markdown 指令。
自然语言调用即可：
用 exec-translate 把这个 PR 翻译成老板能看懂的版本。
把这个事故报告整理成管理层版本。
用 exec-translate 把 examples/incident-report.md 整理成管理层版本。
用 exec-translate 生成一份领导汇报 PPT 大纲。
也可以英文触发：
Use exec-translate to translate this PR for my boss.
默认输出是老板能快速扫读的决策简报：
# Executive Decision Brief
> 一句话结论：发生了什么，为什么重要，老板现在该做什么。
## Decision Snapshot
## Facts and Uncertainty
## What Happened
## Why It Matters
## Risk and Fallback
## Decision Red Flags
## Cost / Benefit / Cost of Doing Nothing
## What Leadership Should Do
## Missing Decision-Critical Information示例决策块：
## Decision Snapshot
| Item | Readout |
| --- | --- |
| Recommended action | Request more information |
| Urgency | This week |
| Confidence | Medium |
| Leadership involvement | Needs awareness now; decision only if SLA/customer impact is confirmed |
| Audience lens | Mixed leadership |
| Decision type | Request more information |
| Primary risk | The service has recovered, but recurrence prevention is not yet owned |
## Facts and Uncertainty
- Confirmed: 回滚已完成，错误率恢复正常。
- Inferred: 17 分钟登录故障期间大概率存在用户影响。
- Unknown: 受影响用户数、客户工单、SLA 风险、复发预防负责人。
## Decision Red Flags
- 复发预防负责人未明确。exec-translate 可以直接生成 standalone HTML 管理层简报：
用 exec-translate 把这个事故报告生成一个单页 HTML 老板简报。
exec-translate 可以直接生成 PPT-ready 的管理层汇报大纲：
用 exec-translate 把这个架构变更整理成领导汇报 PPT 大纲。
exec-translate 可以参与 PPT 生成，但不内置 PPT 引擎。
如果你明确要求生成实际 PPT、PPTX、deck 或 presentation 文件，兼容的 agent 可以先用 exec-translate 生成老板决策内容，再把结构化大纲交给已安装的 ppt-master。
用 exec-translate 把这个事故报告做成老板能看懂的 PPTX。
如果有 ppt-master，就生成 deck。
skills/
exec-translate/
SKILL.md
agents/
openai.yaml
references/
decision-framework.md
html-templates.md
output-formats.md
presentation-patterns.md
ppt-handoff.md
examples.md
examples/
pr-change.md
incident-report.md
architecture-change.md
cost-optimization.md
security-compliance.md
incomplete-input.md
readiness-review.md
ppt-outline-request.md
html-brief-request.md
pptx-request.md
output/
incident-brief.md
incident-brief.html
ppt-outline.md
executive-brief-preview.svg
查看 examples/ 获取 PR、事故、架构变更、成本优化、安全/合规、不完整输入、领导可读性检查、HTML、PPT 大纲和 PPTX handoff 示例。
输出预览：
- 把技术实现翻译成业务后果。
- 能给建议就明确给建议。
- 不确定就标出来，不藏在漂亮话里。
- 只追问会改变决策的信息。
- 不编造 ROI、损失、SLA 影响、客户数、根因、负责人、日期或保证。
MIT