name: confluence-deep-reader description: 读取Confluence页面并递归探索其子页面,最多3层深度。当用户想要全面阅读Confluence页面树、理解层次化文档或分析父子页面内容时使用。
Confluence深度阅读器
此技能指导您递归读取Confluence页面及其后代,最多3层深度。
何时使用此技能
在以下情况使用此技能:
- 用户提供Confluence链接并希望阅读“所有内容”或“所有相关页面”
- 用户要求“阅读此页面及其子页面”
- 用户想要理解Confluence页面的完整内容树
- 用户需要对层次化文档进行全面分析
工作流程
步骤1:读取起始页面
使用 getConfluencePage 读取用户提供的初始页面。
步骤2:发现子页面
使用 getConfluencePageDescendants 查找当前页面的所有子页面。此工具返回后代的分层结构。
步骤3:读取每个子页面(深度1)
对于找到的每个子页面:
- 使用
getConfluencePage读取其内容 - 跟踪这是深度1
步骤4:递归探索更深层次
对于在步骤3中读取的每个子页面:
- 使用
getConfluencePageDescendants检查它是否有自己的子页面 - 如果存在子页面且当前深度 < 3:
- 读取每个孙子页面(深度2)
- 重复此过程以探索深度3
重要:在深度3停止。 不要探索起始页面超过3层的页面。
步骤5:综合信息
在读取深度限制内的所有页面后:
- 按层次组织信息
- 提供全面摘要或回答用户的问题
- 注意是否有未探索的更深层次(超过深度3)
深度跟踪
跟踪当前深度级别:
- 深度0:起始页面(用户提供的页面)
- 深度1:起始页面的直接子页面
- 深度2:孙子页面
- 深度3:曾孙页面(在此停止)
最佳实践
- 显示进度:让用户知道您正在阅读哪些页面(例如,“正在读取主页面…找到5个子页面…正在读取子页面1/5…”)
- 尊重限制:永远不要超过深度3
- 高效处理:如果有很多页面(>20),考虑询问用户是否希望继续或专注于特定部分
- 优雅处理错误:如果页面无法访问,记录下来并继续处理其他页面
- 提供结构:当呈现结果时,保持分层结构,以便用户理解页面关系
使用示例
用户:“阅读此Confluence页面及其所有子页面:[链接]”
您的工作流程:
1. 读取起始页面(深度0)
2. 使用getConfluencePageDescendants查找其子页面
3. 读取每个子页面(深度1)并查找它们的子页面
4. 读取每个孙子页面(深度2)并查找它们的子页面
5. 读取每个曾孙页面(深度3)- 停止
6. 将所有信息综合成一个全面摘要
何时要求澄清
- 如果树中有50+个页面,询问用户是否希望处理所有页面或专注于特定分支
- 如果用户要求“深度超过3层”的内容,解释限制并提供专注于特定深层分支的选项