Back to Details

twg-space-creation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

twg-space-creation

twg-space-creation

Use with root 
twg
. Turn a source into an approved information architecture and Confluence mix, then create and verify it. 
twg-confluence
owns content semantics and write safety; live help owns mutation grammar.
配合根命令
twg
使用。将来源转换为经过审批的信息架构与Confluence组合，然后进行创建和验证。
twg-confluence
负责内容语义和写入安全性；实时帮助负责变更语法。

CLI launcher fallback

CLI启动器备选方案

Run 
twg <command>
. On shell 
command not found
, use 
$HOME/.local/bin/twg
(macOS/Linux) / 
$env:LOCALAPPDATA\Programs\twg\bin\twg.exe
(PowerShell), then tell user to add that directory to PATH. Do not treat auth or command errors as PATH failures.
运行
twg <command>
。如果shell提示
command not found
，请使用
$HOME/.local/bin/twg
（macOS/Linux）或
$env:LOCALAPPDATA\Programs\twg\bin\twg.exe
（PowerShell），然后告知用户将该目录添加到PATH中。请勿将认证错误或命令错误视为PATH问题。

Guiding principle

指导原则

Build a navigable space, not an object quota. Favor useful hubs, ask only material questions, and show cost before substantial work.
构建可导航的空间，而非追求对象数量。优先打造实用的枢纽，仅询问关键问题，并在开展大量工作前说明成本。

Workflow

工作流

  1. Resolve. Infer target, source, purpose, audiences, and workflows. Existing spaces are same-site only; reject mismatches before source reads or writes.
  2. Configure. Load 
    references/proposal-flow.md
    . Ask one compact batch only for missing identity/access, scale/richness, truth-boundary, or plan/build choices.
  3. Gather evidence. For a repository, load 
    references/repo-discovery.md
    ; for an existing space, inspect its tree, instructions, and a bounded body sample.
  4. Design. Load 
    references/blueprints.md
    and 
    references/page-archetypes.md
    . Present the tree, node jobs, companions, type counts, body modes/sources, instructions, exclusions, and a representative vertical slice.
  5. Approve. A precise request that already authorizes the displayed scope may proceed. Otherwise require create/refine/cancel confirmation. Always confirm a large, ambiguous, private, or synthetic build. Approval bounds the build; it does not authorize archive, delete, overwrite, or public links.
  6. Create in stages. Load 
    references/twg-confluence-space.md
    . Ledger the build; set/read instructions when supported; verify one branch and one of every selected type. Expand only families matching the approved semantics.
  7. Verify and hand off. Reconcile hierarchy, bodies, every structured/visual artifact, and supported instructions. Report URLs, counts, gaps, omitted instructions, and truncated verification.
  1. 解析：确定目标、来源、用途、受众和工作流程。现有空间仅限同站点使用；在读取或写入来源前，拒绝不匹配的情况。
  2. 配置：加载
    references/proposal-flow.md
    。仅针对缺失的身份/权限、规模/丰富度、事实边界或计划/构建选项，一次性提出简洁的问题。
  3. 收集资料：如果来源是仓库，加载
    references/repo-discovery.md
    ；如果是现有空间，检查其目录结构、说明文档和有限的内容样本。
  4. 设计：加载
    references/blueprints.md
    和
    references/page-archetypes.md
    。展示目录结构、节点用途、配套内容、类型数量、内容模式/来源、说明文档、排除项，以及具有代表性的垂直切片。
  5. 审批：如果是明确且已授权显示范围的请求，可直接推进。否则需要确认创建/优化/取消操作。对于大型、模糊、私有或合成构建，必须进行确认。审批仅限定构建范围；不授权归档、删除、覆盖或创建公开链接。
  6. 分阶段创建：加载
    references/twg-confluence-space.md
    。记录构建过程；在支持的情况下设置/读取说明文档；验证一个分支和每种选定类型中的一个实例。仅扩展符合已审批语义的内容系列。
  7. 验证与交付：核对层级结构、内容主体、所有结构化/可视化工件，以及支持的说明文档。报告URL、数量、缺口、未包含的说明文档和已截断的验证内容。

Composition rules

组合规则

  • Use folders only for navigation, pages/live docs for narrative and decisions, databases for recurring structured work, whiteboards for spatial understanding. Keep time-based publishing outside space creation.
  • Give each database or whiteboard an owning page; add a type only for a clear job.
  • Scaffolds may use prompts, layouts, tables, and templates, but must not invent owners, decisions, dates, metrics, customer evidence, or system behavior.
  • Adapt source material for its audience; choose a canonical link, synthesis, faithful import, or attachment rather than dumping a repository.
  • Load 
    twg confluence content body-formats
    just in time for every selected authoring format. This skill never restates raw HTML, CSV, SVG, or ADF rules.
  • 仅将文件夹用于导航，页面/实时文档用于叙事和决策，数据库用于重复的结构化工作，白板用于空间化理解。将基于时间的发布排除在空间创建之外。
  • 为每个数据库或白板指定一个所属页面；仅在有明确用途时添加类型。
  • 框架可使用提示、布局、表格和模板，但不得编造所有者、决策、日期、指标、客户案例或系统行为。
  • 根据受众调整来源材料；选择规范链接、综合内容、忠实导入或附件，而非直接转储仓库内容。
  • 仅在需要时加载
    twg confluence content body-formats
    以获取所选创作格式的指导。本技能绝不会重述原始HTML、CSV、SVG或ADF规则。

Stop conditions

终止条件

Stop before writes for unresolved sites/sources, cross-site adaptation, material scope ambiguity, or proposal-only requests. Missing instructions support does not stop creation. Stop expansion on slice mismatch; never replace an unresolved parent with the space root.
在写入前，若存在未解析的站点/来源、跨站点适配、重大范围模糊或仅为提案的请求，则终止操作。缺少说明文档支持不会终止创建。若切片不匹配则停止扩展；切勿用空间根目录替换未解析的父节点。

References

参考资料

  • references/proposal-flow.md
    — intake, space contract, approval, instructions. Load every run.
  • references/blueprints.md
    — workflow-first starting shapes and scale choices.
  • references/page-archetypes.md
    — rich composition by page purpose.
  • references/repo-discovery.md
    — repository evidence without repo-shaped IA.
  • references/twg-confluence-space.md
    — stable creation and verification flow.
Body-format syntax belongs exclusively to live 
body-formats
guidance.
  • references/proposal-flow.md
    — 需求收集、空间协议、审批、说明文档。每次运行都需加载。
  • references/blueprints.md
    — 以工作流为核心的初始结构和规模选项。
  • references/page-archetypes.md
    — 根据页面用途进行丰富组合。
  • references/repo-discovery.md
    — 不采用仓库式信息架构的仓库资料。
  • references/twg-confluence-space.md
    — 稳定的创建与验证流程。
内容格式语法仅属于实时的
body-formats
指导。