← Back to Skills Marketplace
Escalation Brief Writer
by
vx：17605205782
· GitHub ↗
· v1.0.0
· MIT-0
173
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install escalation-brief-writer
Description
把复杂问题整理成升级说明，减少来回追问，突出背景、影响、已尝试和诉求。；use for escalation, support, brief workflows；do not use for 省略关键信息, 把个人情绪写成事实.
README (SKILL.md)
升级说明撰写器
你是什么
你是“升级说明撰写器”这个独立 Skill，负责：把复杂问题整理成升级说明，减少来回追问，突出背景、影响、已尝试和诉求。
Routing
适合使用的情况
- 帮我写一份升级说明
- 减少来回追问
- 输入通常包含：问题背景、影响、已做尝试、诉求
- 优先产出：背景、影响、附加证据
不适合使用的情况
- 不要省略关键信息
- 不要把个人情绪写成事实
- 如果用户想直接执行外部系统写入、发送、删除、发布、变更配置，先明确边界，再只给审阅版内容或 dry-run 方案。
工作规则
- 先把用户提供的信息重组成任务书，再输出结构化结果。
- 缺信息时，优先显式列出“待确认项”，而不是直接编造。
- 默认先给“可审阅草案”，再给“可执行清单”。
- 遇到高风险、隐私、权限或合规问题，必须加上边界说明。
- 如运行环境允许 shell / exec，可使用：
python3 "{baseDir}/scripts/run.py" --input \x3C输入文件> --output \x3C输出文件>
- 如当前环境不能执行脚本，仍要基于
{baseDir}/resources/template.md与{baseDir}/resources/spec.json的结构直接产出文本。
标准输出结构
请尽量按以下结构组织结果：
- 背景
- 影响
- 已尝试
- 当前阻塞
- 需要支持
- 附加证据
本地资源
- 规范文件：
{baseDir}/resources/spec.json - 输出模板：
{baseDir}/resources/template.md - 示例输入输出：
{baseDir}/examples/ - 冒烟测试：
{baseDir}/tests/smoke-test.md
安全边界
- 强调事实、影响和诉求分离。
- 默认只读、可审计、可回滚。
- 不执行高风险命令，不隐藏依赖，不伪造事实或结果。
Usage Guidance
This skill appears coherent and low-risk: it reads local input files (or uses the template) and outputs structured escalation briefs. Before running, review any sensitive inputs you will pass (remove or redact PII/credentials), and inspect scripts/run.py if you want assurance it will only read/process the files you expect. The script does not perform network calls or require secrets, but it will read any path you give it — avoid pointing it at directories containing unrelated confidential data. If you enable actual execution inside an automated agent flow, ensure the agent is allowed only to call the script with vetted inputs.
Capability Analysis
Type: OpenClaw Skill
Name: escalation-brief-writer
Version: 1.0.0
The skill bundle is a utility designed to help users draft structured escalation briefs and perform basic file audits. The Python script (scripts/run.py) includes functionality to scan for sensitive patterns such as hardcoded secrets, 'curl|bash' commands, and dangerous 'rm' flags, but it does so for reporting/auditing purposes only and does not execute any discovered payloads. The SKILL.md instructions provide clear safety boundaries for the AI agent, emphasizing factual reporting and prohibiting the execution of high-risk commands.
Capability Assessment
Purpose & Capability
Name/description (escalation brief writer) align with files and code: resources/template.json, spec.json and scripts/run.py produce structured markdown briefs and lightweight audits. Required binary (python3) is appropriate and proportional.
Instruction Scope
SKILL.md confines behavior to reading local inputs, producing a reviewable draft or dry-run, and explicitly forbids executing high-risk commands or performing external writes without explicit boundaries. It suggests invoking scripts in-place or falling back to template-based output when execution isn't allowed.
Install Mechanism
No install spec; script is instruction-only plus a local Python script. No downloads, no external package installs, and the repo claims only Python standard library. This is low-risk.
Credentials
The skill requests no environment variables, credentials, or config paths. The script scans and reads files you supply; that file I/O is expected for a brief/ audit tool.
Persistence & Privilege
always is false, the skill is user-invocable and does not request persistent elevated privileges or modify other skills. Running the included script may write the specified output file but does not alter system or other skill configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install escalation-brief-writer - After installation, invoke the skill by name or use
/escalation-brief-writer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
escalation-brief-writer 1.0.0 – Initial release
- New skill to help structure complex issues into escalation briefs, emphasizing background, impact, actions tried, and specific requests.
- Reduces unnecessary follow-up by prompting for all key information and highlighting missing details without inventing facts.
- Outputs reviewable drafts and actionable checklists, with explicit boundaries for risk, privacy, and compliance.
- Includes standardized output structure and templates for consistency.
- Designed for support, escalation, and incident brief workflows; safeguards against omitting crucial information or conflating emotion with facts.
Metadata
Frequently Asked Questions
What is Escalation Brief Writer?
把复杂问题整理成升级说明，减少来回追问，突出背景、影响、已尝试和诉求。；use for escalation, support, brief workflows；do not use for 省略关键信息, 把个人情绪写成事实. It is an AI Agent Skill for Claude Code / OpenClaw, with 173 downloads so far.
How do I install Escalation Brief Writer?
Run "/install escalation-brief-writer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Escalation Brief Writer free?
Yes, Escalation Brief Writer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Escalation Brief Writer support?
Escalation Brief Writer is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).
Who created Escalation Brief Writer?
It is built and maintained by vx：17605205782 (@52yuanchangxing); the current version is v1.0.0.
More Skills