SuperAPI AI 工具集

confluence-hierarchy

办公与效率

查看项目

更新于 10-16 07:56

技能介绍

用途:该技能专门处理 Confluence 页面的父子、祖先与后代关系,适合查找父页/祖先页、列出直接子页或全部后代页、查看页面树结构,以及规划子页面排序。创建页面、移动页面、搜索页面应分别使用 confluence-page、confluence-search 等技能。

主要能力:提供 ancestors(获取祖先页,支持 --breadcrumb 面包屑与 --output json)、children(获取直接子页,支持 --limit(默认25,最大250)、--sort(title、id、created))、descendants(递归获取全部后代,支持 --max-depth、--limit(默认100,最大500))、tree(获取嵌套树形结构,支持 --max-depth 与 --stats 统计)、reorder(计算并展示建议的子页面顺序,支持传入逗号分隔的页面 ID 或 --reverse)。

必要用法示例:confluence hierarchy ancestors 12345 --breadcrumb;confluence hierarchy children 12345 --sort title;confluence hierarchy descendants 12345 --max-depth 2;confluence hierarchy tree 12345 --stats;confluence hierarchy reorder 12345 "200,201,202"。

涉及接口:GET /api/v2/pages/{id}/ancestors、GET /api/v2/pages/{id}/children、GET /api/v2/pages/{id}。

限制与风险:ancestors、children、tree 为只读操作;reorder 仅计算并显示新顺序,不会实际应用更改,真正调整顺序仍需在 Confluence 界面中拖放完成,且文档提到重排可能需要 API 更新才能完全生效。命令通过记录已访问页面避免无限循环,深度从直接子页的 1 开始计算;大型层级下树操作可能消耗较多资源,建议用 --max-depth 限制遍历深度。输出格式默认为 text,可用 json。