customer-workspace

客户工作区

在不将设置产物与实时记录混淆的前提下，设置或操作客户工作区。

何时使用

• 为每个客户创建工作区。
• 操作现有工作区：收件箱更新、会议纪要、问题、行动、工作流或交接。
• 添加客户信息路由或会议纪要工作流。
• 在交接前查看当前负责人、下一步行动和源记录。

先选择模式

在选择操作之前先检查工作区。当工作区包含任何受管理记录（例如 .github/copilot-instructions.md、.github/prompts/、workspace-summary.md、_customer/profile.md、_inbox/ 或 workstreams/）时，将其视为已存在。 聚合运营工作区可能包含轻量级的 Customers/{id}/ 配置文件、任务列表、收件箱和会议。不要在这些记录之上初始化完整的客户工作区；如果需要专门的客户管理，请指定一个单独的目标。

模式	使用时机	首个操作
设置	不存在受管理结构	创建脚手架并记录路由事实。
操作	受管理工作区接收到新信息	为输入更新规范记录。
查看 / 交接	请求状态、所有权或连续性	先读取当前索引，并报告来源、负责人和下一步行动。

• 除非明确要求覆盖生成的资产，否则不要在现有工作区中重新运行初始化程序或使用 -Force。
• 现有记录具有权威性。只添加明确请求且缺失的资产；绝不要用模板替换实时笔记、任务或工作流记录。

---

设置新工作区

# Basic
.\scripts\Initialize-CustomerWorkspace.ps1 -CustomerName "Contoso Inc"

# Full options
.\scripts\Initialize-CustomerWorkspace.ps1 `
  -CustomerName "Contoso Inc" `
  -ContractType "Ongoing support" `
  -ContractPeriod "2025/04 - 2028/03" `
  -KeyContacts "John Doe (Infra Lead)"

如果 PowerShell 不可用，请手动创建相同的文件夹，并仅从 assets/ 复制所需的提示词和模板文件。

仅在受管理结构不存在时使用设置。当受管理资产存在时，初始化程序默认停止；只有在明确批准替换生成的提示词和模板时才使用 -Force。

设置信息采集

仅记录路由事实：工作区范围、共享边界、本团队别名、关键角色、会议节奏和主要输入。将详细技术清单留到后续的收件箱和会议记录中。

规范记录

需求	规范记录
导航和交接	README.md、workspace-summary.md
原始更新和未决问题	_inbox/、_questions/
客户上下文	_customer/profile.md
会议和后续跟进	meeting-notes/、next-actions/
持续范围和详细历史	workstreams/、pj_{topic}/
交付物和可复用经验	research-reports/、_knowledge/

Initialize-CustomerWorkspace.ps1 会创建受管理脚手架及其模板。仅在运营工作流需要时创建工作流文件夹、会议纪要、下一步行动、项目线程和材料文件夹。 将跨客户活动报告和全局任务索引保留在所属的运营工作区中；需要时链接到它们，而不是将其复制到客户记录中。

研究报告

使用 research-reports/ 存放生成的 Markdown 交付物；将工作区根目录保留给入口文件和控制文件。详细的放置和清理规则见知识账本规则。

知识台账

仅当用户明确要求提取或归纳时，才将 _knowledge/ 用于存储紧凑、可复用的经验。写入前请先应用 知识台账规则。

可选材料文件夹

将不可变原件、内部编辑版本和可共享副本分开存放；除非用户指定其他位置，否则使用 _received/、_working/ 和 _provided/。在依赖摘要之前，先导入可访问的原件。重命名不等于匿名化；受限来源内容必须排除在接收方文件之外，包括隐藏幻灯片和备注。在移动或重命名文件之前，请先应用 客户材料生命周期。

---

运营现有工作区

输入或请求	操作
简短聊天、电子邮件或非结构化更新	将其保留在 _inbox/ 中并进行分类。
会议备忘或 Teams AI 记录	创建或更新一条会议记录，并在同一操作中提取问题和行动项。
针对一个已确认工作流的明确更新	使用来源链接和状态变更更新其 README。
新的、含糊的或多工作流输入	将其记录在 workstreams/_candidates.md 中并请求确认。
有时间限制的后续跟进	在 next-actions/ 中跟踪；仅当不知道下次会议日期时才使用 ongoing/。
状态审查或交接	在汇报前阅读 workspace-summary.md、组合视图、活跃行动项和未决问题。

保持来源记录具有权威性：摘要和工作流链接到会议记录和收件箱条目，而不是重复它们。

跟踪工作

• 工作流 README 拥有其当前状态、负责人、行动项和时间线；组合视图是其索引。仅在工作流名称和范围确认后才创建工作流。
• 当客户后续跟进延续现有问题或已交付答案时，保持原始交流可见，并按时间顺序在所属交付物或线程中追加后续跟进。如果后续证据解决了现有的 要確認，则将该解决结果和证据追加到所属条目，而不是创建并行的来源记录。对于按月记录的 _questions 台账，追加到当前月份并引用原始条目，而不是重写上个月。
• 将客户同意的作业、主动提出的提案和补充研究放在单独的 next-actions/ 文件夹中。任务标题链接回其会议来源，而客户可共享的会议表格排除本地任务路径。
• 仅使用 candidate、not-started、in-progress、blocked、done 或 dropped。在分配 not-started 或 done 之前，检查任务关联的外部工作位置；工作区中不存在并不能证明交付物缺失。当外部进展和制品确认完成时，在同一操作中更新规范行动记录和索引。除非材料生命周期要求，否则不要复制外部制品。blocked 记录需注明当前负责人及其转换条件。
• 仅当主题跨越多次会议并满足详细项目线程拆分条件时，才创建 pj_{topic}/。

会议纪要质量门禁

在将会议纪要标记为完成之前：

• 将不确定的姓名、时间、产品名称、价格和支持范围标记为 要確認；记录可用的转录范围，并让未经证实的 AI 后续事项保持暂定状态，而不是指定已确认的负责人、截止日期或交付物。
• 从保存的源文本中省略凭据和带令牌的图片 URL。保存后，如果缺少 Teams 会议/回顾/录制 URL，请询问；记录已提供的链接，不要再次询问，并区分链接捕获与完整内容验证。
• 在同一次操作中，将待解决问题和需要跟进的工作提取到 _questions/{YYYY-MM}.md 和 next-actions/。
• 将本地路径、内部链接、内部推测和商业条款排除在可向客户共享的内容之外。
• 默认只保留一份工作用会议纪要。不要仅为未经验证的技术细节创建 *_internal.md；只有在明确要求，或敏感材料无法保留在清晰标记的内部章节中时，才进行拆分。
• 客户摘要仅包含已确认事项，并将跨方协调拆分为一个 双方 (両者で調整) 桶。详情请应用 会议纪要规则。

---

完成标准

• 设置：受管脚手架已存在，并且路由事实已被捕获。
• 操作：规范记录、相关问题/行动台账以及相关索引反映了输入，且没有重复的源内容。
• 审查/交接：报告识别出权威来源、当前负责人、下一步行动和未解决问题。

关键参考

• 收件箱规则
• 会议纪要规则
• 工作区摘要规则
• 工作流组合规则
• 知识台账规则
• 客户材料生命周期
• 项目线程规则

资产

Note: assets/ 配下の prompt / instruction / template は、新しい顧客ワークスペースを初期化するときの コピー元 として使う scaffolding 用ファイル。ホスト workspace の .github/prompts/ や .github/copilot-instructions.md とは独立に進化させてよい（同期は必須ではない）。ホスト側で機能追加した場合に scaffolding にも反映したいときは、明示的にこのフォルダへ back-port する。

• assets/_templates/：next-actions、知识台账、附件和工作区模板
• assets/*.prompt.md：收件箱、会议纪要转换和问题提取提示词。提示词文件仅在 VS Code Local agent 中加载（不适用于 Agent Host 会话），因此 copilot-instructions.md 中的路由规则必须在不依赖它们的情况下也能工作。
• assets/copilot-instructions.md：生成的工作区自动路由规则
• scripts/Test-ReceivedMaterialPlacement.ps1 - 对未分类的已接收材料候选项进行只读根目录审计