weekly-report
仅适用于 macOS。用于生成结构化的软件研发周报,适用于「周报」「软件研发周报」 「本周工作总结」「写周报」、weekly report、end-of-week summary,以及需要向主管或 团队提交工作总结的情况。不用于个人日记、月度回顾、OKR 总结、会议记录或季度回顾。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
仅适用于 macOS。用于生成结构化的软件研发周报,适用于「周报」「软件研发周报」 「本周工作总结」「写周报」、weekly report、end-of-week summary,以及需要向主管或 团队提交工作总结的情况。不用于个人日记、月度回顾、OKR 总结、会议记录或季度回顾。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
Use this skill to audit, review, or validate Claude Code skills (.md files in .claude/commands/). Invoke when user wants to check skill quality, cross-platform compatibility, cross-agent compatibility, prerequisite declarations, or description triggering accuracy. Triggers on: 审查 skill, review skill, 检查 skill 质量, skill 兼容性检查, validate skill, audit skill. This skill delegates structure validation to validate.sh, content quality to skill-creator, and handles compatibility auditing itself. Do NOT use for general code review, reviewing PRs, or reviewing CLAUDE.md.
用于收集和整理个人双周记或周记的素材。用户提出「收集双周记素材」「准备周记」 「周记素材」「双周记」「最近发生了什么」「整理素材写周记」、"biweekly materials" 或 "gather journal materials" 时立即使用。从日记、Pinboard、豆瓣、Telegram、 Calendar、Reminders、照片、RSS 摘要和 plrom diff 中收集最近 2~4 周的原始材料, 并按周记模板整理,但不代写最终正文。工作周报使用 weekly-report。
用于个人写作,包括从零构思新文章,以及审校、润色已有文章。用户分享文章并要求反馈、 希望改善写作风格、不知道写什么、需要组织游记、TIL 或个人随笔,或要求检查中文质量时 立即使用。触发词包括「帮我改文章」「检查一下」「润色」「校对」「不知道写什么」 「帮我构思」「写游记」「记录 TIL」「写点什么」。不用于正式商务沟通。
用于从 Obsidian 笔记库中筛选可发布内容,选择博客主题,或把已有笔记转换成博客草稿。 用户提出「选一篇笔记发博客」「写博客」「博客选题」「从笔记里找文章」或 "note to blog" 时立即使用。不用于从零撰写新文章、校对已有博客草稿或整理普通笔记。
Use this skill to rewrite any text or idea in the voice of Aoi Miko (葵井巫女子) from the Zaregoto series — her signature style of absurdist analogies using the pattern 「就好像『[everyday situation], 可是[absurd contrast]』耶!」. Invoke when the user explicitly asks for 巫女子风格, 戏言风格, zaregoto style, or requests character voice conversion to this specific style. Also invoke when the user shows content and asks "巫女子会怎么说" or "用巫女子的口吻". Do NOT invoke for general style rewrites, translations, humor writing, or other character voices.
Use this skill immediately when the user needs to: set up markdownlint-cli2 and pre-commit hooks in a repository, fix or batch-repair markdownlint errors like MD013/MD040/MD060, configure .markdownlint.json rules, remove horizontal rules from markdown files while preserving YAML frontmatter, or run markdown format checking in a monorepo. Trigger on: markdownlint 报错, 设置 markdown lint, 格式化 markdown, 检查 md 格式, 设置 pre-commit, markdownlint error, MD013/MD040/MD060 violations. Do NOT use for general article proofreading, writing new markdown content, or YAML/JSON linting.
| name | weekly-report |
| description | 仅适用于 macOS。用于生成结构化的软件研发周报,适用于「周报」「软件研发周报」 「本周工作总结」「写周报」、weekly report、end-of-week summary,以及需要向主管或 团队提交工作总结的情况。不用于个人日记、月度回顾、OKR 总结、会议记录或季度回顾。 |
从 Obsidian、飞书项目、GitLab、GitHub 和本地 Git 收集事实,生成主管可读的中文周报。 审阅完成后写回 Obsidian,并把下周计划安排到 Apple Calendar。
| 工具或资源 | 类型 | 必需 | 安装或配置方式 |
|---|---|---|---|
| Git | cli | 是 | brew install git |
| Node.js | cli | 是 | brew install node |
| Obsidian | system | 是 | 提供已存在且包含工作日志的 vault |
| macOS Calendar | system | 是 | macOS 内置,通过 osascript 访问 |
meegle | cli | 是 | npx @lark-project/meegle@latest install |
| GitLab MCP | mcp | 是 | 在 Codex MCP 配置中启用已安装的 GitLab MCP,设置自建地址和访问令牌,再重启会话 |
gh | cli | 是 | brew install gh,然后运行 gh auth login |
加载 Skill 时不要主动检查环境。进入采集流程后执行一次预检;工具缺失、未认证、配置 错误或权限不足时停止生成,直接给出表格中的安装或配置步骤,处理完成后再继续。网络 超时、远程服务异常等临时故障无论在预检还是采集阶段发生,都按数据源说明降级。
按以下顺序执行:
先扫描最近一篇带大小周标记的历史周报,取其标题日期和类型。计算历史周周一与目标周周一 之间相差的完整周数:偶数周沿用历史类型,奇数周切换类型。没有历史标记、日期无法解析或 结果存在歧义时,请求确认目标周是大周还是小周,不得按自然周单双号猜测。
报告周期与目标日记按周类型确定:
| 周类型 | 报告周期 | 目标日记 |
|---|---|---|
| 大周 | 周一 00:00 至周日 00:00,结束时间不包含 | 周六日记 |
| 小周 | 周一 00:00 至周六 00:00,结束时间不包含 | 周五日记 |
周日触发时默认处理刚结束的一周。目标周尚未到最后一个工作日时,先说明报告不完整并请求
确认;未确认时不要生成。目标日记、vault 或 ## 2 Work Log 无法唯一定位时请求路径,
不要自行创建缺失资源。
扫描最近 21 天的日记,查找标题 ### 软件研发周报,从最近一篇提取:
没有历史周报时跳过计划比较,但仍需确认本周类型。
| 优先级 | 数据源 | 主要用途 |
|---|---|---|
| 1 | Obsidian 工作日志 | 背景、决策、理由和业务结果 |
| 2 | 飞书项目 | 工作项状态、负责人和排期 |
| 3 | GitLab / GitHub | MR、PR 和 Issue 事实 |
| 4 | 本地 Git | 补充遗漏并核对事实 |
按项目、标题、工作项链接、分支和描述判断同一事项。多个来源指向同一工作时合并为一条, 不要把工具记录逐条复制进周报。
| 状态 | 处理方式 |
|---|---|
| 已完成 | 写入「本周工作总结」 |
| 部分完成 | 在总结中说明进度,并顺延到「下周工作计划」 |
| 未开始 | 写入「其他事项」,已知原因时一并说明 |
| 计划外完成 | 作为新增成果写入「本周工作总结」 |
项目名称优先沿用历史周报,其次使用 Obsidian 和飞书项目中的名称,再结合远程活动和本地 仓库结构归并。省略本周无活动的项目,不硬编码任何项目名称或项目间关系。
**加粗关键词**: 加业务语言说明。(N 天);每条说明预期结果,不只写动作名称。- 无。## 2 Work Log。同一报告周期的标题已存在时替换该章节,否则追加到 ## 2 Work Log 末尾。不得重复写入
同一周期。完成写回后再进入 Calendar 排期。
使用业务语言。 说明完成了什么以及带来什么结果,不直接复制技术记录。
使用业务数字。 可以写接口、页面、配置参数和待确认问题数量;不要写 commit、MR/PR 或覆盖率数量。
沿用历史风格。 保持连续周报的项目名称、语气、细节层级和格式一致。