# 人机协同编程与工作流基础 课程描述

来源提交：657dd77927bb84309ef4aa6b3c87c6e33ba69f0e
状态：课程组审阅稿。这是与网页相同范围的阅读下载，人员明细/内部批注按发布约定移除。文中图片链接指向获准的站点资源，单独下载此Markdown不包含离线图片。

# 人机协同编程与工作流基础
## 课程描述

版本：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阶段协同证据闭环：
1. **意图声明（Intent）**：在开始编码前，人类学生必须清晰阐述本次修改的业务意图、输入输出契约及验收标准（Issue / PRD）。
2. **方案设计（AI Plan）**：AI智能体提出任务拆解与实现步骤，明确影响的文件范围。
3. **人类审查（Human Review）**：人类工程师行使审查权，核实方案是否符合概念完整性与安全边界，做出调整或放行。
4. **代码差异与测试（Git Diff & Test）**：在本地工作区执行修改，先运行既有测试守护底线，再通过 `git diff` 逐行审查变更细节，执行新增验证用例。
5. **决策归档（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] [现行线上课程工作稿（本轮核对基线）](https://ai.openkub.com/courses/human-ai-programming/)

[P1] 《信通学院人工智能技术应用专业2026年高职人才培养方案》，第5—6、10、31页。

[B1] [Brooks《人月神话》英文纪念版：出版方样章与序言](https://www.informit.com/content/images/9780201835953/samplepages/0201835959.pdf)

[B2] [出版方《人月神话》纪念版目录](https://www.informit.com/store/mythical-man-month-essays-on-software-engineering-anniversary-9780201835953)

[G6] [VS Code：源代码管理](https://code.visualstudio.com/docs/sourcecontrol/overview)

具体中文译名、书目信息和页码以所购教材为准，本文不复制教材正文。