技能介绍

要解决的不是“有没有周报”，而是“周报像不像流水账”

很多工程师写周报的痛点不在打开文档，而在把零散素材整理成能让读者看懂价值的材料：Git 提交太碎、代码统计分散、会议和文档又不在仓库里，最后容易写成“参与了开发”“跟进了上线”之类的过程叙述。这个技能的目标是把 Git 提交记录、待办清单、聊天记录、口述补充 等素材统一收集，并按角色和语气生成结果导向的周报或月报。

核心工作流与注意点

它先做素材收集，再判断角色，最后套用写作约束：

Git 侧：可读取本机仓库提交记录，支持 --mode monthly、--with-stats、--author、--role 等参数；--plan-file 只读解析 Markdown 任务清单中的完成率，读取失败会如实说明。
人工侧：会一次性询问非代码工作、可量化数字、阻塞项和下周期计划，也接受待办文件、聊天导出或口述内容。
成稿侧：按“程序员 / 运营 / 销售 / 管理者”角色，以及 钉钉简洁版、飞书文档版、邮件正式版 输出；要求条目以动词开头、能量化就量化、同类事项合并，且不在素材之外编造内容。

边界上，它依赖本机可读取的 Git 信息和用户补充素材；素材越具体，成稿越可靠，缺少量化指标或阻塞信息时会偏保守。language 可设为 zh、en 或 auto。隐私说明称 Git 记录仅本机读取分析，其他素材仅用于当前会话，不上传数据。