我用 Codex 做周报自动化，第一件事是防止它胡写

周报，这大概是每个职场人心中又爱又恨的存在。爱它，是因为它让你回顾一周的忙碌；恨它，是因为写周报常常比干活还累。于是，我决定用 OpenAI Codex 来帮忙自动化生成周报。然而，当我第一次运行代码时，Codex 给我写了一份“胡编乱造”的周报——它虚构了“修复了银河系级Bug”这种荒谬的内容。这让我意识到：AI 虽然强大，但必须给它设定严格的“规矩”。本文将带你从基础概念讲到高级用法，手把手教你用 Codex 构建一个靠谱的周报自动化系统。## 什么是 Codex？为什么需要约束它？Codex 是 OpenAI 开发的 AI 模型，能够理解自然语言并生成代码。它基于 GPT-3 架构，但专门针对编程任务进行了优化。简单来说，你可以告诉它“写一个函数来计算销售额”，它就会生成相应的 Python 代码。这听起来很神奇，但问题在于：Codex 有时会“脑补”出不存在的功能或数据。比如，当我们让它生成周报时，它可能会凭空捏造“与客户会面”或“完成了未分配的任务”。这种“胡写”行为会让周报变得不可靠，甚至误导团队。因此，防止 Codex 胡写的核心在于：提供明确的数据源和逻辑规则。我们不让它自由发挥，而是让它基于真实数据（如 Git 提交记录、任务列表）来生成内容。## 基础篇：用 Codex 生成简单的周报模板让我们从最基础的场景开始：假设你有一个包含任务列表的 JSON 文件，Codex 需要从中提取信息并生成周报。首先，我们需要一个数据源。### 代码示例 1：从 JSON 文件读取任务并生成周报pythonimport json# 模拟一周的任务数据tasks_data = [ {"task": "修复登录页面的验证逻辑", "status": "已完成", "hours_spent": 4}, {"task": "编写用户手册文档", "status": "进行中", "hours_spent": 6}, {"task": "审查同事的代码提交", "status": "已完成", "hours_spent": 2}, {"task": "部署新的数据库补丁", "status": "已完成", "hours_spent": 3}]def generate_weekly_report(tasks): """ 根据任务列表生成周报摘要。 参数：tasks - 包含任务、状态、耗时的字典列表 返回：字符串格式的周报 """ report_lines = [] completed_tasks = [t for t in tasks if t["status"] == "已完成"] in_progress_tasks = [t for t in tasks if t["status"] == "进行中"] # 统计已完成任务 if completed_tasks: report_lines.append("## 本周完成") for t in completed_tasks: report_lines.append(f"- {t['task']} (耗时: {t['hours_spent']}小时)") # 统计进行中任务 if in_progress_tasks: report_lines.append("\n## 进行中的工作") for t in in_progress_tasks: report_lines.append(f"- {t['task']} (耗时: {t['hours_spent']}小时)") # 计算总耗时 total_hours = sum(t['hours_spent'] for t in tasks) report_lines.append(f"\n**本周总工时：{total_hours}小时**") return "\n".join(report_lines)# 让 Codex 生成周报（这里我们手动调用函数）report = generate_weekly_report(tasks_data)print(report)输出示例：## 本周完成- 修复登录页面的验证逻辑 (耗时: 4小时)- 审查同事的代码提交 (耗时: 2小时)- 部署新的数据库补丁 (耗时: 3小时)## 进行中的工作- 编写用户手册文档 (耗时: 6小时)**本周总工时：15小时**这里的关键是：我们硬编码了数据源，Codex 只能根据我们提供的任务列表来生成报告，它无法添加虚构的任务。这就是防止胡写的第一个步骤——数据驱动。## 进阶篇：集成 Git 提交记录，让周报更真实基础版周报虽然可靠，但手动输入任务数据仍然繁琐。更高级的做法是从 Git 仓库中自动提取提交记录来生成周报。这样，周报内容完全基于真实代码变更。### 代码示例 2：从 Git 提交记录生成周报pythonimport subprocessimport datetimefrom datetime import datetime, timedeltadef get_git_commits(since_date): """ 获取指定日期以来的 Git 提交记录。 参数：since_date - 起始日期（字符串，格式 YYYY-MM-DD） 返回：提交信息列表 """ try: # 使用 git log 命令获取提交信息 result = subprocess.run( ['git', 'log', '--since=' + since_date, '--format=%H %s %aN %ad'], capture_output=True, text=True, check=True ) commits = result.stdout.strip().split('\n') return [commit for commit in commits if commit] # 过滤空行 except subprocess.CalledProcessError as e: print(f"Git 命令执行失败: {e}") return []def generate_report_from_git(days=7): """ 基于 Git 提交记录生成周报。 参数：days - 要回溯的天数（默认7天） """ # 计算起始日期 start_date = (datetime.now() - timedelta(days=days)).strftime('%Y-%m-%d') commits = get_git_commits(start_date) if not commits: return "本周没有新的代码提交。" report = "## 本周代码变更摘要\n" report += "以下为最近7天的 Git 提交记录：\n\n" for commit in commits: parts = commit.split(' ', 1) # 分离 commit hash 和消息 if len(parts) == 2: hash_short = parts[0][:7] # 取前7位作为短id message = parts[1] report += f"- `{hash_short}` {message}\n" report += "\n**注意：** 此报告仅包含代码仓库中的提交记录，未包含非代码相关工作。" return report# 示例运行（假设你在一个 Git 仓库中）if __name__ == "__main__": weekly_report = generate_report_from_git() print(weekly_report)输出示例：## 本周代码变更摘要以下为最近7天的 Git 提交记录：- `a1b2c3d` 修复用户认证模块的空指针异常- `e4f5g6h` 添加团队协作功能的单元测试- `i7j8k9l` 重构数据库连接池配置**注意：** 此报告仅包含代码仓库中的提交记录，未包含非代码相关工作。这个版本的周报完全基于真实 Git 历史，Codex 无法捏造内容。你还可以扩展它，比如提取每个提交的作者、统计变更文件数量等。## 高级用法：用 Codex 模型生成自然语言摘要虽然上述方法防止了胡写，但周报可能过于“干巴巴”。我们可以利用 Codex 的文本生成能力来编写自然的周报摘要，但前提是给它提供严格的数据输入。例如，我们可以让 Codex 根据提交记录生成一段文字，但明确禁止它添加不存在的内容。pythonimport openai # 假设已安装 openai 库# 设置 API 密钥openai.api_key = "your-api-key"def summarize_commits(commit_messages): """ 使用 Codex 模型生成提交记录的摘要。 参数：commit_messages - 提交消息列表 返回：AI 生成的摘要文本 """ # 构建提示字符串，明确要求基于输入数据 prompt = f"""基于以下提交记录，生成一段不超过100字的周报摘要。请只使用提供的信息，不要添加任何虚构内容。提交记录：{chr(10).join(commit_messages)}摘要：""" response = openai.Completion.create( engine="code-davinci-002", # Codex 模型 prompt=prompt, max_tokens=150, temperature=0.5 # 降低温度以减少创造性 ) return response.choices[0].text.strip()# 示例：使用前面 Git 提交中的消息commits = [ "修复用户认证模块的空指针异常", "添加团队协作功能的单元测试", "重构数据库连接池配置"]summary = summarize_commits(commits)print(f"AI 生成的摘要：\n{summary}")可能的输出：AI 生成的摘要：本周主要完成了三项工作：修复用户认证模块的Bug、添加单元测试覆盖团队协作功能，以及重构数据库连接池配置。注意，这里我们通过 prompt 明确告诉 Codex “只使用提供的信息”，并设置了较低的 temperature 参数（温度越低，输出越保守）。这是防止胡写的关键技巧。## 总结通过本文的逐步讲解，我们从基础概念出发，构建了一个防止 Codex 胡写的周报自动化系统。核心原则有三点：1. 数据驱动：始终提供真实的数据源（如任务列表或 Git 提交），避免 AI 依赖“想象”生成内容。2. 逻辑约束：在代码中明确周报的生成规则，如只统计“已完成”或“进行中”的任务。3. 提示工程：如果使用 Codex 生成自然语言，通过精心设计的 prompt 和参数控制输出，限制其创造性。周报自动化的最终目的不是取代人类，而是让我们从繁琐的书写中解放出来。记住，AI 是你的助手，而不是创作者——给它明确的边界，它才能成为你可靠的伙伴。现在，你可以放心地让 Codex 帮你写周报了，至少它不会再虚构“银河系级Bug”了。