76 lines
3.6 KiB
Markdown
76 lines
3.6 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 数据源配置
|
||
├── 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 # 权限规则 + hooks（平台管理，请勿修改）
|
||
├── skills/ # 预装技能（见下），可自行从技能商场添加
|
||
└── hooks/ # 自定义 hooks（已预置 auto-wiki 提醒）
|
||
```
|
||
|
||
## 预装技能（.claude/skills/）
|
||
|
||
模板已内置一组基础技能，开箱即用：
|
||
|
||
| 技能 | 作用 |
|
||
|------|------|
|
||
| `find-skills` | 发现并安装更多技能 |
|
||
| `skill-creator` | 创建自定义技能脚手架 |
|
||
| `auto-wiki-cn` | 知识编译器，把研究产出增量沉淀进 `wiki/{topic}/`（触发词：ingest / 整理进 wiki / recall） |
|
||
| `humanizer-zh` | 中文文本去 AI 痕迹、自然化 |
|
||
| `docx` `xlsx` `pdf` `pptx` | Word / Excel / PDF / PPT 读写生成 |
|
||
| `plotly` | 交互式图表 |
|
||
|
||
**添加更多技能**：到技能商场检索所需技能，复制其 `git clone` 命令克隆到 `.claude/skills/<技能名>/` 即可生效。这些技能归你自己管理，不随平台升级。
|
||
|
||
## 文件管理规则
|
||
|
||
| 类型 | 存放位置 |
|
||
|------|---------|
|
||
| 日常工作 | `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 的设置页查看与修改，不要写进本目录的任何文件。
|