AI 协作›项目说明

项目说明CLAUDE.md

你可能会问:项目说明 在我的项目里到底管哪件事,什么时候该用?

专业定义

在项目开始前,把每次都要遵守的事实、边界和验证方式说清楚。

大白话

把每次进项目都要知道的店规,放在门口第一块牌子上。

生活类比

像工厂的新员工手册:哪些机器不能碰、怎么验货,一进门就能看到。

外贸出海场景

外贸独立站里,说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。先把这件事的输入、责任边界和可验证结果说清,再让 AI 或协作者继续实现。

先建立专业坐标

项目说明 在项目中负责什么

什么时候用
每次进入项目都必须知道目录结构、技术约束、测试命令或业务禁区时。
它解决什么
它减少重复说明,把项目习惯显式化,让新会话和新成员更快进入状态。
它不负责什么
它不适合堆积临时细节或长步骤手册。稳定事实留下,流程知识沉淀到 Skill。
放进真实项目
说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。
专业拆解 · 业务场景

项目说明保存每次进入项目都必须知道的稳定事实

新会话开始时如果不知道目录、构建命令、禁改区域和业务边界,哪怕代码能力很强也容易从第一步走偏。

  1. 01

    只写稳定、会反复影响决策的信息。

  2. 02

    把长流程拆到按需 Skill。

  3. 03

    随项目变化更新并删除过期规则。

把概念放进真实场景

把 项目说明 放进外贸独立站的一次真实协作

1 / 3
前提先补齐条件

每次进入项目都必须知道目录结构、技术约束、测试命令或业务禁区时。

记住它的责任项目说明

稳定事实写项目说明,临时想法别塞进去。

外贸出海映射放回真实项目

外贸独立站里,说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。先把这件事的输入、责任边界和可验证结果说清,再让 AI 或协作者继续实现。

不同词条会用路线、层级、状态、对照或清单来呈现;点击每一步,检查它在真实工作中的责任位置。

一句话记住

稳定事实写项目说明,临时想法别塞进去。

容易混淆的地方

项目说明不是百科全书;长流程应拆到按需加载的 Skill。

随堂一练 用一个判断把概念记住

项目说明越来越长:既有长期技术约束,也有昨天的报错全文和一条过期活动文案。应该怎样整理?

你可以这样告诉 AI Agent

“

我在处理这件事:说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。请以“项目说明”为主线,先说明它在这里负责什么、不负责什么;再列出必要输入、建议动作和可验证结果。用外贸独立站的业务语言回答,不确定的信息标为待确认。

内容依据与延伸

本站用原创中文解释把专业概念映射到外贸独立站;定义和机制继续以官方资料为准,业务例子再回到 外贸独立站询盘优化实战 验证。

本站整理说明:本地资料:Claude Code 项目配置与工作流
就地查词 · 关闭后继续阅读