关于 studio
用于管理 Arch Studio 工作区的技能,涵盖工作室设置、项目注册、状态、任务和连接器边界。面向建筑与项目工作区,变更须遵循明确范围并进行回读核验。
主要功能
- 01初始化工作室工作区
- 02注册和检查项目
- 03更新项目状态或归档状态
- 04设置命名策略和任务模式
- 05管理工作室级 MCP 连接器清单
适用场景
- 01设置新的工作室工作区
- 02注册现有项目
- 03更改项目状态或归档状态
- 04配置工作室 MCP 服务条目
MCP 相关
该技能负责工作室级 `.mcp.json` 边界。设置时创建空的 `mcpServers` 对象;后续连接器变更须经明确授权并依据已核实的文档。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alpacalabsllc/ skills-for-architects --skill studio安装后在 Claude Code 中输入/studio确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
host-contract.jsonREADME.mdscripts/update_preference.py详细介绍
/as:studio
开始操作前,请阅读宿主契约、此组件的声明(skill:studio)以及适用的工作区语义。仅从共享目录加载所需模式。
原生调用请使用宿主适配器。使用宿主自身的工具和常规任务专用代码执行原生工作区操作。操作名称用于标识语义范围,并非函数调用或调度器。无需 Arch Studio 运行器、可执行文件下载或重构的辅助程序。编辑现有工作区前,先解析规范上下文;全新设置则应验证其明确指定的目标和祖先边界。已有的明确授权持续有效;仅在缺少重要信息或权限时才询问。
负责 STUDIO.md、项目注册、已注册项目状态的同步以及仅限 Studio 的连接器边界。请阅读moments,了解如何根据状态欢迎用户以及如何处理无文件夹的情况。不要重复已被拒绝的设置提示。用户提供了任务时,直接开始处理;不要重放欢迎语或菜单。仅使用工具以及有效的独立项目,无需搭建 Studio 环境。
更改记录前
进行持久性更改前,请遵循原生变更顺序:检查 → 准备 → 验证准备 → 应用 → 验证结果 → 完成。先检查待处理工作。首次写入规范数据前,必须完成并验证准备工作:分别重新读取每个已保存的原始文件和准备好的文件,检查其完整的实际字节,确认保存已持久化,并检查实际权限、所有权和 ACL。仅写入恢复文件并不代表验证已完成。仅应用通过验证的文件集。只有在重新读取并确认受影响的完整结果及其关联关系后,才能标记为完成。只读请求和内联草稿无需发布流程。
全新设置需准备整个声明的 Studio 目录树及其身份信息。项目模式注册会更改 STUDIO.md,同时保护现有项目的身份信息;组合模式注册还需将允许移除仅含表头的本地 TASKS.csv 以及更新项目任务指针一并纳入同一准备文件集。状态或归档更改需在任一发布程序运行前同时准备 STUDIO.md 和 PROJECT.md。任务模式更改需涵盖所有受影响的登记表及所有权引用。单项设置编辑必须限于其声明的文件或字段;可选的偏好设置或连接器编辑仍需单独取得明确授权。
设置
若要全新设置或按明确要求配置策略,请阅读工作室策略协议。只询问一次用户是否有 AI 使用策略,或是否希望采用所提供的默认策略;采用前展示默认策略,并允许用户拒绝。保留现有引用;仅在解析后的 Standards 根目录下的 governance/ai-policy.md 创建默认策略。在 STUDIO.md 的 Data governance 部分记录引用和采用选择。将这组确切的文件纳入现有设置预览和回读。进行无关编辑时保留已配置的选择;Skill Maker 只会使用这些选择。不得静默采用或迁移任何策略。
对于已确认的确切全新目标,使用 studio.init。只收集缺失的信息:工作室名称、工作单位、司法管辖区(无默认值也是有效选择)、命名策略(as、firm、none)、文件夹分类体系/受管理根目录、文档路径模板,以及按项目 Kind 划分的公司阶段词汇。命名和分类体系是彼此独立的建议选项。保留已确认的人名及其大小写。随附的建筑/软件/倡议阶段是 Arch Studio 自有默认项,并非声称的外部标准。
展示确切的目标、文件、受管理根目录和数据边界:记录保留在用户工作区中;提供给已配置模型的内容受相应服务提供商条款约束;设置不会创建 ALPA 账户/云存储/Git 仓库。用一个具体的设置关卡确认这些选择。格式版本保持为 3;Document model 1 用于标识全新记录结构。不提供现有工作区转换或向后兼容设置。
完成设置偏好询问时,请使用:“您希望此助手默认在架构和项目工作中使用 Arch Studio 吗?”遵循偏好协议。当确切范围的偏好编辑已预览后,同一次设置批准可以涵盖该编辑;笼统的肯定答复绝不代表批准未展示的文件编辑。否则保留会话指导,并仅获取缺失的具体授权。不得隐式保存全局偏好。
MCP 指令传递不会安装生命周期钩子。后台更新偏好是已安装软件包的功能,不属于此 MCP 工作流;请说明此处无法提供该功能,且不要检查或创建软件包状态。不得根据连接状态或一般设置批准推断已启用。
使用原生工具应用经审阅的 studio.init 准备操作。重新打开 STUDIO.md、身份信息、连接器清单(mcpServers 为空)、受管理根目录和宿主技能根目录。安装/连接检查无法证明工作区已创建。
项目和设置
studio.status会列出有效和无效的注册信息、身份漂移以及只读的任务模式。未知或已归档状态不会隐藏项目。此处不代表已执行身份验证或网络检查。- 创建项目时,会先调用
project.init,再调用studio.register;两者使用相同的已批准身份和目标。若项目只完成了部分创建,会报告该状态,并恢复注册,而不会重新创建项目。 studio.register要求存在一个新的模型后代项目,且其 Project ID 和 Folder ID 不可变并且唯一。路径是相对的缓存位置;不要根据人类可读的文件夹名称推断身份。studio.set-status和studio.archive仅更改所选注册表中的 Status 单元格,以及对应 PROJECT.md 中的 Status Value 单元格。除非用户另行授权修改特定来源信息,否则必须原样保留现有的 Source 和 Date 单元格;不要将 Source 替换为操作名称。发布前和实际回读时,都要比较这两个文件的字段级差异,并拒绝任何其他单元格变更。活动本身不能证明任务已完成或获准。studio.set-naming会更改建议性政策/约定,但不会重命名现有 ID 或文件夹。studio.task-mode仅在项目所有权和 studio 项目组合所有权之间切换当前模型的空任务注册表,同时保留单一写入者拓扑。已填充的注册表需要另行指定当前数据操作;不得自动合并/拆分,也不得使用历史转换器。
只有 studio 拥有 studio 根目录中的 .mcp.json。设置会将其留空;连接器配置/身份验证需要另行具备相应功能和范围。项目不会接收此清单。Firm 扩展必须留在相关宿主的 studio 技能根目录中。
一般领域工作可以在一次性移交给 Norma 时,附上范围、已完成的输出和现有授权;明确的 studio 管理任务则留在此处。主工具链中的 Agent 创建必须遵循已批准的角色/分配和实际能力。不要声称指令或欢迎信息已执行某个工作流。
可选偏好和连接器
只有在选择可选的默认助手时,才使用 studio.preference;应通过已验证的原生指令机制,按照偏好协议操作,并应用具体的已授权差异。仅凭连接或保存文件,不能声称设置已持久化。MCP 后台生命周期更新检查目前不可用;请勿通过此工作流调用已安装软件包的更新操作。
studio.connectors 管理 studio .mcp.json 边界。全新设置会创建一个恰好包含空 mcpServers 对象的文件。之后如明确要求配置,必须依据已验证的连接器/宿主文档,并经过审核后应用精确变更,同时保留其他条目。只能配置已知且获授权的服务;身份验证、外部消息和账户开通需要各自实际具备的功能和授权。不得根据工作区设置推断任意连接器端点或密钥。
管理完成后,遵循通用的完成情况报告约定。报告实际变更和回读结果;连接或欢迎信息不等于创建了工作区。