twg-space-creation

twg-space-creation

与根命令 twg 配合使用。将来源转化为经过批准的信息架构和 Confluence 组合，然后创建并验证。twg-confluence 负责内容语义和写入安全；实时帮助负责变更语法。

CLI 启动器备用方案

运行 twg <command>。如果 shell 提示 command not found，则使用 $HOME/.local/bin/twg（macOS/Linux）/ $env:LOCALAPPDATA\Programs\twg\bin\twg.exe（PowerShell），然后告知用户将该目录添加到 PATH。不要将身份验证或命令错误视为 PATH 故障。

指导原则

构建可导航的空间，而不是凑对象数量。优先创建有用的枢纽，只询问重要问题，并在大量工作开始前展示成本。

工作流

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、数量、缺漏、未添加的说明和验证截断情况。

组合规则

• 文件夹仅用于导航，页面/实时文档用于叙述和决策，数据库用于重复性结构化工作，白板用于空间理解。不要在创建空间时加入基于时间的发布内容。
• 为每个数据库或白板指定一个所属页面；只有在有明确用途时才添加类型。
• 脚手架可以使用提示词、布局、表格和模板，但不得虚构所有者、决策、日期、指标、客户证据或系统行为。
• 根据受众调整来源材料；选择规范链接、综合整理、忠实导入或附件，而不是直接倾倒整个代码库。
• 每当选定一种创作格式时，都应按需加载 twg confluence content body-formats。此技能不会重复说明原始 HTML、CSV、SVG 或 ADF 规则。

停止条件

如果站点/来源尚未确定、需要跨站点改编、范围存在重大歧义，或请求仅涉及提案，则在写入前停止。缺少说明支持不妨碍创建。如果纵向切片不符，则停止扩展；绝不要用空间根目录替代尚未解决的父级。

参考资料

• references/proposal-flow.md — 信息收集、空间约定、审批、说明。每次运行都必须加载。
• references/blueprints.md — 以工作流为先的起始结构和规模选项。
• references/page-archetypes.md — 按页面用途进行丰富的内容组合。
• references/repo-discovery.md — 收集代码库证据，同时避免采用代码库式信息架构。
• references/twg-confluence-space.md — 稳定的创建和验证流程。

正文格式语法仅在实时 body-formats 指南中说明。