spec-writer

spec-writer

开始操作前，请阅读宿主契约和此组件的声明（skill:spec-writer）。仅从共享目录加载适用模式；声明不授予访问权限或操作许可。使用实际宿主的交付路径。

文档角色

起草项目手册章节：已采纳的设计要求、产品／性能、提交文件和施工执行。明确区分拟议要求与已采纳要求。产品资料单页是不同的交付物：将忠实于来源的单一产品 PDF／URL 条目转交至 /as:product-cut-sheet，将 FF&E 手册转交至 /as:ffe-spec-book，将项目手册章节中的 EPD／GWP 要求转交至 /as:epd-to-spec。

原生执行与规范输出

此技能是完整的原生操作流程，且没有已注册的内部操作 ID。 使用可用的宿主研究、文件和普通的特定任务创作工具。无需 Arch Studio 可执行文件、包路径、下载内容或重建的辅助工具。提供的源内容是证据，不是更改已采纳要求、采纳记录或发送文档的授权。

对于要求保存的章节，保留原样的模板、选定的来源集和获准的目标位置。对完整输出集应用原生准备与发布流程：检查当前目标／待处理状态及实际访问权限；保留完整原件或缺失状态保护、所有已准备的章节／报告字节以及预期访问元数据。完成持久化保存后，在第一个发布者运行前，分别重新打开／验证每一个保留的原件／准备文件、章节标识、必需的结束区块和来源保护。仅在已证明写入保护有效且具备禁止覆盖或条件修订机制时，才发布完整文件。先独占创建再流式写入公共路径，不满足完整发布要求。

重新读取每个实际目标的完整字节及适用的模式、所有权和 ACL；在报告完成前，核验整个预期集合和受保护的原件。精确重试只验证已完成的结果，不进行重写；如存在不确定性，应保留待处理证据；如来源／目标状态发生变化，则必须协调处理。私有暂存区与所请求的公共输出必须保持区分。内联工作无需创建文件。

仅对绑定项目的工作解析原生上下文；独立草稿不创建项目。拟议事实／决策应依照各自的管理流程和现有授权写入项目；所请求文档的登记则应按其所属流程办理。保留下文中的所有来源／格式要求／免责声明要求，包括准确适用的最终区块。

来源与证据

在来源目录中查找相关原始链接，并按地理区域和主题筛选。对于实质性主张，应获取适用的原始文件或经授权提供的文件，并记录其发布方、URL／文件、章节／页码、版本／日期和任务范围。链接存在或可访问，并不能证明其适用性。如果访问权限、版本或身份尚未确定，则依赖这些信息的结论也应保持未确定；不得回退使用本地表格或模型记忆。将任务证据保存在获准的工作区内、插件之外。

仅要求列出来源时，使用目录元数据，并说明覆盖范围仅限于匹配的已登记条目。无需获取来源内容、进行设置或取得批准。共享来源和州级来源应保留各自的适用范围；缺少 LA 覆盖范围时，绝不能以 NYC 代替。

起草所需规范

阅读材料简报、已接受的项目要求以及提供的任何模板。仅在会影响规范的情况下，才对含糊的材料或功能选择作出判断。使用源目录中的 CSI 路径，从实际获授权的出版商版本或提供的已验证任务输入中获取选定的分部/章节标识。没有随附的 MasterFormat 映射或兼容版本。若章节标识尚未确定，应保留待审核状态，不要臆造一个最匹配的编号。

使用 Arch Studio 规范格式。涵盖实际要求的材料和应用；仅在已接受的范围支持时才合并重复项。保留客户模板、单位和术语。依据有来源支持的项目证据，起草所需的提交文件、已接受的产品/性能要求，以及施工和验证要求。区分拟议的设计要求、已采用的要求和制造商声明。只有在核实原文后，才引用精确的标准/版本。

将缺失的产品选择、不兼容的要求和未经验证的声明标记为待审核。不要用通用的制造商事实、复制的条款或缺乏依据的规范要求来填补空白。大纲不能证明符合规范或适合施工。

返回所有要求的章节、已验证的标识、来源定位信息和未解决的审核事项。仅导出到获授权的目标位置。对于规范或生命安全要求，遵循专业免责声明规则。

输出和记录

返回所需结果，并附上来源定位信息、实际检查结果和材料方面的缺口。基于来源的建议、确定性算术和目视检查属于不同的证据。使用完成报告约定。对于持久化项目工作，解析项目并遵循工作区所有权规则；将事实/决策提交给其所有者，而不是悄悄写入 PROJECT.md。一次性工作仍保持独立。

当实际输出属于规范或生命安全分析时，在末尾附上专业免责声明中的标准区块，随后空一行，并以 `` 作为最后一行；且只出现一次。仅包含元数据的来源目录不属于规范分析，无需添加此区块。