skill-name

技能名称

概述

简要介绍此技能提供的功能及其安全运维背景。

快速开始

提供一个可立即上手的最简示例：

# Example command or workflow
tool-name --option value

核心工作流

顺序工作流

适用于简单的分步操作：

1. 第一步操作，包含具体命令或操作
2. 第二步操作，包含预期输出或验证方式
3. 第三步操作，如有需要，列出决策点

工作流检查清单（适用于复杂操作）

对于复杂的多步骤操作，请使用可勾选的工作流：

进度： [ ] 1. 初始设置和配置 [ ] 2. 运行主要安全扫描或分析 [ ] 3. 审查发现并按严重程度分类 [ ] 4. 应用修复模式 [ ] 5. 通过重新扫描验证修复 [ ] 6. 记录发现并生成报告

按步骤系统地完成操作。完成后勾选相应项目。

更多工作流模式请参阅 references/WORKFLOW_CHECKLIST.md

反馈循环模式（用于验证）

需要验证和迭代时：

1. 生成初始输出（配置、代码等）
2. 运行验证：./scripts/validator_example.py output.yaml
3. 查看验证错误和警告
4. 修复已发现的问题
5. 重复步骤 2–4，直到验证通过
6. 应用经过验证的输出

注意：如果验证标准较复杂，请将详细内容移至 references/。

安全注意事项

• 敏感数据处理：有关密钥、凭据和个人身份信息（PII）的处理指南
• 访问控制：所需权限和授权上下文
• 审计日志：安全审计应记录的内容
• 合规性：相关合规要求（SOC2、GDPR 等）

随附资源

脚本（scripts/）

用于确定性操作的可执行脚本。对于需要保持一致性的低自由度操作，请使用脚本。

• example_script.py - Python 脚本模板，包含 argparse、错误处理和 JSON 输出
• example_script.sh - Bash 脚本模板，包含参数解析和彩色输出
• validator_example.py - 演示反馈循环模式的验证脚本

适用脚本的场景：

• 必须保持一致的确定性操作
• 复杂的解析或数据转换
• 验证和质量检查

参考资料（references/）

按需加载的文档。将详细内容移至此处，以保持 SKILL.md 简洁。

• EXAMPLE.md - 参考文档模板，包含安全标准章节
• WORKFLOW_CHECKLIST.md - 多种工作流模式示例（顺序、条件、迭代、反馈循环）

适用参考资料的场景：

• 详细的框架映射（OWASP、CWE、MITRE ATT&CK）
• 高级配置选项
• 特定语言的模式
• 内容超过 100 行

资源文件（assets/）

用于输出的模板和配置文件（不会加载到上下文中）。这些文件会被引用，但只有在需要时才会读取。

• ci-config-template.yml - 增强安全性的 CI/CD 流水线，包含 SAST、依赖项扫描和密钥检测
• rule-template.yaml - 安全规则模板，包含 OWASP/CWE 映射和修复指导

适用资源文件的场景：

• 配置模板
• 策略模板
• 安全代码样板
• CI/CD 流水线示例

常见模式

模式 1：[模式名称]

常见用法模式的说明和示例。

模式 2：[模式名称]

按需添加更多模式。

集成点

• CI/CD：与构建流水线的集成方式
• 安全工具：兼容的安全扫描/监控工具
• SDLC：在安全开发生命周期中的适用环节

故障排除

问题：[常见问题]

解决方案：解决步骤。

参考资料

• 工具文档
• 安全框架
• 合规标准