MCP HubMCP Hub
Вернуться к навыкам

write-standard-operating-procedure

pjt222
Обновлено 2 days ago
4 просмотров
17
2
17
Посмотреть на GitHub
Метаautomationdesign

О программе

Этот навык создает Стандартные операционные процедуры (СОП), соответствующие требованиям GxP, с необходимой нормативной структурой, включая разделы для цели, области применения и процессов утверждения. Он предназначен для таких случаев, как формализация неформальных процессов, устранение замечаний аудита или обновление процедур после изменений в системе. Разработчики могут использовать его для создания или обновления валидированной операционной документации для систем, соответствующих нормативным требованиям.

Быстрая установка

Claude Code

Рекомендуется
Основной
npx skills add pjt222/agent-almanac -a claude-code
Команда плагинаАльтернативный
/plugin add https://github.com/pjt222/agent-almanac
Git клонированиеАльтернативный
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/write-standard-operating-procedure

Скопируйте и вставьте эту команду в Claude Code для установки этого навыка

Документация

Write Standard Operating Procedure

Create a GxP-compliant Standard Operating Procedure that provides clear, auditable instructions for regulated activities.

When to Use

  • A new validated system requires operational procedures
  • Existing procedures need formalisation into SOP format
  • An audit finding cites missing or inadequate procedures
  • A change control triggers SOP updates
  • Periodic review identifies outdated procedural content

Inputs

  • Required: Process or system the SOP covers
  • Required: Regulatory context (GMP, GLP, GCP, 21 CFR Part 11, EU Annex 11)
  • Required: Target audience (roles that will follow this SOP)
  • Optional: Existing informal procedures, work instructions, or training materials
  • Optional: Related SOPs that interface with this procedure
  • Optional: Audit findings or regulatory observations driving the SOP creation

Procedure

Step 1: Assign Document Control Metadata

# Standard Operating Procedure
## Document ID: SOP-[DEPT]-[NNN]
## Title: [Descriptive Title of the Procedure]

| Field | Value |
|-------|-------|
| Document ID | SOP-[DEPT]-[NNN] |
| Version | 1.0 |
| Effective Date | [YYYY-MM-DD] |
| Review Date | [YYYY-MM-DD + review period] |
| Department | [Department name] |
| Author | [Name, Title] |
| Reviewer | [Name, Title] |
| Approver | [Name, Title] |
| Classification | [GxP-Critical / GxP-Supporting] |
| Supersedes | [Previous SOP ID or "N/A — New"] |

Got: Every SOP has a unique ID following the organisation's document numbering convention. If fail: If no numbering convention exists, establish one before proceeding: [TYPE]-[DEPT]-[3-digit sequential].

Step 2: Write the Purpose and Scope

### 1. Purpose
This SOP defines the procedure for [specific activity] to ensure [regulatory objective].

### 2. Scope
**In scope:**
- [System, process, or activity covered]
- [Applicable departments or roles]
- [Specific regulatory requirements addressed]

**Out of scope:**
- [Related activities covered by other SOPs — reference them]
- [Systems or departments not covered]

Got: Purpose is one to two sentences. Scope clearly defines boundaries. If fail: If scope overlaps with an existing SOP, either reference the existing SOP for the overlapping section or revise both SOPs to eliminate the overlap.

Step 3: Define Terms and Abbreviations

### 3. Definitions and Abbreviations

| Term | Definition |
|------|-----------|
| ALCOA+ | Attributable, Legible, Contemporaneous, Original, Accurate + Complete, Consistent, Enduring, Available |
| CCB | Change Control Board |
| GxP | Good [Manufacturing/Laboratory/Clinical] Practice — umbrella for all regulated quality standards |
| SOP | Standard Operating Procedure |
| [Add terms specific to this SOP] | [Definition] |

Got: Every abbreviation and technical term used in the SOP is defined. If fail: If a term is ambiguous or domain-specific, consult the organisation's glossary or the relevant regulatory guidance for the authoritative definition.

Step 4: Assign Responsibilities

### 4. Responsibilities

| Role | Responsibilities |
|------|-----------------|
| System Owner | Ensure SOP compliance, approve changes, conduct periodic review |
| System Administrator | Execute daily operations per this SOP, report deviations |
| Quality Assurance | Review SOP for regulatory compliance, approve new versions |
| End Users | Follow procedures as written, report issues to system administrator |
| Training Coordinator | Ensure all affected personnel are trained before SOP effective date |

Got: Every action in the Procedure section can be traced to a responsible role. If fail: If a procedural step has no assigned role, it is an orphaned responsibility. Assign an owner before the SOP is approved.

Step 5: Write the Procedure Section

This is the core of the SOP. Write step-by-step instructions:

### 5. Procedure

#### 5.1 [First Major Activity]
1. [Action verb] [specific instruction]. Reference: [form, system screen, tool].
2. [Action verb] [specific instruction].
   - If [condition], then [action].
   - If [alternative condition], then [alternative action].
3. [Action verb] [specific instruction].
4. Record the result in [form/system/log].

#### 5.2 [Second Major Activity]
1. [Action verb] [specific instruction].
2. Verify [specific criterion].
3. If verification fails, initiate [deviation procedure — reference SOP-XXX].

#### 5.3 Deviation Handling
1. If any step cannot be performed as written, STOP and document the deviation.
2. Notify [role] within [timeframe].
3. Complete Deviation Form [form reference].
4. Do not proceed until [role] provides disposition.

Writing rules for GxP SOPs:

  • Start each step with an action verb (verify, record, enter, approve, notify)
  • Be specific enough to be followed by a trained operator without interpretation
  • Include decision points with clear criteria for each path
  • Reference exact form names, system screens, or tool identifiers
  • Include hold points where work must stop pending approval or verification

Got: A trained person unfamiliar with the specific process could follow these steps correctly. If fail: If subject matter experts say the procedure is ambiguous, add detail or break the step into sub-steps. Ambiguity in SOPs is a recurring audit finding.

Step 6: Add References, Attachments, and Revision History

### 6. References
| Document ID | Title |
|-------------|-------|
| SOP-QA-001 | Document Control |
| SOP-IT-015 | User Access Management |
| [Regulation reference] | [e.g., 21 CFR Part 11] |

### 7. Attachments
| Attachment | Description |
|-----------|-------------|
| Form-001 | [Form name and purpose] |
| Template-001 | [Template name and purpose] |

### 8. Revision History
| Version | Date | Author | Change Description |
|---------|------|--------|--------------------|
| 1.0 | [Date] | [Name] | Initial release |

Got: All referenced documents are accessible to users, and revision history starts from version 1.0. If fail: If referenced documents do not exist yet, either create them or remove the reference and note the gap in the SOP review.

Step 7: Route for Review and Approval

### Approval Signatures

| Role | Name | Signature | Date |
|------|------|-----------|------|
| Author | [Name] | | |
| Technical Reviewer | [Name] | | |
| QA Reviewer | [Name] | | |
| Approver (Department Head) | [Name] | | |

### Training Requirement
All personnel listed in Section 4 must complete training on this SOP before the effective date. Training must be documented in the training management system.

### Periodic Review
This SOP must be reviewed at least every [2 years / annually] or when triggered by:
- Change control affecting the covered process or system
- Audit finding related to the covered process
- Regulatory guidance update affecting the covered requirements

Got: SOP is reviewed by a subject matter expert and approved by quality before becoming effective. If fail: If the approval workflow is delayed, the effective date must be pushed back. An SOP cannot be effective without completed approvals.

Validation

  • Document ID follows the organisation's numbering convention
  • Purpose is specific and concise (1-2 sentences)
  • Scope clearly defines in-scope and out-of-scope boundaries
  • All abbreviations and technical terms are defined
  • Every role in the Responsibilities section maps to procedure steps
  • Procedure steps start with action verbs and are specific enough to follow without interpretation
  • Decision points have clear criteria for each path
  • Deviation handling is defined
  • All referenced documents exist and are accessible
  • Revision history is complete from version 1.0
  • Approval signatures include author, reviewer, and approver
  • Periodic review schedule is defined

Pitfalls

  • Too vague: "Ensure data quality" is not a procedural step. "Verify that all 15 fields in Form-001 are populated and within range per Appendix A" is.
  • Too detailed: Including troubleshooting for every possible error makes the SOP unreadable. Reference a separate work instruction for complex troubleshooting.
  • No deviation handling: Every SOP must define what to do when the procedure cannot be followed as written. Silence on deviations implies no deviations are possible.
  • Effective before training: An SOP that is effective before all users are trained creates an immediate compliance gap.
  • Orphaned SOPs: SOPs that are never reviewed become outdated and unreliable. Set review dates and track them in the document control system.

Related Skills

  • design-compliance-architecture — identifies which systems and processes need SOPs
  • manage-change-control — triggers SOP updates when processes change
  • design-training-program — ensures users are trained on new and updated SOPs
  • conduct-gxp-audit — audits assess SOP adequacy and adherence
  • write-validation-documentation — SOPs and validation docs share approval workflows

GitHub репозиторий

pjt222/agent-almanac
Путь: i18n/caveman-lite/skills/write-standard-operating-procedure
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Похожие навыки

content-collections

Мета

Этот навык предоставляет проверенную в продакшене настройку для Content Collections — TypeScript-ориентированного инструмента, который преобразует файлы Markdown/MDX в типобезопасные коллекции данных с валидацией Zod. Используйте его при создании блогов, сайтов документации или контентных приложений на Vite + React для обеспечения типобезопасности и автоматической проверки содержимого. Он охватывает всё: от настройки плагина Vite и компиляции MDX до оптимизации развертывания и валидации схем.

Просмотреть навык

polymarket

Мета

Этот навык позволяет разработчикам создавать приложения на платформе прогнозных рынков Polymarket, включая интеграцию с API для торговли и получения рыночных данных. Он также обеспечивает потоковую передачу данных в реальном времени через WebSocket для отслеживания текущих сделок и рыночной активности. Используйте его для реализации торговых стратегий или создания инструментов, обрабатывающих обновления рынка в реальном времени.

Просмотреть навык

creating-opencode-plugins

Мета

Этот навык помогает разработчикам создавать плагины OpenCode, которые подключаются к более чем 25 типам событий, таким как команды, файлы и операции LSP. Он предоставляет структуру плагина, спецификации API событий и шаблоны реализации для модулей на JavaScript/TypeScript. Используйте его, когда вам нужно перехватывать, отслеживать или расширять жизненный цикл ассистента OpenCode AI с помощью пользовательской событийно-ориентированной логики.

Просмотреть навык

sglang

Мета

SGLang — это высокопроизводительный фреймворк для обслуживания больших языковых моделей (LLM), специализирующийся на быстрой структурированной генерации JSON, regex и рабочих процессов агентов с использованием кэширования префиксов RadixAttention. Он обеспечивает значительно более высокую скорость вывода, особенно для задач с повторяющимися префиксами, что делает его идеальным для сложных структурированных результатов и многократных диалогов. Выбирайте SGLang вместо альтернатив, таких как vLLM, когда вам требуется ограниченное декодирование или вы создаете приложения с интенсивным совместным использованием префиксов.

Просмотреть навык