Context Engineering Kit

一套面向 AI 辅助编程的项目上下文管理工具包。适用于 Claude Code，核心思想可迁移到任何 AI 编程工具。

快速开始

Solo 模式（默认）

/path/to/context-engineering-kit/install.sh

或指定目标项目

/path/to/context-engineering-kit/install.sh /path/to/your-project

团队模式

/path/to/context-engineering-kit/install.sh --team --user alice
然后进入 Claude Code，在目标项目中运行：

/init-context
初始化完成后的推荐项目结构：

your-project/
├── README.md ← 项目入口文档
├── CLAUDE.md ← AI 项目说明书
├── AGENTS.md ← 通用 Agent 工作规则
├── ARCHITECTURE.md ← 架构说明
├── TASKS.md ← 任务追踪
├── DECISIONS.md ← 决策日志
├── memory/ ← 短期状态（AI 维护）
│ ├── current_state.md
│ ├── bugs.md
│ ├── experiments.md
│ ├── lessons_learned.md
│ └── daily_log.md
├── prompts/ ← 编码规范（人工定义）
│ ├── common/
│ ├── typescript/
│ ├── python/
│ └── backend/
├── .claude/commands/ ← Claude Code 命令
│ ├── init-context.md
│ ├── start.md
│ └── wrap.md
└── src/ ← 你的源代码
install.sh 只安装命令和基础模板，不分析项目代码；/init-context 会读取现有项目，生成或补齐 CLAUDE.md、ARCHITECTURE.md、README 等项目专属上下文文件。若项目里已经有 CLAUDE.md，/init-context 会读取并补充缺失信息，不覆盖已有内容。

完整操作手册见 docs/usage-guide.md。

三个核心命令

命令 何时用 作用
/init-context 新项目首次 分析项目 → 创建/补齐上下文文件 → 生成项目专属文档
/start 每天开始工作 读文档 + git 状态 → 恢复上下文 → 等待指令
/wrap 每天结束工作 总结今天 → 更新 memory → 写日志
团队模式

使用 --team --user 安装后，目录结构变为：

project/
├── CLAUDE.md, AGENTS.md, ARCHITECTURE.md # 共享（git tracked）
├── DECISIONS.md # 共享，追加写入
├── TASKS.md # 共享
├── prompts/ # 共享
├── memory/
│ ├── TEAM.md # 共享 — 谁在做什么
│ ├── shared/ # 共享 — 团队整体状态
│ │ ├── current_state.md
│ │ └── bugs.md
│ └── {username}/ # 个人（gitignored）
│ ├── current_state.md
│ ├── daily_log.md
│ └── …
└── .cek # kit 元数据
关键设计：

个人 memory 被 .gitignore 排除，不会 merge 冲突
memory/TEAM.md 是团队成员状态表，/start 展示谁在做什么，/wrap 更新自己的行
.gitattributes 对 DECISIONS.md 等 append-only 文件设置 merge=union，减少冲突
模板可自定义：commands/、memory/、prompts/ 都可以按团队需求调整
升级

检查是否有新版本

/path/to/context-engineering-kit/doctor.sh

升级（覆盖 commands，不覆盖项目文件）

/path/to/context-engineering-kit/upgrade.sh
升级策略：

.claude/commands/ — 覆盖（用户很少改命令模板）
根级模板、memory/、prompts/ — 跳过（可能已自定义）
新增文件 — 创建（kit 新版本引入的新模板）
.cek — 更新版本号
健康检查

/path/to/context-engineering-kit/doctor.sh /path/to/your-project
doctor.sh 会检查必要文件、Claude Code 命令、AGENTS.md、占位内容、memory/current_state.md 更新时间、DECISIONS.md 重复编号、kit 版本和团队模式配置。

跨工具适配

工具 入口/规则
Claude Code CLAUDE.md + .claude/commands/
Codex AGENTS.md / repo instructions
Cursor .cursor/rules
Windsurf rules 文件
详细说明见 docs/tooling-guide.md。

每日工作流

/start → 编码工作 → /wrap
↑ │
└────────────────────┘ (循环)
/start — AI 读取项目文档和状态，30 秒恢复上下文
编码工作 — 小步 git commit，决策追加 DECISIONS.md
/wrap — AI 自动更新 memory 文件，为下次会话做准备
Kit 目录说明

context-engineering-kit/
├── install.sh 安装脚本（支持 --team --user）
├── upgrade.sh 升级脚本
├── doctor.sh 健康检查脚本
├── VERSION 版本号
├── CHANGELOG.md 变更日志
├── README.md 本文件
├── commands/ Claude Code 命令模板
│ ├── init-context.md 项目初始化
│ ├── start.md 恢复上下文
│ └── wrap.md 下班总结
├── templates/ 纯空模板（不含项目内容）
│ ├── AGENTS.md
│ ├── TASKS.md
│ ├── DECISIONS.md
│ ├── memory/
│ ├── prompts/
│ └── team/ 团队模式模板
│ ├── TEAM.md
│ ├── gitignore.append
│ └── gitattributes
└── docs/
├── usage-guide.md 使用指南
├── context-engineering-guide.md 完整开发指南
└── tooling-guide.md 跨工具适配指南
核心理念

真正高级的 AI 编程，不是"怎么提问"，而是"怎么管理上下文"。
状态外置化：项目状态写入文件，不依赖 AI 记忆
文档驱动：AI 每次通过文件恢复上下文，不靠对话历史
小步提交：Git 记录演化历史，AI 可读可回溯
决策留痕：记录"为什么"而不只是"做了什么"，防止 AI 推翻已定方案
详细指南见 docs/context-engineering-guide.md。