Cygnus-Security/wazuh-soc-lab

GitHub: Cygnus-Security/wazuh-soc-lab

一个基于 GitHub 工作流的网络安全实习周报管理框架,用于规范化追踪和整合实习成员的每周技术报告。

Stars: 1 | Forks: 0

# 🔐 CyberSec 实习 - 每周报告 本仓库用于管理、追踪和审查所有实习成员的每周进度报告。 ## 🎯 目标 - 确保一致的**每周报告** - 通过 **GitHub** 追踪个人进度 - 构建可整合为最终报告的结构化内容 ## 📌 一般规则 - 每位成员必须**每周提交且仅提交一份**报告 - 所有提交内容必须推送到 **GitHub** - 严格遵循**命名规范** - 每份报告应采用**清晰且可复用的格式**编写 ## 🌿 分支管理 每位成员必须在自己的**专属分支**上工作 ### 📛 命名规范 ``` ``` ### ✅ 示例 ``` tran-van-a nguyen-duc-minh ``` ### ❗ 规则 - 使用小写字母 - 使用 `-` 替换空格 - 请勿使用越南语声调符号 - 请勿直接提交到 `main` 分支 ## 📅 每周文件夹结构 ### 📛 格式 ``` week_ ``` ### ✅ 示例 ``` week1_27-03-2026 ``` ## 📄 报告命名规范 ### 📛 格式 ``` week__.pdf ``` ### ✅ 示例 ``` week1_api-testing_crapi.pdf week2_ids_wazuh.pdf week3_rag_qwen.pdf ``` ## 📂 必备内容 每个每周文件夹必须包含: - `report.pdf`(主报告 - 必备) - `report_.pdf`(可选的可读版本) - `source_code/`(代码、配置、脚本) - `notes.md`(可选) ## 🧠 结构化报告(重要) 每份每周报告的编写方式应满足: - 可独立作为每周进度报告 - 后续可被**整合为最终报告/文档** 👉 这意味着: - 书写清晰、正式 - 避免个人/日记式的写法 - 专注于可复用的技术内容 ## 📘 每周报告模板(必须遵循) ### 1. 贡献范围 - 本周的工作对项目的哪部分做出了贡献 ### 2. 本周目标 - ... ### 3. 详细工作 #### 3.1 描述 #### 3.2 设计 / 方法 #### 3.3 实施 ### 4. 结果 / 产出 ### 5. 分析 ### 6. 问题与修复 ### 7. 可复用内容 ⭐(必备) - 以清晰、正式的风格撰写 1-2 页 - 本部分应能在最终文档中复用 ### 8. 下一步计划 ## 🐙 GitHub Issue 工作流(必备) 为确保清晰的沟通与追踪,所有任务必须通过 **GitHub Issues** 进行管理。 ### 📌 1. 每个任务 = 一个 Issue 每个任务都必须作为单独的 issue 创建。 #### 命名格式: ``` [Week X] - ``` ### 📄 2. Issue 模板 每个 issue 必须遵循以下结构: ``` ## 📌 描述 What is this task about? ## 🎯 目标 - ## 📂 预期输出 - ## 🛠 工具 / 技术 - ## ⏱ 截止日期 - ## 🔗 相关 - Report folder: - PR: ## 📝 备注 - ``` ### 📊 3. 工作日志(必备) 所有学生必须使用评论在 issue 中直接更新进度。 #### 🔥 格式(强制要求): ``` ### 📅 第 X 天 (dd-mm) Time spent: Xh Work done: - Result: - Issue: - Next: - ``` #### ❗ 规则: - 必须每 1-2 天更新一次 - 必须创建新评论(请勿编辑旧评论) - 必须包含所有字段 #### ❌ 无效示例: ``` Did research ``` ### 👤 4. 分配与标签 - 将 issue 分配给负责人 - 使用标签,例如: - `week1`, `week2` - `api`, `ids`, `nginx` - `review`, `urgent` ### 🔄 5. 工作流 #### 实习生: - 定期更新工作日志 - 在 Project Board 上移动卡片 - 完成后: ``` - Done - PR: # - Report: ``` - 关闭 issue ### 🔗 6. 关联(重要) #### 在 commit 中: ``` git commit -m "week X: (#issue_number)" ``` #### 在 PR 中: ``` Closes #issue_number ``` ## 🔄 工作流 ``` git checkout main git pull origin main git checkout git add . git commit -m "week X: report" git push origin ``` ## 🚀 提交流程 - 创建 Pull Request → main - 标题: ``` [Week X] Full Name - Topic ``` ## ⚠️ 重要说明 - ❌ 禁止直接提交到 main - ❌ 缺失报告 → 拒绝 - ❌ 格式错误 → 拒绝 - ❌ 无 issue 追踪 → 拒绝 - ❌ 无工作日志 → 拒绝 - ✅ 必须包含“可复用内容” - ✅ 必须关联 issue ↔ PR ↔ 报告 ## ✅ 检查清单 - [ ] 分支正确 - [ ] 文件夹名称正确 - [ ] 报告文件命名正确 - [ ] 包含可复用内容部分 - [ ] 已创建并更新 issue - [ ] 已更新工作日志 - [ ] PR 已关联到 issue - [ ] 已推送并创建 PR ## 🏁 结语 每周报告是基础的构建模块。 如果编写得当: 👉 它们后续可以被整合为一份完整的最终文档 祝研究愉快 🚀
标签:Wazuh, 安全运营, 实习生培训, 扫描框架, 文档管理, 网络安全研究, 防御加固, 项目报告