人机协同编程与工作流基础#
课程描述#
版本:2026.09.20-r1|修订日期:2026年9月20日|状态:课程组审阅稿
一、课程基本信息#
| 项目 | 内容 |
|---|---|
| 适用专业与对象 | 人工智能技术应用专业,2026级高职一年级学生 |
| 课程性质 | 专业基础课,必修;非专业群平台课 |
| 开设学期 | 第一学期 |
| 总学时 | 56 |
| 学时与学分 | 56学时,3学分;理论28学时,实践28学时 |
| 周次安排 | 14个教学周,每周4学时 |
| 考核方式 | 考试;过程性考核60%+期末综合实操40% |
| 开课单位 | 深圳城市职业学院信息与通信学院 |
| 教务课程代码 | 待核定;网站标识GZ-006仅用于课程目录 |
| 核心阅读 | 《人月神话》,配套工程探究工作页与Git技术参考 |
以上课程性质、学分学时依据人培方案[P1];周次、考核总比例及网站标识延续线上工作稿[P0]。总计共56学时,实践28学时包含常规实践26学时及期末综合实操考核2学时。
二、课程定位与设计哲学#
本课程是高职人工智能技术应用专业新生的通用工程方法与组织协作课程。在AI原生时代,大语言模型与智能体工具已经能够高效生成局部代码,软件开发的第一矛盾已不再是纯粹的语法编写速度,而是概念完整性、系统契约、上下文工程、组织协作秩序与不可伪造的质量证据链。
课程跳出传统“纯Git语法工具课”与“提示词拼凑课”的局限,以软件工程经典名著《人月神话》(The Mythical Man-Month)中的14个永恒困境为哲学主干,建立“宏观工程困境 $\leftrightarrow$ 微观代码碰撞与实验验证”的双向锚定体系。课程引导学生在解决一个个具象的终端冲突、接口断裂、幻觉叠加与回归故障中,培养确定目标、守住边界、管理上下文、审阅代码差异、驾驭人机协同并对最终工程交付负责的核心素养。
课程为初学者设计,无系统程序设计前导要求。程序阅读围绕输入、处理、输出及一处关键修改展开;Python、Linux、AIoT和人工智能专业课程在后续学期深化技术体系。本课形成的不可伪造的5阶段协同证据链、接口契约与版本治理方法,将作为底层工程素养贯穿大学全程。[P0][P1]
三、课程目标#
素质目标#
树立对需求契约、协作结果与交付质量负责的工程责任意识;坚守“运行不等于完成,交付必须有证据”的严谨作风;尊重开源协议与知识产权,严守数据合规与安全红线;能够诚实记录失败与限制,并在实验中理性调整技术判断。
知识目标#
深刻理解目标与范围、概念完整性、分工与人机组织、版本与变化、验证与交付五类经典软件工程命题;理解《人月神话》中“焦油坑”、“布鲁克斯法则”、“概念完整性”、“外科手术式团队”等经典原理在AI时代的内涵跃迁;掌握Git底层对象快照模型、工作区/暂存区/版本库原理、特性分支策略与非破坏性安全恢复机制;掌握现代智能体控制面(Agent Control Plane)与上下文工程原理。
能力目标#
能把想法拆解为对象、输入、输出、上下文约束与验收条件明确的小任务;能运行作品、解释关键执行路径并手工完成有限修改;能组织AI参与分析、实现和检查,审阅差异并根据测试验证决定如何处理结果;能使用Git记录、比较、恢复与整合修改;能交付一个可运行、可复现、可继续改进的小型作品,并说明一次关键工程决策。
四、核心方法与工程载体#
1. 不可伪造的5阶段人机协同证据链(Git Evidence Chain)#
为防止学生将AI生成内容未经检验直接提交,课程建立全流程可审计的5阶段协同证据闭环:
- 意图声明(Intent):在开始编码前,人类学生必须清晰阐述本次修改的业务意图、输入输出契约及验收标准(Issue / PRD)。
- 方案设计(AI Plan):AI智能体提出任务拆解与实现步骤,明确影响的文件范围。
- 人类审查(Human Review):人类工程师行使审查权,核实方案是否符合概念完整性与安全边界,做出调整或放行。
- 代码差异与测试(Git Diff & Test):在本地工作区执行修改,先运行既有测试守护底线,再通过
git diff逐行审查变更细节,执行新增验证用例。 - 决策归档(Final Verdict):形成包含意图、变更点与验证证据的规范原子提交(Atomic Commit);若验证失败,则实施安全恢复并记录故障分析。
2. 四类入门脚手架(Starter Archetypes)与持续迭代#
课程提供四类经过验证的轻量级入门脚手架,供学生在第1周建立基线,并在第3周确立自选作品方向持续迭代:
- A类:学习记录与反思日志工具(Learning Log & Reflection CLI/Web)——面向个人学习过程记录、标签管理与周度统计;
- B类:知识卡片与信息检索工具(Knowledge Cards & Bookmark Explorer)——面向结构化知识碎片、关键词检索与导出;
- C类:轻量数据清洗与统计分析工具(Data Formatter & Metric Analyzer)——面向表格数据校验、异常值筛选与格式转换;
- D类:交互式自测与智能诊断工具(Interactive Quiz & Diagnostic Assistant)——面向规则问答、错误诊断与状态判定。
学生在第3周立项时,必须严格执行**“三不原则”(Out-of-Scope Rule)**,明确列出“本项目当前绝不做的三件事”,以对抗过早优化与功能膨胀的诱惑。
五、教学内容与单元结构#
课程采用“共同微实验暴露问题+自选作品持续迭代”的双层架构。微实验在课堂暴露典型的工程崩溃(如接口断裂、多智能体冲突、回归失效),学生将学到的治理方法立即迁移到自己的作品中。
| 教学单元 | 周次 | 核心命题与微实验落点 |
|---|---|---|
| 一 目标与版本起点 | 1—2 | “焦油坑”与交付鸿沟;“无银弹”与本质复杂性;文件保存 vs Git原子快照与受控恢复 |
| 二 分布式协作与方案探索 | 3—4 | 分布式自治与协作图;“三不原则”界定边界;“外科手术式团队”与特性分支多方案探索 |
| 三 系统一致性与人机组织 | 5—7 | “概念完整性”与Schema契约断裂;AI时代“布鲁克斯法则”与多智能体冲突;“巴别塔”与上下文工程规范(AGENTS.md) |
| 四 范围、集成与质量判断 | 8—10 | “画蛇添足”与第二个系统效应;系统集成与合并请求;缺陷连锁反应与回归测试套件 |
| 五 进度与开放协作 | 11—12 | “祸起萧墙”与一次延迟一天;Git提交作为唯一真理源;文档即系统与开源协议合规 |
| 六 复盘、迁移与交付 | 13—14 | “抛弃型原型”与技术债重构;AI协同全景复盘;期末无损工程封包与独立迁移实操考核 |
六、教学要求与实施建议#
1. 讲授与实践循环#
每4学时按180分钟编排,理论90分钟与实践90分钟紧密咬合,采用“经典故事背景—问题预测—原理讲授—微实验碰撞—自选作品迁移—反思复盘”的循环。讲授重点剖析工程决策的权衡,实践侧重真实终端操作与协同证据留存。
2. 阅读与智能体协同规范#
精选《人月神话》核心篇章作为阅读材料,区分历史背景、作者论断与现代AI工程实践。引入Cline、校内Qwen等AI工具时,严格遵循“人类定目标、AI出方案、人类审差异、机器测行为、人类担责任”的控制面秩序。禁止在同一工作区无序并发调用多个AI代理写入。
3. 工具与场地#
教学在配备VS Code、Cline、校内私有化大模型服务、Git及校内GitLab的实训机房进行。命令行操作与图形化界面对照讲解,侧重理解底层快照图模型,不进行机械式的语法背诵。网络或AI服务异常时,切换为本地离线分析方案,严守安全与脱敏要求。
4. 评价机制#
过程评价围绕8项阶段作业组织(共60分),期末设置90分钟现场综合实操考核(共40分)。以决策合理性、测试完整性与交付证据质量为评价核心,坚决摒弃按代码行数、提交频次或对话长度评价的机械方式。
七、版本与采用说明#
本稿为2026.09.20-r1课程组审阅稿,严格保持56学时、3学分、理论28+实践28、14周×4学时及60%过程+40%期末的基本口径。课程代码、教材中文版采购信息、授课日期及审批签署由教学单位按规程完善。
依据编号与可核查来源详见配套《依据与故事来源说明》。
参考资料#
来源核对日期:2026年9月20日;历史与教材观点用于引出工程问题,课堂情境与微实验为本轮原创转化。
[P0] 现行线上课程工作稿(本轮核对基线)
[P1] 《信通学院人工智能技术应用专业2026年高职人才培养方案》,第5—6、10、31页。
[B1] Brooks《人月神话》英文纪念版:出版方样章与序言
[B2] 出版方《人月神话》纪念版目录
[G6] VS Code:源代码管理
具体中文译名、书目信息和页码以所购教材为准,本文不复制教材正文。
人机协同编程与工作流基础#
课程标准#
版本:2026.09.20-r1|修订日期:2026年9月20日|状态:课程组审阅稿
一、课程概览#
| 项目 | 内容 |
|---|---|
| 中文名称 | 人机协同编程与工作流基础 |
| 英文名称 | Fundamentals of Human-AI Collaborative Programming and Workflow |
| 适用专业 | 人工智能技术应用,三年制高职2026级 |
| 课程类别与性质 | 专业基础课程,必修,非群平台课程 |
| 学期与前导 | 第1学期;无系统程序设计前导要求 |
| 总学时 | 56 |
| 学分学时 | 3学分,56学时;理论28学时、实践28学时 |
| 实践分配 | 常规实践26学时,期末综合实操2学时 |
| 周次 | 14周,每周4学时 |
| 考核 | 考试;过程性考核60%,期末综合实操40% |
| 课程代码 | 待核定;网站标识GZ-006不替代教务代码 |
| 开课单位 | 深圳城市职业学院信息与通信学院 |
| 核心阅读 | 《人月神话》;中文版书目信息按实际采购核对 |
| 标准标识 | human-ai-programming-standard / 2026.09.20-r1(文档标识) |
课程性质及学时学分依据高职人才培养方案[P1],考核总比例与实践考核计入方式延续现行线上工作稿[P0]。本轮修订确立“宏观工程哲学 $\leftrightarrow$ 微观代码碰撞”的教学范式,重组教学单元、项目载体与能力评价体系。
二、课程定位与学习目标#
(一)课程在人才培养中的作用#
本课程是高职人工智能技术应用专业新生的首门通用工程实践课。面对大模型与智能体协同的技术变革,高职人培方案对软件协同开发明确提出了需求澄清、任务分解、代码审查、测试调试、合规溯源与工程复盘的综合能力要求,并强调数字工具的规范应用[P1]。
本课程以小型软件作品与微型工程实验为载体,引导初学者在实践中确立“运行不等于完成,交付必须有证据”的工程信条,系统掌握人机分工、上下文约束、Git版本控制、接口契约与回归验证方法,为后续《Python程序设计》、《Linux系统管理》、《AIoT应用开发》及《人工智能开源工程》奠定底座协作能力。
(二)课程解构与内容边界#
| 维度 | 本课程核心要求 | 后续课程深化方向 |
|---|---|---|
| 工程哲学 | 概念完整性、边界管理(三不原则)、布鲁克斯法则、缺陷连锁反应 | 大型分布式系统架构、精益敏捷与工程经济学 |
| 协同控制面 | 意图声明 $\to$ 方案设计 $\to$ 人类审查 $\to$ 差异测试 $\to$ 决策归档(5阶段证据链) | 智能体系统编排、多智能体交互与自主运行策略 |
| 编程理解 | 读懂输入—处理—输出,解释执行路径,手工完成核心逻辑修改 | Python/C++高级语法、算法设计与面向对象工程 |
| 版本与协作 | 快照模型、原子提交、特性分支、冲突解决、代码评审(MR)与受控恢复 | 复杂分支模型(Trunk-based/Gitflow)、CI/CD与自动化运维 |
| 开源合规 | 依赖声明、README无损交接、开源协议识读与安全脱敏 | SBOM软件物料清单、开源治理与专利合规 |
(三)学习目标与可观察表现#
素质目标贯穿全程:工程责任、严谨求实、尊重产权、数据脱敏、坦诚复盘与团队协作。知识与能力目标细化为五个可观察的达成维度(O1—O5):
| 编号 | 学习目标 | 达成表现 | 主要核验证据 |
|---|---|---|---|
| O1 | 目标、边界与“三不原则” | 能准确界定用户、输入、输出与可观察的验收条件,主动声明“绝不做的三件事”对抗范围膨胀。 | 任务说明、Issue定义、三不原则声明、评审记录 |
| O2 | 体系结构、契约与人机组织 | 能解释核心执行路径,制定模块间的接口约定(Schema),规范配置AI上下文(AGENTS.md)与分工。 | 接口文档、AGENTS.md、代码结构说明、交接记录 |
| O3 | 版本快照、分支与受控恢复 | 掌握Git对象模型,能规范进行原子提交、特性分支多方案探索、冲突排查与非破坏性单文件恢复。 | 真实Git提交树、分支差异比对、恢复补丁与日志 |
| O4 | 缺陷复现、独立预期与回归测试 | 坚守测试预期先于实现的原则,能独立复现Bug,防范AI虚假修复,构建回归测试套件守护底线。 | 测试用例表、断言脚本、Bug复现与回归对比日志 |
| O5 | 封包交付、工程复盘与可复现性 | 能编写无损README使同伴在干净环境零障碍复现作品,合规标注开源许可,完成5阶段证据复盘。 | 完整工程仓库、同伴盲测复现报告、复盘报告(A7/A8) |
(四)最终学习成果#
每位学生独立交付一个可运行、可复现、可继续改进的小型软件作品工程包,包含:
- 完整代码仓库:规范的目录结构、清晰的模块划分与无垃圾文件的
.gitignore。 - 5阶段协同证据链:包含意图声明、AI方案、人类审查记录、Git差异审查与验证证据。
- 无损交接文档:README包含环境准备、运行指令、测试用例、“三不原则”边界声明及已知限制。
- 测试与回归套件:涵盖正常、异常及边界情况的可运行测试用例。
- 个人工程复盘报告:诚实记录人机分工中的关键工程决策、失败尝试与经验提炼。
三、课程结构与学时分配#
(一)双层项目演进机制#
课程采用“共同微实验暴露典型工程崩溃 $\to$ 自选作品持续迭代与方法迁移”的双层架构:
- 第一层:共同微实验(课堂基准)。针对《人月神话》的经典困境,教师提供微缩故障场景,学生在终端亲身体验接口断裂、并发冲突、回归失效等“工程碰撞”,形成直观认知。
- 第二层:自选作品持续迭代(能力迁移)。学生从四类入门脚手架(学习记录工具、知识卡片工具、数据转换分析工具、交互自测工具)中选择方向,第1周建立基线,第3周明确边界,第4周跑通MVP,第5—13周持续应用工程方法深化工件,第14周完成封包交付与迁移实操。
(二)单元学时分配#
| 单元 | 名称 | 周次 | 理论学时 | 实践学时 | 合计学时 |
|---|---|---|---|---|---|
| U1 | 目标与版本起点 | 1—2 | 4 | 4 | 8 |
| U2 | 分布式协作与方案探索 | 3—4 | 4 | 4 | 8 |
| U3 | 系统一致性与人机组织 | 5—7 | 6 | 6 | 12 |
| U4 | 范围、集成与质量判断 | 8—10 | 6 | 6 | 12 |
| U5 | 进度与开放协作 | 11—12 | 4 | 4 | 8 |
| U6 | 复盘、迁移与交付 | 13—14 | 4 | 4 | 8 |
| 合计 | 14周 | 28 | 28 | 56 |
注:U6实践4学时包含第13周常规实践2学时与第14周期末现场综合实操考核2学时。
四、单元教学设计(工程困境与微实验落点)#
U1 目标与版本起点(第1—2周,8学时)#
目标对应: O1、O3、O4。理论4学时、实践4学时。
经典工程命题与阅读入口:
- 第1周:《焦油坑》(The Tar Pit)——单个临时脚本与编程系统产品(Programming Systems Product)之间的9倍工程鸿沟;“可运行”与“可交接”的本质差异。[B1][B2]
- 第2周:《没有银弹》(No Silver Bullet)——本质复杂性(Essential Complexity)与偶然复杂性(Accidental Complexity);版本快照与状态追踪。[B1][G1][G3]
微实验落点(Micro Code Experiments):
- 第1周微实验:在未安装依赖的环境中直接运行同伴代码,触发运行崩溃,体悟“在我的电脑上能跑”不等于工程交付,建立环境依赖与最小验收条件。
- 第2周微实验:模拟多次混乱保存“最终版_v2_修改.js”导致的覆盖丢失灾难;在独立Git仓库中完成有目的的原子提交,并使用
git restore --worktree实现单个被误改文件的受控安全恢复。
自选作品实践: 运行A类脚手架(学习记录工具),手工修改一处核心阈值参数并验证;确立自选作品方向。
考核评价: 完成作业 A1(完成标准与首次交接)与 A2(差异审查与受控恢复)。
U2 分布式协作与方案探索(第3—4周,8学时)#
目标对应: O1、O2、O3。理论4学时、实践4学时。
经典工程命题与阅读入口:
- 第3周:Git诞生史与分布式协作哲学——Linux内核开发对集中式版本控制的颠覆;独立探索与汇合秩序。[G2]
- 第4周:《外科手术式团队》(The Surgical Team)与增量原型——主干保护、特性分支与方案并行探索。[B2]
微实验落点(Micro Code Experiments):
- 第3周微实验:两人结对向同一个远程分支同时推送不兼容的修改,触发
[rejected - non-fast-forward]报错,亲历协同碰撞;运用“三不原则”声明本项目绝不做的三件事。 - 第4周微实验:针对同一功能需求在
feature/plan-a和feature/plan-b两条分支分别试验不同实现方案,依据预先设定的性能与代码清晰度指标完成方案评审与合并取舍。
自选作品实践: 完成自选作品立项并建立仓库;在分支上完成第一条端到端可运行功能流程。
考核评价: 完成作业 A3(两套方案与分支取舍)。
U3 系统一致性与人机组织(第5—7周,12学时)#
目标对应: O1、O2、O4、O5。理论6学时、实践6学时。
经典工程命题与阅读入口:
- 第5周:《概念完整性》(Conceptual Integrity)——体系结构设计者(Architect)与具体实现者;接口契约的决定性。[B1][B2]
- 第6周:AI时代的《布鲁克斯法则》(Brooks's Law)——盲目增加AI智能体并发不会线性加速,反而带来严重的上下文污染与幻觉叠加。[B2]
- 第7周:《巴别塔》(The Tower of Babel)与现代上下文工程——团队沟通失效与上下文交接规范(AGENTS.md)。[B2]
微实验落点(Micro Code Experiments):
- 第5周微实验:两个独立由AI生成的模块在数据字段命名(如
userId与user_id)和时间戳格式上出现静默不一致,导致联调抛出 TypeError 崩溃;通过定义严格的 JSON Schema 契约排除故障。 - 第6周微实验:多AI并发污染实验——同时开启多个AI对话对同一代码库提出不同修改,观察命名冲突与逻辑矛盾;建立单工作区串行审查与范围锁定纪律。
- 第7周微实验:无文档盲目交接实验——仅传递代码给新同伴,观察接手阻碍;编写
AGENTS.md与项目交接卡,使新AI会话或新成员在5分钟内准确理解系统约束并完成新功能修改。
自选作品实践: 模块化重构自选作品,制定并维护模块接口契约;编写项目的 AGENTS.md 控制面文件。
考核评价: 完成作业 A4(AI组织、系统约定与交接成功)。
U4 范围、集成与质量判断(第8—10周,12学时)#
目标对应: O1、O2、O3、O4。理论6学时、实践6学时。
经典工程命题与阅读入口:
- 第8周:《画蛇添足》(The Second-System Effect)与范围蔓延——初获成功后的过度设计倾向与功能失控。[B2]
- 第9周:《削足适履》(Ten Pounds in a Five-Pound Sack)与系统集成——文本合并(Merge)成功不等于行为逻辑正确。[B2]
- 第10周:缺陷的连锁反应与回归测试——修复一个错误却引入两个新Bug的恶性循环。[B2]
微实验落点(Micro Code Experiments):
- 第8周微实验:面对产品诱人的新增需求清单,执行“三不原则”评估,果断剔除过度设计功能,在 Issue 中锁定当前版本边界。
- 第9周微实验:Git自动合并成功(Merge passed),但运行测试时发现两个模块的内部状态产生竞态冲突;通过发起规范的合并请求(MR)并执行同伴代码评审(Code Review)拦截逻辑错误。
- 第10周微实验:AI助手宣称“Bug已完美修复”,但运行既有测试套件发现核心功能大面积破坏;编写针对性的回归测试用例,实施有效修复并确认全部测试变绿。
自选作品实践: 在 GitLab 建立 MR 流程,结对开展代码评审;为自选作品编写一套边界测试与回归测试用例。
考核评价: 完成作业 A5(范围控制、集成与回归测试)。
U5 进度与开放协作(第11—12周,8学时)#
目标对应: O1、O2、O5。理论4学时、实践4学时。
经典工程命题与阅读入口:
- 第11周:《祸起萧墙》(One Day at a Time)与里程碑治理——“项目是怎样延迟一年的?一次延迟一天”;真实进度度量。[B2]
- 第12周:《文档即系统》与开源工程合规——代码是写给人看、顺便给机器执行的;开源协议与公共资产化。[B2][G7][G8]
微实验落点(Micro Code Experiments):
- 第11周微实验:对比“口头汇报差不多快做完”与“自动化测试通过率+原子commit记录”两组进度表象,拆解出半天内可验收的微型里程碑。
- 第12周微实验:同伴互换作品盲测——仅依据仓库 README 搭建环境运行作品,指出一处文档疏漏并提交修复 PR;排查第三方依赖的开源许可证兼容性。
自选作品实践: 整理自选作品的完整 README、LICENSE(如 MIT/Apache-2.0)与贡献指南;处理同伴提交的 Issue 与修复建议。
考核评价: 完成作业 A6(阶段交付与开放协作)。
U6 复盘、迁移与交付(第13—14周,8学时)#
目标对应: O1—O5。理论4学时、实践4学时。
经典工程命题与阅读入口:
- 第13周:《抛弃型原型》(Plan to Throw One Away)与技术债务清偿——认识早期代码的局限并实施重构。[B1][B2]
- 第14周:成果封包与迁移验证——工程素养的个人内化与独立验证。
微实验与实战落点:
- 第13周实践:回看第1周写下的混沌逻辑,提炼通用函数与独立模块,清偿技术债务;基于真实过程证据完成 AI 协同效能复盘。
- 第14周考核:90分钟期末现场综合实操考核。在全新的业务场景与统一脚手架上,独立完成需求界定、AI受控辅助实现、Git原子提交与测试验证全闭环。
考核评价: 完成作业 A7(AI协同工程复盘)、A8(自选作品终期交付包)及期末现场综合实操考核。
五、教学实施与支持体系#
1. 180分钟常规教学闭环#
每次4学时按理论90分钟+实践90分钟交替组织,包含:
- 引出困境(15分钟):剖析经典工程故事,呈现现实开发矛盾;
- 问题与预测(20分钟):提出核心问题,组织学生预测行为;
- 基线实践(15分钟):运行微实验,复现错误现象或崩溃现场;
- 原理讲授(20分钟):讲授治理原理、契约规范与Git底层机制;
- 自选迁移(35分钟):将工程方法迁移应用至个人自选作品;
- 过程讲评(20分钟):抽查典型做法与常见认知偏差,现场比对;
- 深化验证(40分钟):完善测试用例,实施代码审查与分支操作;
- 反思复盘(15分钟):记录决策依据,整理原子提交。
2. 人机协同控制面准则#
- 意图先于代码:禁止在没有明确需求描述与输入输出契约的情况下直接要求AI写代码。
- 人类行使审查:AI生成的每行代码均须通过人类逐行审查(Diff Reading),禁止盲目接受全量覆盖。
- 单工作区串行写入:避免多个AI会话并发写入同一工作区,防范上下文漂移。
- 安全与脱敏红线:严禁将真实API密钥、个人敏感数据或未授权资源写入代码库或上传公网。
3. 故障容灾机制#
当外部网络或AI大模型服务出现异常时,实训室立即切换至预置的离线微实验与本地规则检查模式。学生依据预备的本地案例继续完成契约设计、代码审查、Git分支与测试验证,真实AI协作环节记录为待补做项,严禁使用虚构记录代替实操。
六、考核与评价标准#
课程成绩满分100分,由过程性考核(60%)与期末综合实操(40%)构成。
(一)过程性考核(8项作业,共60分)#
| 编号 | 截止周 | 考核任务 | 分值 | 核心评分指标 |
|---|---|---|---|---|
| A1 | 第1周 | 运行、完成标准与首次交接 | 8分 | 运行证据(2分);验收契约(2分);个人改动与解释(2分);同伴试用反馈(2分) |
| A2 | 第2周 | 版本差异审查、提交与受控恢复 | 8分 | 快照状态理解(2分);原子提交规范(2分);差异与验证(2分);受控安全恢复(2分) |
| A3 | 第4周 | 两套方案探索与分支合并取舍 | 8分 | 共同基线(2分);方案差异与标准(2分);分支协作证据(2分);合理取舍记录(2分) |
| A4 | 第7周 | 系统契约、AI上下文与无损交接 | 8分 | 接口Schema约定(2分);AGENTS.md规范(2分);交接接手验证(2分);个人贡献清晰(2分) |
| A5 | 第10周 | 范围控制、集成与回归测试 | 8分 | 三不原则执行(2分);MR代码评审(2分);有效测试用例(2分);回归测试与修复(2分) |
| A6 | 第12周 | 阶段交付与开放协作 | 8分 | 可验证微里程碑(2分);README无损复现(2分);有效贡献处理(2分);开源许可合规(2分) |
| A7 | 第13周 | AI协同工程复盘报告 | 6分 | 过程事实客观(2分);人机分工证据充分(2分);反思与改进明确(2分) |
| A8 | 第13周 | 自选作品终期工程封包 | 6分 | 仓库整洁规范(2分);完整测试可运行(2分);关键决策说明有据(2分) |
| 合计 | 60分 |
(二)期末现场综合实操考核(共40分)#
第14周组织90分钟闭卷现场实操考核。学生在统一发放的全新可运行微型工程基线上独立完成指定改进任务:
- 阶段一:任务分解与契约定义(前20分钟,独立完成,不开启AI)——分析需求,明确输入输出边界与三不原则,编写预期测试用例(8分);
- 阶段二:人机协同实现与差异审查(中间55分钟,允许统一AI协同)——受控使用AI生成代码,逐行审查差异,手工修正缺陷,保持Git原子提交(20分);
- 阶段三:回归验证与无损交付(最后15分钟)——运行回归测试套件,编写修改说明与限制,完成版本封包与提交(12分)。
七、编修订与审批记录#
| 项目 | 内容 |
|---|---|
| 编修订版本 | 2026.09.20-r1 |
| 修订日期 | 2026年9月20日 |
| 任课教师 | 周兵(延续平台登记信息,实际以教学单位安排为准) |
| 审定与批准 | 课程组审阅稿,教学采用与学校审批按校内规定办理 |
| 教务代码 | 待核定 |
依据编号与来源详见配套《依据与故事来源说明》。
参考资料#
来源核对日期:2026年9月20日。
[P0] 现行线上课程工作稿(本轮核对基线)
[P1] 《信通学院人工智能技术应用专业2026年高职人才培养方案》,第5—6、10、31页。
[B1] Brooks《人月神话》英文纪念版:出版方样章与序言
[B2] 出版方《人月神话》纪念版目录
[G1] Pro Git:版本控制
[G2] Pro Git:Git简史
[G3] Pro Git:Git模型
[G4] Git官方文档:diff
[G5] Git官方文档:restore
[G6] VS Code:源代码管理
[G7] GitLab:合并请求
[G8] Open Source Initiative:开源定义
具体中文译名、书目信息和页码以所购教材为准,本文不复制教材正文。
人机协同编程与工作流基础#
学期授课计划#
版本:2026.09.20-r1|修订日期:2026年9月20日|状态:课程组审阅稿
一、课程与授课信息#
| 项目 | 内容 |
|---|---|
| 学年学期 | 2026—2027学年第一学期 |
| 适用班级 | 2026级人工智能技术应用专业;实际班号按课表填写 |
| 课程性质 | 专业基础必修课;非群平台课 |
| 总学时 | 56 |
| 学分学时 | 3学分,56学时(理论28学时,实践28学时) |
| 实践分配 | 常规实践26学时,期末综合实操2学时 |
| 任课教师 | 周兵,实际安排以教学单位为准 |
| 标准依据 | 本课程标准2026.09.20-r1 |
| 核心教材 | 《人月神话》;按实际采购版选读,不虚填中文页码 |
| 平台与环境 | 校内GitLab;VS Code、Cline、校内私有化大模型服务、Git |
| 教学周 | 按课程教学周1—14编排,具体日历日期按校历填写 |
| 状态 | 课程组审阅稿,教学采用与审批按校内流程确认 |
基本口径依据高职人培方案[P1]与线上工作稿[P0]。每周4学时(每学时45分钟,共180分钟,课间休息不计入)。全学期共56学时,其中理论讲授28学时,常规实践26学时,期末现场综合实操考核2学时。课外自主学习时长单列,不计入课程56学时。
二、学期教学组织与工程双主线#
本课程以“宏观工程哲学 $\leftrightarrow$ 微观代码碰撞”为双主线驱动教学:
- 哲学与管理主线:以《人月神话》中的14个永恒困境统领各周主题,引导学生超越“代码编写工具人”视角,建立概念完整性、契约设计、上下文工程、组织协作秩序与不可伪造的质量证据意识。
- 微实验与作品主线:每周安排一个直击痛点的终端代码微实验(如依赖崩溃、覆盖丢失、并发拒推、Schema契约断裂、多智能体上下文污染、回归失效等);学生从四类入门脚手架(学习记录工具、知识卡片工具、数据清洗工具、交互自测工具)中选择方向,通过5阶段人机协同证据链(Intent $\to$ AI Plan $\to$ Human Review $\to$ Git Diff $\to$ Final Verdict)在个人作品上完成迭代与工程闭环。
常规周讲练采用180分钟交替循环:引出困境15分钟、问题与预测20分钟、基线实践15分钟、原理讲授20分钟、自选迁移35分钟、过程讲评20分钟、深化验证40分钟、反思复盘15分钟。
三、周次、主题与学时安排#
| 周 | 单元 | 本周工程命题与中心问题 | 理论 | 常规实践 | 实践考核 | 合计 |
|---|---|---|---|---|---|---|
| 1 | U1 | 做出一个东西,怎样才算完成?(焦油坑与交付标准) | 2 | 2 | 0 | 4 |
| 2 | U1 | 昨天还好好的,今天怎样找回?(没有银弹与受控恢复) | 2 | 2 | 0 | 4 |
| 3 | U2 | 为什么已经有版本工具,还要创造Git?(分布式与边界定义) | 2 | 2 | 0 | 4 |
| 4 | U2 | 一个想法,能不能保留两种做法?(外科手术团队与特性分支) | 2 | 2 | 0 | 4 |
| 5 | U3 | 每个部分都不错,为什么整体用不了?(概念完整性与Schema契约) | 2 | 2 | 0 | 4 |
| 6 | U3 | 多开几个AI,会更快吗?(布鲁克斯法则与多智能体上下文治理) | 2 | 2 | 0 | 4 |
| 7 | U3 | 怎样让另一个人或AI接着做?(巴别塔与现代上下文工程) | 2 | 2 | 0 | 4 |
| 8 | U4 | 有能力做更多,就应该做更多吗?(画蛇添足与三不原则) | 2 | 2 | 0 | 4 |
| 9 | U4 | 大家都说做完了,为什么还不能交付?(削足适履与系统集成评审) | 2 | 2 | 0 | 4 |
| 10 | U4 | AI说修好了,怎样确认?(缺陷连锁反应与回归测试套件) | 2 | 2 | 0 | 4 |
| 11 | U5 | 每天都很忙,进度在哪里?(祸起萧墙与真实进度度量) | 2 | 2 | 0 | 4 |
| 12 | U5 | 别人为什么愿意使用和改进你的作品?(文档即系统与开源资产化) | 2 | 2 | 0 | 4 |
| 13 | U6 | AI究竟帮助了哪一部分?(抛弃型原型与工程效能复盘) | 2 | 2 | 0 | 4 |
| 14 | U6 | 留下一份别人能够继续的成果(期末现场综合实操考核) | 2 | 0 | 2 | 4 |
| 合计 | 28 | 26 | 2 | 56 |
四、各周教学内容与课外学习#
第1周 做出一个东西,怎样才算完成?#
单元与学时: U1;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第1章《焦油坑》(The Tar Pit)。Brooks揭示了单个临时程序到编程系统产品(Programming Systems Product)之间高达9倍的开发成本鸿沟。 阅读入口:初版序言与第1章。[B1][B2]
中心问题: 本地电脑能跑通,与“可以交接给同伴运行”之间存在哪些本质鸿沟?AI生成代码后,人类必须确定哪些可观察的验收契约?
讲授内容: 输入—处理—输出(IPO模型);单机运行与工程交付;环境依赖与打包边界;5阶段证据链总览;人机责任边界与最小权限安全。
终端微实验(Micro Code Experiment): 运行崩溃实验。在缺少全局依赖的干净虚拟机或新终端窗口中直接执行同伴拷贝的未封装脚本,观察模块缺失或路径报错现象,体悟“在我的机器上能跑”不等于工程交付,体验依赖声明与自包含脚手架的重要性。
自选作品实践: 运行A类脚手架(简易学习记录工具),手工阅读关键执行路径,完成一处核心阈值参数修改(如最小有效时长)并验证;提出自选作品方向意向。
Git落点: 认识项目文件组织,理解可复现的工程起点;不把复杂的Git命令设为首周障碍。
AI参与控制面: AI可辅助解释代码逻辑与变量含义,但学生必须手工完成一处核心修改并用自然语言解释执行流。
当堂成果与评价: 完成作业 A1(运行证据、验收契约、个人手工修改与同伴反馈,共8分)。
课外学习: 完善A1记录;从四类脚手架中选择一个自选作品方向,写出三句核心意图(建议30分钟)。
第2周 昨天还好好的,今天怎样找回?#
单元与学时: U1;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第16章《没有银弹》(No Silver Bullet)。探讨软件工程的本质复杂性(状态多、变化快、不可见)与偶然复杂性;从对“历史不可追溯”的恐惧进入Git快照哲学。 阅读入口:版本控制概述与Git快照模型。[B1][G1][G3]
中心问题: 怎样既能保留大胆探索的自由,又能精准知道改动了什么、为什么改,并在误操作时安全回退?
讲授内容: 保存 vs 暂存 vs 提交;Git底层对象快照模型;工作区、暂存区(Index)与版本库(HEAD);原子提交(Atomic Commit)原则;非破坏性安全恢复。
终端微实验(Micro Code Experiment): 覆盖灾难与安全恢复。模拟手动保存多份“最终版_v1.js”、“最终版_v2_真的最终版.js”引发的误删与覆盖事故;在Git测试仓库中通过 git diff 观察未暂存变化,执行原子提交,并使用 git restore --worktree 精确恢复被恶意误删的核心函数,验证恢复前后一致性。
自选作品实践: 为自选作品建立第一个独立本地Git仓库,完成初始基线提交,建立 .gitignore 过滤系统缓存。
Git落点: git init、git status、git diff、git add、git commit -m、git log --oneline、git restore。
AI参与控制面: AI可协助审查差异并生成提交信息草稿,但学生必须逐行审查 git diff 并确认提交意图,禁止未经阅读直接无脑 git commit -a。
当堂成果与评价: 完成作业 A2(快照状态解释、原子提交、差异阅读与安全恢复验证,共8分)。
课外学习: 整理自选作品初始化基线,提交一次规范的原子提交日志(建议30分钟)。
第3周 为什么已经有版本工具,还要创造Git?#
单元与学时: U2;理论2学时,常规实践2学时。
经典工程命题与阅读: Git诞生史(2005年Linus Torvalds为Linux内核开发设计的分布式版本控制);集中式与分布式的哲学差异。 阅读入口:Pro Git第1章技术简史。[G1][G2]
中心问题: 当团队成员各自拥有完整的本地历史时,怎样既保持独立探索的自主性,又维护团队协同的统一秩序?
讲授内容: 集中式(CVCS)与分布式(DVCS)拓扑;本地分支、远程追踪分支与远程仓库;团队身份配置与权限;自选作品的“三不原则”(Out-of-Scope Rule)。
终端微实验(Micro Code Experiment): 并发推送冲突碰撞。两人结对克隆同一校内GitLab远程仓库,分别在本地修改同一文件的元数据并先后推送到远程 main 分支,后推送者遭遇 [rejected - non-fast-forward] 拒推报错;学习查看远程状态并排查原因。
自选作品实践: 正式为自选作品在校内GitLab创建远程仓库并建立关联;在项目根目录编写初版 PRD.md,严格声明“本项目当前绝不做的三件事”(三不原则)。
Git落点: git clone、git remote -v、git fetch、git push -u origin main。
AI参与控制面: AI辅助分析拒推原因,但学生必须亲自在终端核查远程配置与分支指针。
当堂成果与评价: 个人自选作品远程仓库连通、首个远程提交与“三不原则”声明;为A3积累证据。
课外学习: 细化自选作品第4周待实现的最小可行流程(MVP)设计(建议20分钟)。
第4周 一个想法,能不能保留两种做法?#
单元与学时: U2;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第3章《外科手术式团队》(The Surgical Team)与第11章原型探索合读。主程序员把握主线,多方案并行探索与增量构建。 阅读入口:第3、11章。[B2]
中心问题: 面对具有不确定性的技术方案,如何不污染稳定主干,同时进行两套方案的并行试验与客观取舍?
讲授内容: 主干保护(Protected Main);特性分支(Feature Branch)工作流;分支切换与工作区隔离;方案选型矩阵(性能、可读性、复杂度);基于证据的合并决策。
终端微实验(Micro Code Experiment): 双分支方案决斗。针对作品中的核心处理逻辑(例如数据排序或格式解析),分别创建 feat/plan-a-regex 与 feat/plan-b-split 两个特性分支独立实现;设计统一基准测试输入,对比两分支的执行结果与代码清晰度,决定将优胜分支合入主干并安全删除废弃分支。
自选作品实践: 在自选作品中通过特性分支完成第一条完整的端到端业务闭环(用户输入 $\to$ 核心处理 $\to$ 界面展示)。
Git落点: git branch、git switch -c、git branch -d、git merge。
AI参与控制面: 允许AI在两个分支分别生成不同思路的方案,但评价标准与测试对比必须由人类学生预先制定。
当堂成果与评价: 完成作业 A3(共同基线、双分支方案对比、合并取舍决策与MVP闭环,共8分)。
课外学习: 撰写A3方案取舍说明,记录废弃方案的保留理由或删除依据(建议30分钟)。
第5周 每个部分都不错,为什么整体用不了?#
单元与学时: U3;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第4章《概念完整性》(Conceptual Integrity)。系统设计中,一致性是衡量质量的最核心维度;体系结构(Architecture)必须先于独立实现。 阅读入口:第4章概念完整性主题。[B1][B2]
中心问题: 为什么各模块单测完全通过,联调时却全面崩溃?在AI可以秒级生成代码的时代,系统接口契约的决定性作用是什么?
讲授内容: 概念完整性与模块边界;接口契约设计;JSON Schema规范;字段命名统一(驼峰 vs 下划线)、单位定义与异常状态码契约;契约测试。
终端微实验(Micro Code Experiment): Schema契约断裂惨剧。运行预置的微型系统,数据采集模块输出带有嵌套字段的JSON对象,而数据处理模块按平面字典键名直接取值,触发 TypeError: Cannot read property of undefined 导致程序致命崩溃;学生通过制定并执行严格的 JSON Schema 接口契约修复集成故障。
自选作品实践: 审视自选作品的模块结构,将数据流接口抽离为独立的契约定义文件(如 schema.json 或接口常量声明),消除硬编码字段隐患。
Git落点: 将契约变更与模块实现关联为原子提交;利用 git log -S 追溯破坏契约的关键代码变更。
AI参与控制面: 向AI提出修改请求时,必须附带 Schema 契约约束,严禁由AI自行捏造数据字段名。
当堂成果与评价: 完成接口不一致的复现、Schema契约修复与回归记录;纳入A4。
课外学习: 补充完善个人作品的接口契约说明文档(建议20分钟)。
第6周 多开几个AI,会更快吗?#
单元与学时: U3;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第2章《人月神话》(Brooks's Law:向进度落后的项目增加人手只会使其更落后)。将团队沟通成本随人数激增的定律迁移至AI智能体协作场景。 阅读入口:第2章协作规模命题。[B2]
中心问题: 当盲目开启多个AI智能体并发生成代码时,为什么整体进度没有加速,反而引发了上下文漂移、命名混乱与严重的调试返工?
讲授内容: 沟通复杂度与任务解耦;串行依赖 vs 可并行任务;AI时代的上下文污染与幻觉放大;单工作区串行交互纪律;任务拆解与等待开销。
终端微实验(Micro Code Experiment): 多智能体并发污染灾难。学生在两个并行AI会话中同时要求修改同一份业务代码(一个做性能优化,一个增加错误捕获),将两份结果依次合入同一文件,产生大面积重名覆盖、全局变量冲突与语法错乱;对比转为“串行任务拆解+单点审查”后的交付质量,记录两者的时间与返工开销。
自选作品实践: 在自选作品中建立规范的“单次修改清单”,一次只让AI聚焦解决一个明确的小任务,杜绝大范围模糊指令。
Git落点: 独立实验在临时分支完成;掌握使用 git checkout -- <file> 丢弃被并发污染的脏修改。
AI参与控制面: 严格限定单次提示词的变更范围(Scope Limit),单次只允许修改不超过2个相关函数。
当堂成果与评价: 记录并发修改与串行修改的耗时、冲突数与返工代价对比;纳入A4。
课外学习: 总结属于自己的AI交互防污染军规(建议20分钟)。
第7周 怎样让另一个人或AI接着做?#
单元与学时: U3;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第7章《巴别塔》(The Tower of Babel)与第10章项目文档。团队失败往往源于信息断层;上下文工程是组织协同的生命线。 阅读入口:第7、10章。[B2]
中心问题: 当团队新成员或新开启的AI会话接手项目时,最少需要知道哪些核心信息才能做到无损继续开发?
讲授内容: 现代上下文工程(Context Engineering);AGENTS.md 规范的设计与落地;系统现状、禁止事项、代码风格与测试运行命令;无损交接标准。
终端微实验(Micro Code Experiment): 盲人摸象交接实验。结对同学交换电脑,原作者全程禁止口头交流;接收者仅凭项目内的 AGENTS.md 与项目说明,在5分钟内开启全新的AI对话完成一项小型缺陷修复;测试交接文档的完整性与自包含性。
自选作品实践: 为自选作品编写规范的 AGENTS.md 文件,包含项目意图、三不原则、接口规范、关键文件说明与运行测试指令。
Git落点: 将 AGENTS.md 作为核心资产纳入版本管理;用清晰的提交历史辅助交接者理解决策背景。
AI参与控制面: 在开启新对话时,首先将 AGENTS.md 作为系统上下文(System Prompt / Instructions)载入,验证AI理解规范后的代码采纳率。
当堂成果与评价: 完成作业 A4(系统契约规范、AGENTS.md落地、无损交接验证与个人贡献,共8分)。
课外学习: 依据同伴反馈修订个人作品的 AGENTS.md(建议30分钟)。
第8周 有能力做更多,就应该做更多吗?#
单元与学时: U4;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第5章《画蛇添足》(The Second-System Effect)。在初次尝试成功后,工程师极易落入功能膨胀、盲目增加高级特性的陷阱。 阅读入口:第5章。[B2]
中心问题: 面对AI强大的代码生成诱惑,工程师怎样抑制过度设计的本能,把有限精力聚焦在核心用户价值与稳定性上?
讲授内容: 功能蔓延(Scope Creep)的危害;MVP最小可行产品原则;功能优先级评估矩阵;需求剔除与版本冻结机制;Issue驱动开发。
终端微实验(Micro Code Experiment): 需求狂欢节裁剪。教师为每个作品强行派发3个“看似炫酷但极度复杂”的新增需求(如引入复杂的3D动画图表、过早引入云端分布式同步);学生依据“三不原则”进行严格评估,编写技术拒绝函,通过 GitLab Issue 记录推迟或剔除的理由。
自选作品实践: 在自选作品的 GitLab 仓库建立 Milestone 与 Issue 看板,冻结下一稳定版的功能清单,严格封锁范围蔓延。
Git落点: Issue 与分支绑定;使用语义化分支名(如 feat/issue-12-filter);在提交信息中关联 Issue 号。
AI参与控制面: 引导AI进行需求影响面与技术代价分析,但最终决定保留还是拒绝必须由人类做出。
当堂成果与评价: 需求裁剪决策记录、三不原则执行证据与版本发布计划;纳入A5。
课外学习: 梳理自选作品的待开发 Issue,确保每个 Issue 都有清晰的验收准则(建议20分钟)。
第9周 大家都说做完了,为什么还不能交付?#
单元与学时: U4;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第13章《削足适履》(Ten Pounds in a Five-Pound Sack)与系统集成。组件各美其美,整体协同丑陋;文本合并成功绝不等于系统集成成功。 阅读入口:第13章。[B2]
中心问题: 当Git提示自动合并无冲突(Auto-merge passed)时,为什么依然可能潜藏着严重的业务逻辑崩溃?代码评审(Code Review)不可替代的价值何在?
讲授内容: 文本合并 vs 逻辑正确性;合并冲突的底层原理(三方合并与共同祖先);GitLab 合并请求(MR)工作流;同伴代码评审的核心关注点(逻辑陷阱、未捕获异常、契约破坏)。
终端微实验(Micro Code Experiment): 静默冲突与集成陷阱。两个分支分别修改了同一函数调用的实参类型与默认参数,Git自动三方合并成功并未报错,但运行自动化测试时触发静默逻辑错误(数据被错误格式化);通过发起 GitLab MR 并在代码评审阶段借助审查清单拦截故障。
自选作品实践: 同伴之间建立交叉评审关系,在 GitLab 上为彼此的作品发起至少一次规范的 MR,完成至少2处有实质内容的评审意见回复与代码合入。
Git落点: git merge、冲突标记解读(<<<<<<<、=======、>>>>>>>)、解决冲突后的提交流程;GitLab Web 评审界面操作。[G7]
AI参与控制面: AI可协助审查潜在的未定义边界,但严禁以“一键接受AI合并”代替人工逻辑推演。
当堂成果与评价: 完成一条规范的 MR、同伴评审互动记录与合并测试验证;纳入A5。
课外学习: 整理代码评审中采纳的一项改进建议及其带来的代码质量提升(建议20分钟)。
第10周 AI说修好了,怎样确认?#
单元与学时: U4;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第13章系统测试与缺陷连锁反应。修复一个错误通常有20%—50%的概率引入一个全新的偶生缺陷;测试预期必须先于实现独立确立。 阅读入口:第13章缺陷治理。[B2]
中心问题: 当AI助手轻巧地声称“已为您修复Bug”时,怎样用确定性的工程手段戳破假象,守住软件的质量底线?
讲授内容: 缺陷复现(Reproduction);预期测试驱动(Test-First Verification);正常用例、边界用例与极端异常用例;回归测试套件(Regression Test Suite)设计;修复提交与回滚提交的区别。
终端微实验(Micro Code Experiment): 虚假修复与回归狙击。微实验提供一个既有功能完备但存在边界Bug的程序,学生让AI修复该Bug,AI给出的修复代码看似通过了新用例,但由于修改了公共数据结构,直接破坏了原有核心逻辑;运行事先编写好的回归测试套件,红色报警立刻戳破虚假修复,引导学生编写针对性修复并通过全量测试。
自选作品实践: 为自选作品建立包含至少5个核心测试用例的回归测试脚本,覆盖正常输入、空值、非法边界等场景。
Git落点: git commit --fixup、区分单文件 git restore 与使用 git revert 产生撤销提交的历史语义差异。[G4][G5]
AI参与控制面: 严禁为了“迎合AI实现”而随意降低或篡改测试用例的断言预期。
当堂成果与评价: 完成作业 A5(范围控制、MR评审、回归测试套件与真实Bug修复,共8分)。
课外学习: 完善自选作品的自动化测试脚本,确保终端一条命令即可执行全量回归(建议30分钟)。
第11周 每天都很忙,进度在哪里?#
单元与学时: U5;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第14章《祸起萧墙》(One Day at a Time)。“项目是怎样延迟一年的?一次延迟一天。”不可控的进度源于缺乏可验证的客观交付物。 阅读入口:第14章进度与里程碑主题。[B2]
中心问题: 怎样摆脱“差不多快做完了”的主观幻觉,用不可伪造的工程证据度量真实研发进展?
讲授内容: 可验收里程碑(Verifiable Milestones);完成的定义(Definition of Done, DoD);进行中(WIP)与已交付(Done)的区别;提交历史作为进展的唯一真理源。
终端微实验(Micro Code Experiment): 虚实进度对比。对比两组学生展示的进度:一组仅有口头说明和草稿代码,另一组具有通过自动化测试的规范原子提交树;剖析后者为何具备不可伪造的确定性,将一项被拖延的模糊任务拆解为两小时内可验证的微型里程碑。
自选作品实践: 全面对照自选作品的功能矩阵,依据 DoD(代码干净、测试通过、文档同步)清点真实完成情况,在看板上完成最终冲刺拆解。
Git落点: git log --graph --oneline 审查全项目提交脉络;核对每个提交是否符合原子性与独立可运行要求。
AI参与控制面: AI协助拆解任务清单,但任务规模与个人完成能力的匹配度必须由学生亲自把关。
当堂成果与评价: 真实的进度审计记录与期末冲刺任务拆解;纳入A6。
课外学习: 完成自选作品核心功能收尾,确保主分支始终保持绿色的可运行状态(建议20分钟)。
第12周 别人为什么愿意使用和改进你的作品?#
单元与学时: U5;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第15章《另外一面》(The Other Face)与开源协作规则。优秀程序面向机器,卓越工程面向人;开源协议与公共软件资产化。 阅读入口:第15章;开放源码定义。[B2][G7][G8]
中心问题: 一个代码仓库如何从私有玩具蜕变为具备公共协作价值的可靠开源资产?
讲授内容: 面向使用者的文档架构(README标准结构:背景、快速起步、使用示例、配置契约、贡献指南);主流开源许可证(MIT、Apache-2.0、GPL-3.0)的权利与义务;第三方依赖合规与安全漏洞防范。
终端微实验(Micro Code Experiment): 跨环境盲测复现。两位同学互换代码仓库链接,在全新的纯净终端环境中,不经过口头询问,严格按照对方 README 的安装与起步说明从零构建运行作品,记录遇到的卡点与阻碍,并向对方仓库提交一份改进文档的 Merge Request。
自选作品实践: 为自选作品配置规范的开源许可证文件(LICENSE),完善图文并茂、步骤自包含的 README.md。
Git落点: 标签管理 git tag -a v1.0.0-rc1;处理同伴提交的文档改进合并请求。
AI参与控制面: AI可协助润色文档文字,但文档中记载的每一条终端命令、参数说明与运行截图必须经由人类在真实环境实测验证无误。
当堂成果与评价: 完成作业 A6(阶段可验证交付、同伴盲测复现、README完善与开源许可证配置,共8分)。
课外学习: 处理同伴盲测提出的 Issue,发布作品的候选版本标签(建议30分钟)。
第13周 AI究竟帮助了哪一部分?#
单元与学时: U6;理论2学时,常规实践2学时。
经典工程命题与阅读: 《人月神话》第11章《抛弃型原型》(Plan to Throw One Away)与20周年纪念篇回顾。认识技术债务,勇于重构早期的脆弱逻辑;对人机协同展开基于证据的全景复盘。 阅读入口:第11、16章及纪念版回顾。[B1][B2]
中心问题: 在整个学期的开发中,AI究竟在哪些环节带来了实质提效,在哪些环节引发了误导与返工?人类的核心价值体现在哪里?
讲授内容: 架构重构策略(提炼函数、解耦依赖、消除重复);技术债务(Technical Debt)识别与偿还;AI协同效能归因模型;客观证据复盘方法(用提交日志、diff规模、测试修复率说话,拒绝主观编造)。
微实验与工程实操: 重构早期代码。学生调出第1周编写的初级逻辑,运用面向对象或模块化思想,将其重构为结构清晰、高内聚低耦合的高质量代码,并确保原有回归测试套件全量变绿;对照 Git 历史统计个人编写、AI辅助生成与代码审查的比例分布。
自选作品实践: 完成个人自选作品的终期封包与版本打标(git tag -a v1.0.0 -m "Release v1.0.0"),生成最终工程归档包。
Git落点: git tag、git archive、完整工程提交树复盘。
AI参与控制面: 使用AI辅助提取重构建议,但重构后的回归测试必须100%在本地执行通过。
当堂成果与评价: 完成作业 A7(AI协同工程复盘报告,6分)与 A8(自选作品终期工程封包,6分)。
课外学习: 准备第14周现场实操考核,回顾全套工程方法与终端操作(建议40分钟)。
第14周 留下一份别人能够继续的成果#
单元与学时: U6;理论2学时,实践考核2学时。
经典工程命题与情境: 完整工程交付与终生迁移;让接手者不仅能跑通程序,更能读懂每一个关键决策的来龙去脉。 阅读入口:课程方法论总结与高职专业发展指引。[P1]
中心问题: 面对一个全新的工程场景与限时任务,能否独立、规范地调动人机协同完成有质量保证的工程交付?
讲授内容: 前半段90分钟进行学期工程方法大复盘、匿名优秀工程案例展评、后续专业课程(Linux/Python/AIoT/开源工程)的协作接口衔接,以及期末综合实操考核纪律与环境说明。
期末综合实操考核(现场闭卷90分钟,满分40分): 考核在统一发放的全新可运行微型工程基线上展开,限时完成一个具体功能的改进与交付:
- 阶段一:需求契约与三不原则(前20分钟,独立完成,严禁开启AI)——分析需求边界,编写输入输出 Schema 契约与预期测试用例(8分);
- 阶段二:人机协同与差异审查(中间55分钟,允许统一AI协同)——受控运用AI生成实现代码,逐行审查
git diff,手工修正逻辑瑕疵,保持原子提交规范(20分); - 阶段三:回归验证与封包交付(最后15分钟)——运行回归测试确保全部通过,完善 README 变更说明,打上 release 标签并完成推送(12分)。
Git落点: 任务分支、原子提交、测试验证、版本打标与提交日志完整性检查。
AI参与控制面: 严格按照考试环境统一授权模型使用,故障时启用离线等效试题,保证公平可比。
当堂成果与评价: 期末现场综合实操考核(折合40分计入总评)。
课外学习: 无课后计分任务,自愿完成课程教学反馈与学习心得交流。
五、阶段作业与考核衔接#
| 编号 | 截止周 | 任务名称与核心考查点 | 分值 | 对应学习目标 |
|---|---|---|---|---|
| A1 | 第1周 | 运行、完成标准与首次交接(环境隔离、验收标准、手工修改解释、同伴反馈) | 8分 | O1, O4 |
| A2 | 第2周 | 版本差异审查、提交与受控恢复(Git快照理解、原子提交、diff阅读、git restore) | 8分 | O3, O4 |
| A3 | 第4周 | 两套方案探索与分支取舍(远程协作、特性分支、双方案选型对比、取舍证据) | 8分 | O2, O3 |
| A4 | 第7周 | 系统契约、AI上下文与无损交接(Schema规范、AGENTS.md落地、交接实测、个人贡献) | 8分 | O1, O2, O5 |
| A5 | 第10周 | 范围控制、集成与回归测试(三不原则、MR代码评审、回归测试套件、防虚假修复) | 8分 | O1, O3, O4 |
| A6 | 第12周 | 阶段交付与开放协作(微里程碑治理、README盲测复现、处理贡献、开源许可合规) | 8分 | O1, O2, O5 |
| A7 | 第13周 | AI协同工程复盘报告(基于真实Git数据的客观归因、人机分工证据、得失反思) | 6分 | O5 |
| A8 | 第13周 | 自选作品终期工程封包(完整仓库规范、回归测试全绿、关键工程决策说明) | 6分 | O1—O5 |
| 过程小计 | 8项过程性工程作业 | 60分 | ||
| 期末实操 | 第14周 | 新任务90分钟现场综合实操考核(契约设计、受控实现、差异审查、回归封包) | 40分 | O1—O5 |
| 课程总计 | 100分 |
所有作业证据均由平时Git开发过程自然产生,禁止期末突击补写虚假报告。
六、教学资源与保障措施#
1. 软件环境与工具链#
实训室机房统一配置:
- 编辑器与插件:VS Code 最新稳定版,Cline 智能体协同插件;
- 本地与私有AI:校内私有化部署的大语言模型服务(统一API端点与鉴权);
- 版本控制:Git 2.40+ 客户端,校内自建 GitLab 服务;
- 运行环境:内置 Node.js 22 LTS 与轻量现代浏览器环境。
2. 脚手架与参考资料#
- 前两周提供开箱即用的共同实验脚手架(含测试套件与可运行演示);
- 配套《人月神话》选读指导卡、Git速查手册、
AGENTS.md模板与回归测试范式; - 严密监控第三方依赖,不引入需要复杂云端配置的庞大框架,保护学生起步信心。
七、执行记录与审批#
| 记录项目 | 填写要求 |
|---|---|
| 实际日期、班级、授课教师 | 按教务课表与实际授课填报 |
| 实施情况与进度差异 | 记录各周微实验与自选作品进度,说明进度偏离原因 |
| 教学反思与调整 | 记录学生在各周出现的典型工程误解与实验改进点 |
| 审定与批准 | 经课程负责人与教学单位按规范办理确认 |
依据编号与可核查来源详见配套《依据与故事来源说明》。
参考资料#
来源核对日期:2026年9月20日。
[P0] 现行线上课程工作稿(本轮核对基线)
[P1] 《信通学院人工智能技术应用专业2026年高职人才培养方案》,第5—6、10、31页。
[B1] Brooks《人月神话》英文纪念版:出版方样章与序言
[B2] 出版方《人月神话》纪念版目录
[G1] Pro Git:版本控制
[G2] Pro Git:Git简史
[G3] Pro Git:Git模型
[G4] Git官方文档:diff
[G5] Git官方文档:restore
[G6] VS Code:源代码管理
[G7] GitLab:合并请求
[G8] Open Source Initiative:开源定义
具体中文译名、书目信息和页码以所购教材为准,本文不复制教材正文。