项目目录树生成

技能简介

project-tree 用于生成 ~/projects 文件夹的可视化目录树，自动过滤代码文件与依赖目录，仅保留文件夹和 Markdown 文件，并将结果写入 MEMORY.md 的 PROJECT_TREE 区块。

业务背景

技术团队项目繁多时，文档与代码混杂导致新人上手困难、协作效率低下。该工具自动生成清晰的项目结构图谱，过滤冗余文件仅保留核心骨架，让团队成员快速理解项目全貌，降低沟通成本，确保文档与实际目录始终保持同步。

落地案例：架构师老李负责交接五个遗留项目，手动整理目录耗时且易遗漏。运行 project-tree 后，系统自动扫描 ~/projects 生成可视化树状图，连续编号的脚本文件夹智能合并为 script[1-28]-video/，结果直接写入 MEMORY.md。新成员阅读后即可定位关键模块，交接周期从三天缩短至数小时。

能做什么

• 扫描指定目录并生成层级清晰的树状结构
• 智能合并连续编号文件夹（如 script1-video 至 script28-video 显示为 script[1-28]-video/）
• 自动更新 MEMORY.md，保持项目文档同步
• 支持配置扫描深度与排除目录

使用说明

安装要求：需已安装 Node.js 环境。将技能文件放置于 ~/clawd/skills/project-tree/ 目录下。

运行方式：

# 直接执行主脚本
node ~/clawd/skills/project-tree/scripts/project-tree.js

# 或使用快捷命令
~/clawd/scripts/update-tree

配置调整：编辑 scripts/project-tree.js 修改以下参数：

• MAX_DEPTH：显示层级深度（默认 3）
• EXCLUDE_DIRS：排除目录列表（如 node_modules、.git）
• ROOT_DIR：扫描根目录（默认 ~/projects）

自动化设置：可在每次 /reset 时自动更新目录树，需启用 internal hooks 并创建 reset-project-tree 钩子处理器。

输入与输出

见下方输入与输出表格。

风险提示

• MEMORY.md 中的 PROJECT_TREE 区块会被覆盖，请确保无重要手动内容
• 扫描大型目录可能耗时较长，建议合理设置 MAX_DEPTH
• hook 自动化需正确配置权限，避免执行失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/lachlanglasgow/project-tree/SKILL.md
来源类型：GitHub 仓库