62 lines
2.9 KiB
Markdown
62 lines
2.9 KiB
Markdown
# Project Conventions
|
||
|
||
> 本工作区属于用户 `__USERNAME__`，由 AbleFlow 平台开通时从模板生成。
|
||
|
||
## 工作边界 — 严格限定
|
||
|
||
本项目的所有操作**必须限制在 `/home/core/dev/__USERNAME__/` 内部**。
|
||
|
||
- **禁止**读取、修改、创建 `/home/core/dev/__USERNAME__/` 之外的任何文件
|
||
- **禁止**访问上级目录 `../`、`/home/core/dev/` 或其他兄弟项目
|
||
- **禁止**引用外部项目的代码、数据或配置
|
||
- 所有路径必须使用**绝对路径**或相对于项目根的路径
|
||
|
||
（以上边界同时由 `.claude/settings.json` 的权限规则强制执行。）
|
||
|
||
## Directory Structure
|
||
|
||
```
|
||
/home/core/dev/__USERNAME__/
|
||
├── CLAUDE.md # 项目约定（本文件）
|
||
├── .gitignore # Git 忽略规则
|
||
├── .mcp.json # MCP 数据源配置
|
||
├── index.html # 工作区看板
|
||
├── scripts/ # 脚本代码
|
||
├── workspace/ # 工作目录（按日期组织）
|
||
│ └── YYMMDD/ # 当日工作目录，如 260519
|
||
│ ├── data/ # 中间数据 (CSV/JSON)
|
||
│ ├── output/ # 生成产物 (pptx, xlsx, docx, zip)
|
||
│ └── README.md # 工作日志
|
||
├── wiki/ # auto-wiki 知识库（按主题隔离）
|
||
│ └── {topic}/ # 如 personal-pension、treasury-futures
|
||
│ ├── meta.yaml
|
||
│ ├── index.md
|
||
│ ├── data.db # 结构化数据（SQLite）
|
||
│ └── sources/ entities/ concepts/ analyses/
|
||
└── .claude/
|
||
├── settings.json # 权限规则（平台管理，请勿修改）
|
||
├── skills/ # Skill 仓库（git clone，平台统一升级，只读）
|
||
└── hooks/ # 自定义 hooks
|
||
```
|
||
|
||
## 文件管理规则
|
||
|
||
| 类型 | 存放位置 |
|
||
|------|---------|
|
||
| 日常工作 | `workspace/YYMMDD/`，配 README.md 记录进展，跨日任务沿用起始日目录 |
|
||
| 一次性脚本 | 所属工作目录内，不散落根目录 |
|
||
| 知识沉淀 | `wiki/{topic}/` |
|
||
| 根目录 | 零污染：不允许留下临时文件、中间产物 |
|
||
|
||
## Git
|
||
|
||
本目录是一个 Git 仓库，远端为 `git.ablemind.cc/__USERNAME__/workspace`（私有）。阶段性成果请提交并 push，作为版本史与备份。`.gitignore` 已排除中间数据与大产物。
|
||
|
||
## 记忆
|
||
|
||
Claude Code 的跨会话记忆由运行时自动管理（位于 `~/.claude/projects/` 下），随平台持久化，无需手动维护目录。
|
||
|
||
## 模型与密钥
|
||
|
||
模型配置（`ANTHROPIC_*`）由平台写入 `~/.claude/settings.json`，可在 flow.ablemind.cc 的设置页查看与修改，不要写进本目录的任何文件。
|