findscripter 何时使用
当用户需要在 Atlassian Confluence 中完成以下工作时使用：
- 新建或重构空间（Space），规划页面层级与导航；
- 配置空间权限方案（查看/编辑/创建/删除/管理）；
- 制作可复用的页面模板（会议纪要、项目概览、决策记录、复盘等），并嵌入宏；
- 在页面中嵌入 Jira 工单列表或图表、按标签聚合内容；
- 做知识库审计、定立命名规范、评审周期与归档策略等文档治理规范。
不该用于：操作 Jira 工单本身（建单/改状态用 Jira 相关技能）；非 Confluence 的知识库（飞书 wiki、Notion、语雀等，结构与宏语法不通用）；纯文档写作而不涉及空间/模板/权限架构。
步骤
- 定空间：先判定空间类型（团队 / 项目 / 知识库 / 个人），据此选权限方案与首页形态。
- 建空间：用清晰的
key+name+description创建，设置带概览的首页。 - 配权限：按方案授予 View/Edit/Create/Delete 与 Admin；验收——用非管理员测试账号访问，确认权限层级正确。
- 搭层级：建立 parent-child 页面树，导航深度不超过 3 层，命名一致，会议纪要带日期戳。
- 做模板：抽取可复用内容模式 → 建页加占位符与填写说明 → 用宏排版 → 存为模板 → 共享到空间或设全局；验收——先从模板建测试页确认占位渲染正常再共享。
- 接 Jira：需要时用
{jira}/{jirachart}宏嵌入工单与图表（与 Jira 技能协作）。 - 立治理：定义内容分类法、评审周期、归档策略与质量清单，并监控采用度。
指令
通过 Confluence MCP Server 调用核心操作：
// 新建空间
create_space({ key: "TEAM", name: "Engineering Team", description: "Engineering team knowledge base" })
// 在父页面下建子页（body 用 storage-format HTML）
create_page({ spaceKey: "TEAM", title: "Sprint 42 Notes", parentId: "123456", body: "<p>Meeting notes</p>" })
// 更新页面（version 必须递增，否则冲突）
update_page({ pageId: "789012", version: 4, body: "<p>Updated content</p>" })
// 删除页面
delete_page({ pageId: "789012" })
// CQL 检索
search({ cql: 'space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC' })
// 查子页以巡检层级
get_children({ pageId: "123456" })
// 打标签
add_label({ pageId: "789012", label: "archived" })
常用宏速查：
- 提示块：
{info}…{info}、{note}、{warning}、{tip} - 折叠：
{expand:title=Click to expand}…{expand} - 目录：
{toc:maxLevel=3} - 摘录复用：
{excerpt}…{excerpt}+{excerpt-include:Page Name} - Jira 工单：
{jira:JQL=project = PROJ AND status = "In Progress"} - Jira 图表：
{jirachart:type=pie|jql=project = PROJ|statType=statuses} - 标签聚合：
{contentbylabel:label=meeting-notes|maxResults=20} - 状态徽标：
{status:colour=Green|title=Approved} - 任务清单：
{tasks}- [ ] Task 1\n- [x] Task 2{tasks} - 日期：
{date:format=dd MMM yyyy} - 两栏布局：
{section}{column:width=50%}…{column}{column:width=50%}…{column}{section} - 面板/代码：
{panel:title=…|borderColor=#ccc}…{panel}、{code:javascript}…{code}
示例
推荐的空间页面树（≤3 层）：
Space Home
├── Overview & Getting Started
├── Team Information
│ ├── Team Members & Roles
│ ├── Communication Channels
│ └── Working Agreements
├── Projects
│ ├── Project A (Overview / Requirements / Meeting Notes)
│ └── Project B
├── Processes & Workflows
├── Meeting Notes (Archive)
└── Resources & References
常用模板及关键小节：
| 模板 | 用途 | 关键小节 |
|---|---|---|
| 会议纪要 | Sprint/团队会议 | 议程、讨论、决议、行动项（tasks 宏） |
| 项目概览 | 立项与状态 | Quick Facts 面板、目标、干系人表、里程碑（jira 宏）、风险 |
| 决策记录 | 架构/策略决策 | 背景、备选方案、决策、影响、下一步 |
| 冲刺复盘 | 敏捷仪式 | 做得好（info）、待改进（warning）、行动项（tasks）、指标 |
权限方案示例：团队空间——团队成员 View/Edit/Create，团队负责人 Admin，其他人无权限。
注意事项
update_page的version必须比当前版本大，否则乐观锁冲突；先读取再 +1。body默认是 storage-format（HTML），不是纯文本/Markdown；模板里的占位符需在共享前实测渲染。- 导航深度控制在 3 层内；命名规范、标签、所有者三者缺一会拉低可检索性。
- 治理基线：关键文档每月评审、标准文档每季度、归档文档每年；过期内容打
archived+ 日期标签，保留 2 年后删除并留审计痕迹。 - 需升级到 Atlassian Admin 的场景：组织级模板、跨空间权限、Blueprint 配置、全局自动化、空间导入导出——这些超出本技能范围。
- 健康巡检指标：长期未更新页、无所有者页、重复内容、坏链、空空间、孤立页。
互见
- Jira 相关技能：本技能用
{jira}/{jirachart}嵌入工单与图表，但建单、改状态、JQL 调试归 Jira 技能。 - 模板/Blueprint 配置：跨空间或全局模板需配合 Atlassian Admin。
本条采编自 alirezarezvani/claude-skills（MIT）。