# CraftKit 项目资料

本目录保存当前项目供 Agent 使用的配置、开发规范、可复用知识和交接内容。

## 目录约定

- `project.json`：可共享的项目元数据和默认参数。
- `agents/`：项目对特定 Agent 的补充指令和示例。
- `standards/`：项目编码、文档、Git 和测试规范。
- `knowledge/pitfalls/`：经过验证的可复用问题经验。
- `knowledge/decisions/`：重要技术决策及其依据。
- `handoff/`：用户明确选择共享的任务交接。
- `local/`：仅当前工作副本使用的交接、记忆和运行状态。
- `cache/`：可重新生成的临时缓存。

共享目录可以按项目提交纪律进入 Git；`local/` 和 `cache/` 必须由本目录的 `.gitignore` 排除。不得在本目录保存凭据、令牌、私钥、个人机器绝对路径或无必要的个人信息。