概述在AI辅助开发的工作流中将日常编码活动转化为结构化的工作报告是一项具有实际价值的需求。本文档旨在解析如何利用大语言模型LLM的上下文与本地工具调用能力通过创建项目专属的Skill实现对Git提交记录的自动解析并生成符合规范的工作汇报文档。该过程不涉及复杂的API对接而是通过自然语言指令与模型自身的文件系统操作能力完成从数据读取到文档落地的完整闭环。纲要Skill的类型与作用域全局Skillvs 项目局部Skill目录结构与存储位置Git提交记录的读取与解析本地Git历史命令提交信息汇总逻辑周报生成的自动化流程内容模板的定义输出格式与存储策略Markdown文件管理规范文档忽略提交配置.gitignore目录规划示例核心流程概览整个自动化周报生成流程涉及三个核心环节数据源提取Git Log、指令封装Skill定义、产物输出Markdown文档。下图描述了该流程的逻辑关系。创建指令调用返回提交历史格式化保存存放于触发配置开发者项目局部 SkillGit 本地仓库提交记录解析器周报草案Markdown 文档项目 docs/ 目录忽略周报文件提交.gitignore项目结构规划为实现局部Skill的隔离需在项目根目录下规划特定文件夹用于存放文档与配置。以下是一个推荐的基础结构├── .cursor/ # Cursor IDE 配置目录 │ └── skills/ # 局部 Skills 存放位置 │ └── weekly-report.md # 具体的 Skill 定义文件 ├── docs/ # 文档纪要目录 │ └── 2026-08-15_weekly.md # 生成的周报示例 ├── .gitignore # 版本忽略文件 └── README.md创建项目专属的局部 Skill在 AI 辅助编程环境中Skill是一组预定义的指令集用于引导模型完成特定任务。根据作用范围Skill可分为全局跨项目可用与局部仅当前项目可用两种类型。针对周报生成场景建议采用局部Skill以确保其与当前项目的Git提交记录上下文强相关。定义 Skill 的步骤初始化指令向 AI 助手如 Cursor/Claude发送创建指令明确要求创建一个仅存在于本项目中的Skill。功能描述清晰说明该Skill的核心功能——读取当前项目的Git提交记录汇总本周工作内容并输出为Markdown格式文档。存储路径指定指定文档的输出路径例如docs/目录避免文件散落在项目根目录。指令示例自然语言“请创建一个只能在本项目中使用的Skill。该Skill需要能够读取当前项目的Git提交历史汇总本周的工作内容并将最终周报保存为Markdown文档存放在docs/目录下。”迁移与复用由于该Skill被定义为局部类型其配置文件通常为.md或.yaml会保存在项目目录中如.cursor/skills/。若需在另一个项目中复用仅需将此配置文件复制至目标项目的对应skills目录即可无需重复定义。Git 提交记录的解析逻辑Skill的核心能力在于对本地版本历史的读取与解析。在实现层面AI 模型通过执行终端命令来获取原始数据。获取提交历史常用的Git命令用于提取格式化的一周日志gitlog--since1 week ago--oneline--prettyformat:%h - %s (%cd)--dateshort该命令参数的含义如下--since1 week ago限定时间范围为一周内。--oneline简洁单行显示。--prettyformat:...自定义输出格式包含哈希值、注释与日期。信息汇总策略AI 在获取上述文本输出后会依据Skill定义中的指令进行语义归纳。归纳逻辑通常包括分类聚合按功能模块如前端、后端、文档对提交记录进行分类。去重与精炼合并相似的提交如修复同一问题的多次提交提取核心变更点。结构化输出将整理后的内容映射到周报的固定章节中如“核心功能开发”、“缺陷修复”、“文档更新”。周报生成与存储规范输出格式为确保周报的可读性与一致性Skill应指导模型按照特定模板生成Markdown内容。一个标准的周报模板应包含报告周期本周起止日期关键工作项列表基于Git提交分类下月/下周工作计划预留占位符存储与版本忽略策略重要实践周报属于工作汇报文档通常不应提交至公共代码仓库。建议在.gitignore文件中添加过滤规则忽略docs/下或特定命名的周报文件。# .gitignore 片段 docs/*weekly.md实施效果与验证在Skill配置完成后每次触发生成指令例如“生成本周工作周报”AI 将自动执行以下流程扫描本地Git记录。根据提交信息生成初版周报。保存至指定本地路径。根据实际项目数据包含前端、后端、管理后台的开发提交生成内容可覆盖项目初始化、API 开发、功能完善等多个维度显著减少了人工回忆与撰写的时间成本。参考文档官方文档Cursor IDE 官方文档Git - 官方文档参考链接Git log 格式化输出指南Markdown 语法参考总结本文档描述了一种利用 AI 辅助编程工具构建自动化周报系统的轻量级方案。其核心价值在于将重复性的数据收集与归纳工作交由Skill配合Git信息处理完成。开发者仅需通过自然语言定义规则无需编写复杂脚本即可实现从版本历史到结构化报告的转换。该方案的关键技术要点如下局部Skill隔离通过限定Skill作用域避免不同项目间的指令干扰并便于版本控制与迁移。Git日志解析依赖git log命令的标准输出作为数据源利用 AI 的归纳能力替代传统的正则表达式解析降低了对精确文本匹配的依赖提高了对非规范提交信息的兼容性。文件生命周期管理通过将生成的报告存放于特定目录并配置.gitignore实现了代码仓库内容与本地工作汇报产物的解耦防止了敏感或无关文件的版本污染。人机协作指令流展现了通过自然语言与模型交互来动态生成、修改及配置Skill的工作模式而无需深入研究底层 API 调用逻辑。