项目说明CLAUDE.md
你可能会问:项目说明 在我的项目里到底管哪件事,什么时候该用?
在项目开始前,把每次都要遵守的事实、边界和验证方式说清楚。
把每次进项目都要知道的店规,放在门口第一块牌子上。
像工厂的新员工手册:哪些机器不能碰、怎么验货,一进门就能看到。
外贸独立站里,说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。先把这件事的输入、责任边界和可验证结果说清,再让 AI 或协作者继续实现。
项目说明 在项目中负责什么
- 什么时候用
- 每次进入项目都必须知道目录结构、技术约束、测试命令或业务禁区时。
- 它解决什么
- 它减少重复说明,把项目习惯显式化,让新会话和新成员更快进入状态。
- 它不负责什么
- 它不适合堆积临时细节或长步骤手册。稳定事实留下,流程知识沉淀到 Skill。
- 放进真实项目
- 说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。
项目说明保存每次进入项目都必须知道的稳定事实
新会话开始时如果不知道目录、构建命令、禁改区域和业务边界,哪怕代码能力很强也容易从第一步走偏。
- 01
只写稳定、会反复影响决策的信息。
- 02
把长流程拆到按需 Skill。
- 03
随项目变化更新并删除过期规则。
把概念放进真实场景
1 / 3把 项目说明 放进外贸独立站的一次真实协作
前提先补齐条件
每次进入项目都必须知道目录结构、技术约束、测试命令或业务禁区时。
记住它的责任项目说明
稳定事实写项目说明,临时想法别塞进去。
外贸出海映射放回真实项目
外贸独立站里,说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。先把这件事的输入、责任边界和可验证结果说清,再让 AI 或协作者继续实现。
不同词条会用路线、层级、状态、对照或清单来呈现;点击每一步,检查它在真实工作中的责任位置。
稳定事实写项目说明,临时想法别塞进去。
容易混淆的地方
项目说明不是百科全书;长流程应拆到按需加载的 Skill。
项目说明越来越长:既有长期技术约束,也有昨天的报错全文和一条过期活动文案。应该怎样整理?
你可以这样告诉 AI Agent
“
我在处理这件事:说明仓库用途、受保护目录、构建命令和不能触碰的业务数据。请以“项目说明”为主线,先说明它在这里负责什么、不负责什么;再列出必要输入、建议动作和可验证结果。用外贸独立站的业务语言回答,不确定的信息标为待确认。
内容依据与延伸
本站用原创中文解释把专业概念映射到外贸独立站;定义和机制继续以官方资料为准,业务例子再回到 外贸独立站询盘优化实战 验证。
本站整理说明:本地资料:Claude Code 项目配置与工作流