《Git工作流与开源工程》审阅修订报告
版本:0.10
审阅范围:教材大纲和24个正文文件
审阅时间:2026年7月30日
稿件状态:出版编校修订稿
一、审阅结论
本轮修订把书稿进一步调整为项目化技术教材。全书以真实物理AI产品的版本演进为主线,Git、AI协同和工程质量不再作为彼此分离的知识点。第1—12章完成教师贯穿项目,第13—18章迁移到学生原创项目。
正文已统一为浅白、庄重的教材语体。章节重点由流程口号转向工程机制、证据和边界。章末任务要求学生形成自己的方案、记录、代码、测试或发布材料。
二、本轮主要修订
1. 语体修订
- 删除口语、网络语、营销语和情绪化过渡;
- 拆分并改写过长句,使一个句子只表达一个主要判断;
- 减少空泛的流程表述,改写为条件、机制、代价和可观察结果;
- 统一“我们”“你”等教材称呼的使用范围。
2. 术语修订
- 统一使用“议题”“合并请求”“技术决策记录”;
- 统一使用“构建物清单”“基准输入输出”“JSON模式”;
- 统一使用“散列值”和“闪存”;
- 软件名、命令、文件名、参数和版本号按统一体例处理;
- 中英文缩略语在正文首次出现处给出完整注释。
3. 内容修订
- 补入版本控制、分支协作、需求迭代、接口契约、持续集成和开源发布的演进背景;
- 说明每种方法解决的旧问题、产生的新成本及其适用边界;
- 强化AI输出的不确定性、人工责任和Git差异审查;
- 明确自动测试、实机测试、用户验收和发布复现的证明范围;
- 保持与《人工智能数据科学》《感知与异构计算系统原型》的课程边界。
4. 实践修订
18章均设置“综合实践”。实践任务要求学生形成可评审的工程成果,不以复现预设答案为目标。主要成果包括:
- 项目身份卡、证据矩阵和数据流图;
- 状态图、恢复方案和分层验证报告;
- AI任务契约、提示方案和风险控制规则;
- 议题、合并请求、测试与发布记录;
- 产品需求、工程规格、构建物清单和技术决策记录;
- 学生原创项目的版本、开源材料和复盘报告。
三、量化检查
正文共24个Markdown文件,约16.8万字符、1.09万行。教材大纲与正文共25个文件统一标记为0.10版。
本轮中期首次全量句长检查发现80个超过45字的句子。逐句修订后,自动检查结果如下:
| 检查项 | 结果 |
|---|---|
| 禁用口语、网络语和夸张语 | 0 |
| 时效性营销表述 | 0 |
| 英文省略号和感叹号 | 0 |
| 数值与单位间缺少空格 | 0 |
| 非代码数字范围使用连字符 | 0 |
| 四级及以下标题 | 0 |
| 章内二级标题缺少编号 | 0 |
| 文件名未使用反引号 | 0 |
| 已知术语异名 | 0 |
| 超过45字的句子 | 0 |
| 超过6句的正文段落 | 0 |
自动检查用于发现形式问题,不能替代责任编辑的语义审读和技术复核。
四、出版依据
本轮编校参考以下现行标准:
- CY/T 154—2017《中文出版物夹用英文的编辑规范》;
- GB/T 15834—2011《标点符号用法》;
- GB/T 15835—2011《出版物上数字用法》;
- GB 3100—1993《国际单位制及其应用》;
- GB/T 7714—2025《信息与文献 参考文献著录规则》。
五、仍需人工确认
本轮没有取得逐节“掌握级术语”“了解级术语”配额,也没有取得指定的“前后衔接”文本。相关处理原则和需确认事项见《待确认事项_0.10.md》。
教材定稿前还需进行三项核验:
- 用课程真实仓库完成第1—12章的逐章实机复现;
- 由另外两门课程的教师复核数据、模型和硬件接口;
- 按出版社要求完成软件名称、截图、许可证和参考文献的终审。