用项目证明 AI 编程能力

AI 编程作品集准备方法：如何用项目 README、功能记录、diff、验收结果和复盘证明自己会用 Claude Code 做真实开发。

求职时，最能证明 AI 编程能力的不是一句“熟练使用 Claude Code”，而是一个能被追问、能展示过程、能说明自己判断的项目。

一个好的 AI 编程作品集，要证明两件事：

1. 有开发基础，能理解项目。
2. 会用 Claude Code 提升效率，并且能控制风险。

项目不要只展示结果

很多作品集只放最终截图或演示地址，这还不够。

面试官真正关心的是：

• 这个项目是不是你理解过。
• 关键功能是不是你能讲清楚。
• AI 参与了哪些环节。
• 你怎么判断 AI 改得对不对。
• 项目是否经过验收和复盘。

所以作品集要展示“过程证据”。

建议准备的 6 类材料

这些材料不需要写得很长，但要真实、清楚、可追问。

README 应该怎么写

README 可以按这个结构：

# 项目名称

## 项目背景
这个项目解决什么问题，面向什么用户。

## 技术栈
前端、后端、数据库、部署方式。

## 核心功能
1. 功能 A
2. 功能 B
3. 功能 C

## 我的工作
说明自己负责的模块、功能和优化。

## Claude Code 协作方式
说明 CC 用在需求拆解、代码阅读、Bug 排查、文档整理、测试补充等环节。

## 验收方式
说明怎么运行、怎么测试、怎么确认功能正确。

## 复盘
遇到的问题、解决方式、后续优化方向。

不要把 README 写成工具宣传页。项目本身要站得住，AI 协作只是其中一部分。

AI 协作记录怎么写

推荐用任务记录，而不是聊天截图。

示例：

任务：新增订单筛选条件

目标：
- 在订单列表增加状态筛选和关键词搜索。
- 保持原有分页逻辑不变。

Claude Code 参与：
- 只读分析订单列表组件、接口请求和状态管理。
- 生成改动计划。
- 辅助实现筛选参数拼接和空状态处理。

我的审查：
- 检查 diff 是否只涉及订单列表相关文件。
- 确认分页切换、筛选重置、接口异常不受影响。
- 本地运行后按 5 条路径完成验收。

这种记录能体现工程过程。

代表性 diff 怎么选

不要展示大段无意义改动。选择最能说明能力的 2 到 3 个改动：

• 一个功能新增。
• 一个 Bug 修复。
• 一个质量提升，比如测试、文档、重构或错误处理。

每个 diff 配一段说明：

这次改动涉及 3 个文件：
1. 页面组件：增加筛选 UI 和状态。
2. API 调用：增加查询参数。
3. 文档：补充筛选规则。

重点风险：
- 分页状态是否正确重置。
- 空结果是否展示正常。
- 旧参数是否兼容。

验收方式：
- 本地运行页面。
- 分别验证默认列表、状态筛选、关键词搜索、空结果和接口异常。

这比只放截图更能证明真实开发能力。

验收记录怎么准备

验收记录可以很简单，但必须具体。

示例：

验收日期：2026-06-18

验证内容：
1. 页面首次进入正常加载。
2. 关键词搜索能正确传参。
3. 状态筛选能正确切换。
4. 清空筛选后列表恢复默认。
5. 接口异常时页面展示提示。

结果：
- 以上路径均通过。
- 剩余风险：移动端筛选布局还可以进一步优化。

这类记录会让面试官看到你有交付意识。

项目怎么和 AIGC 编程网衔接

如果开发基础还不够，先通过 AIGC 编程网 做实战项目，把项目能力练出来。

然后回到本站，用 Claude Code 做这些事情：

• 让 CC 帮你梳理项目结构。
• 让 CC 帮你找可以优化的功能点。
• 让 CC 帮你写 README 初稿。
• 让 CC 帮你生成验收清单。
• 让 CC 帮你做代码审查。
• 让 CC 帮你总结项目复盘。

这样项目会从“能跑”变成“能讲、能验、能面试”。

作品集首页可以怎么写

可以准备一个作品集总览：

这是我的 AI 编程实战作品集。

我使用 Claude Code 作为工程协作工具，主要用于项目分析、任务拆分、Bug 排查、代码审查、文档整理和验收清单生成。

每个项目都会保留：
- 项目说明
- 核心功能
- 关键改动记录
- 验收方式
- AI 协作复盘

我不会把 AI 生成代码直接当作交付结果，所有关键改动都会经过 diff 审查和运行验证。

这段话适合放在个人网站、GitHub Profile 或作品集首页。

最后检查

提交作品集前检查：

• 项目能不能正常运行。
• README 是否讲清楚背景、技术栈和功能。
• 是否有 2 到 3 个代表性改动记录。
• 是否写清 Claude Code 参与了什么。
• 是否写清自己负责了什么判断。
• 是否有验收记录和复盘。