# agentic-programming

**Repository Path**: phyzy/agentic-programming

## Basic Information

- **Project Name**: agentic-programming
- **Description**: AI辅助编程教程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agentic Programming

面向本科生的 AI 辅助编程课程资料仓库。

本仓库面向“只有 Python 基础，或具有基础 Python/C++ 能力”的本科生，提供一门 AI 辅助编程选修课的可落地教学材料。

课程默认限制在 DeepSeek、GLM/智谱清言、Trae 等可免费试用或低成本使用的 AI 工具，以及 Python、Git、VS Code、pytest 等免费工程工具范围内。核心实验不要求学生购买付费订阅或充值 API。

## 目录结构

- `course-outline/`：16 学时与 32 学时课程大纲、考核方式、课时映射。
- `course-outline/course-outline-64h-plan.md`：64 学时“AI 辅助编程与 AI 时代软件工程”规划文档，暂不执行教材和实验扩写。
- `resource/`：相关课程、工具文档、论文案例、图片与视频资源索引。
- `lessons/`：每次课的教案。32 学时版本使用 16 次课；16 学时版本使用前 8 次核心课。
- `textbook/`：LaTeX 数字教材，按章节拆分，包含本地流程图与媒体资源索引。
- `practice-guide/`：配套实践指导书，包含 12 个操作实验、报告模板和 AI 使用日志模板。
- `docs/superpowers/specs/`：课程设计规格说明。

## 课程定位

课程采用“工程实践进阶 + 教师可落地”的组合方案：不假设学生掌握复杂软件工程或机器学习，只要求能够阅读和修改基础 Python 程序。课程强调 AI 工具使用、任务拆解、调试、测试、代码审查、学术规范与综合项目交付。

## 工具范围与实测

- 工具边界见 `resource/free-toolchain.md`。
- 教师课前实测清单见 `resource/teacher-test-checklist.md`。
- 真实 API 调用、Trae 项目级功能、模型联网访问等内容均需教师在本校环境中提前测试；课堂核心任务均提供本地 CSV/JSON 或教师预存 AI 输出作为备用方案。

## 编译教材

主教材：

```bash
cd textbook
PATH=/Users/xz/texlive/2026/bin/universal-darwin:$PATH latexmk -xelatex main.tex
```

实践指导书：

```bash
cd practice-guide
PATH=/Users/xz/texlive/2026/bin/universal-darwin:$PATH latexmk -xelatex main.tex
```