Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Design & UI

multica-platform-confluence

Platform-layer skill (placeholder shell): read/write capability for Confluence / Wiki-class systems — pull existing pages for Agents to consume, land PRD / design artifacts and return a stable page link. Decoupled from the Issue system; called by artifact-orchestration skills. Concrete platform URLs / spaces / parent pages live in config.yaml, never in role prompts.

it235 · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add it235/multica-best-practices --skill multica-platform-confluence

About this skill


name: multica-platform-confluence description: Platform-layer skill (placeholder shell): read/write capability for Confluence / Wiki-class systems — pull existing pages for Agents to consume, land PRD / design artifacts and return a stable page link. Decoupled from the Issue system; called by artifact-orchestration skills. Concrete platform URLs / spaces / parent pages live in config.yaml, never in role prompts. metadata: layer: platform replaces: any Wiki / knowledge-base platform (Confluence / Yuque / Feishu Docs / Lanhua Docs / etc.)

Platform · Confluence (placeholder shell)

This is a platform-layer placeholder shell. The public multica-best-practices binds to no specific company's internal URLs or credentials. To onboard your own Wiki, only edit this skill's config.yaml and scripts/; all upstream roles and orchestration skills stay untouched.

Purpose

Provide read + write capability for "knowledge-base / Wiki" class platforms:

  • Read: fetch an existing page by pageId / title as Markdown for downstream Agents.
  • Write: land PRD / technical design artifacts to the team Wiki and return a stable page link.

Decoupled from multica-platform-jira (Issue system); this skill only handles Wiki, not Issue field writes. Role prompts never contain Wiki URLs / pageIds; swap platforms by swapping only this skill.

Default landing (team-configured)

Artifact typeWiki parent page (config.yaml)Local draft (Agent writes first)
PRDconfig.yaml → wiki.default_parent_page_idstructured by multica-requirement-analysis, landed by req-sync
Technical designconfig.yaml → wiki.design_parent_page_iddocs/design/<ISSUE-KEY>/design.md

Files (suggested structure)

multica-platform-confluence/
├── SKILL.md
├── config.yaml
├── .env.example
└── scripts/
    ├── credentials.sh
    ├── wiki.sh            # Read/Write CLI
    ├── fetch_page.py      # Wiki → local Markdown
    ├── publish_design.py  # Markdown design upsert
    └── lib/

Read (downstream / Leader pulls upstream artifact)

bash scripts/wiki.sh fetch-page <page_id> [output_dir] [issue_key]
bash scripts/wiki.sh get-page <page_id>
bash scripts/wiki.sh find-page "<title>" [space_key]

Write (artifact landing)

PRD page

bash scripts/wiki.sh create-page "<title>" "<parent_page_id>" "<html_or_md>" "<space_key>"

Called by multica-artifact-req-sync.

Technical design (Markdown → Wiki)

  1. @Architect writes local via multica-technical-design: docs/design/<ISSUE-KEY>/design.md.
  2. Publish under the design parent page:
python scripts/publish_design.py <ISSUE-KEY> docs/design/<ISSUE-KEY>/design.md \
  [--space SPACE] [--parent PAGE_ID] [--title "Title"] [--json]
  1. Return url / page_id from the JSON; multica-artifact-design-sync then calls the Issue-platform skill to write the link back to the Issue.

Upsert rule: same space + same title → update version; title may get an [AI] suffix (team-configurable).

Agent Compatibility

  • Credentials injected via runtime env vars (.env.example gives the variable-name template); never print passwords, never write into role prompts.
  • Confirm before external writes: space, parent pageId, title.
  • Prefer scripts/; do not call REST directly.

Adapting To A New Team

  1. Edit config.yaml: wiki.url, default_space, *_parent_page_id.
  2. Change the design-doc parent page ID to the team Wiki directory page.
  3. Maintain space / directory lists in spaces.json (if applicable).

Why it works

Wiki auth, spaces, and parent pages differ per team; isolating them in a platform skill means Issue-system / notification / Git-change scripts don't affect Wiki scripts, and PRD + design share one read/write capability. A swappable platform layer is the core of "copy-paste-run": role prompts only ever say multica-artifact-*-sync, and the real internal details stay in this layer.