sop-refiner

What This Skill Does

The sop-refiner is a specialized OpenClaw AI agent skill designed to act as a professional 'SOP Polisher.' Its primary objective is to transform existing, often cluttered or incomplete Standard Operating Procedures into highly robust, executable, and safe workflows. It focuses on four critical pillars of process optimization: removing redundancy, filling in missing exception paths, defining clear rollback strategies, and implementing strict quality gates. By strictly adhering to predefined compliance specifications, it ensures that your internal workflows remain both efficient for new team members and resilient against operational failure.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/52yuanchangxing/sop-refiner

Ensure that your local directory contains the required resources, specifically the specification schema in {baseDir}/resources/spec.json and the output template in {baseDir}/resources/template.md, to allow the skill to format outputs correctly.

Use Cases

1. Onboarding Efficiency: Simplifying complex internal documentation to reduce cognitive load for new employees.
2. Resilience Engineering: Identifying "happy path" biases in SOPs and explicitly defining "what-if" scenarios, such as system outages or data corruption during a process.
3. Compliance Audits: Using the quality gate requirement to force the inclusion of approval steps and verification checkpoints, ensuring organizational standards are met.
4. Recovery Planning: Drafting detailed rollback procedures that allow users to revert to a 'last known good' state if a process execution fails.

Example Prompts

1. "I have an existing SOP for server deployment, but our junior engineers keep running into permission errors. Can you review this draft and add an exception handling section?"
2. "Here is our current document for database migration. It feels too long and redundant. Please identify areas to cut and suggest a new structure that includes quality gates before the final commit."
3. "Our customer refund process lacks a clear recovery plan. Please review the attached draft and suggest a rollback protocol that ensures data integrity if the API call fails."

Tips & Limitations

• Safety First: The sop-refiner is designed to be conservative. It will never alter organizational hierarchies or bypass security protocols. When suggesting changes to processes involving external systems, it always defaults to 'dry-run' recommendations rather than direct execution.
• Clarity over Assumptions: If your input text is incomplete, the agent is instructed to produce a '待确认项' (Items to Clarify) list rather than hallucinating details. Please review these questions to get the most accurate output.
• Human-in-the-loop: Always treat the agent's output as a 'reviewable draft.' While the agent is excellent at identifying logical gaps, complex organizational decisions should always be verified by an authorized subject matter expert before final adoption.