SuperAPI AI 工具集

project-workspace

通用与其它

查看项目

更新于 10-15 16:46

技能介绍

用途:当用户要求创建、打开、准备或整理某个主题的项目工作区,或在已有项目中记录会议时使用。客户账户操作走客户专用流程;源媒体仍需转录时走转录流程。

目标位置:若提供了活动 VS Code 工作区且用户在为当前任务整理材料,即使没有仓库标记也以该工作区为默认目标,不要重定向到外部项目根。若该工作区已管理某客户的持续工作,则在已确认主题下添加验证证据并链接其现有状态与行动,除非明确要求独立工作区,否则不要再建第二个项目工作区或并行任务台账。仅当用户要求独立项目工作区、或没有可用活动工作区目标时,才使用配置的项目根。在 CLI/Scout 无活动工作区上下文时,若 CWD 无法识别工作区就询问目标文件夹,不要推断外部项目位置。使用 Windows 风格反斜杠路径。

命名:优先简洁的 kebab-case 英文文件夹名,如 azure-monitor-workspace-validation、joule-validation、customer-meeting-prep。日文或非正式主题名需转换为清晰英文 slug。文件夹已存在则复用,不重复创建;名称含糊或会与无关文件夹冲突时先询问。

创建流程:确定主题与 slug;按上述规则解析目标;验证、调查、PoC、对比、客户说明、截图收集或需给出观点/标准时,默认创建轻量项目包而非空文件夹;用户只要求文件夹时就只建文件夹并报告路径。大规模移动、重命名或破坏性清理遵循 dry-run → 确认 → 执行。

会议纪要:找到项目现有会议纪要或回顾并更新,否则使用 notes 文件夹中的带日期笔记或放置于现有记录旁。不因单次会议初始化新项目、创建客户工作区或添加会议文件夹。记录日期、来源、已确认讨论与决定、未决问题、后续行动;仅在明确同意时分配负责人与截止日期;不确定的名称、数字与语音识别内容标记为未验证。受限材料留在原授权位置,不要复制机密幻灯片或原始转录到可共享摘要;区分提议与已同意的承诺或结果,避免并行任务台账。

默认项目包:除非另有要求,创建 README.md、validation-plan.md、notes\findings.md、screenshots\README.md、screenshots\01-source-or-baseline、screenshots\02-validation、screenshots\03-customer-story、exports。提到成本、定价、TCO、FinOps、账单或多方案成本对比时,另建 cost-comparison.md。

验证计划应包含目的与预期输出、关键问题或假设、范围与非目标、环境与前置条件、分步验证场景、证据计划与命名规范、来源溯源、多方案时的对比或决策标准、客户价值故事、需证据声明的实际测量场景、风险与未决问题,以及 Microsoft/Azure 主题的官方参考。Microsoft/Azure 重要事实应先用官方 Microsoft Learn、Azure 定价等核实并附来源 URL。

成本对比需定义如何测量或估算成本,包含可比工作负载、各方案实际存储或处理的数据、用量驱动与单位、官方定价或 Azure Retail Prices API 的基准单价(含区域、币种、获取日期)、基线/高用量/高基数或高保留测试、换算公式、证据收集,并说明实际账单可能延迟。Azure Monitor 工作区与 Log Analytics 工作区对比不应视为存放相同数据,而应用同一监控负载,日志送 Log Analytics、Prometheus 指标送 Azure Monitor,再比较实际成本驱动。

报告:先报最终路径,说明是否复用已有文件夹,回应保持简洁。护栏:未经明确要求不移动或删除现有文件;不在项目文件中存密钥或凭据;不在此私有仓库技能中存用户机器绝对路径;Microsoft/Azure 验证计划需用官方信息核实事实并附来源 URL。