diff --git a/PROGRESS.md b/PROGRESS.md index d1f2735..28e1e09 100644 --- a/PROGRESS.md +++ b/PROGRESS.md @@ -2,7 +2,7 @@ > 配合 `DESIGN.md`。本文件只记 phase 状态、决策偏差、文件量、下一步。每条 1-2 句:做了啥 + 关键判断;细节查 `git log` / `git diff` / `DESIGN §7.9`。 -最后更新:2026-06-05(记账给前缀缓存命中折价 + 前端体现缓存命中/真实成本) +最后更新:2026-06-05(新增 standard skill:国标/行标/团标起草) --- @@ -23,6 +23,7 @@ ### 2026-06-05 +- **新增 `standard` skill(国标/行标/团标起草)**:联网核实市面无可直接复用的"写标准文件本身"的 skill(搜到的 technical-proposal GB/T 8567、official-document GB/T 9704 都是相邻品类——投标书/公文,非标准),据 GB/T 1.1—2020 自建。覆盖三层级(国标 GB·T / 行标 JC·T / 团标 T/,重点对接 **CSTM → T/CSTM**,材料试验团标对口建材院检测方向)× 两体裁骨架(试验方法 GB/T 20001.4 + 产品标准)。文件:`SKILL.md`(阶段化:定层级体裁→八条 spec→逐章段段卡→自检渲染)+ 3 references(`gbt_1_1_structure` 要素骨架/必备可选/规范性资料性/封面前言套话、`standard_levels` 选型+CSTM 体系立项、`drafting_rules` 能愿动词应宜可能/不可考核词过滤/指标量化闭环/术语规则/引用真实性+§8 自检清单)+ 4 templates(spec/test_method/product_standard/编制说明)。**渲染复用 proposal `render_docx.py`+`render_diagrams.py`**(兄弟 skill `../proposal/scripts/`,同 patent 范式);冒烟测过表格/中文渲染正常。**坑**:proposal `quality_check.py` 按申报书固定章节名查"缺章节",对标准全是误报且无跳过开关→阶段三不用机检,改 drafting_rules §8 人工 12 条清单(与 patent self_check 同思路)。产出是结构合规草稿 docx,正式报批再灌官方 TCS/CSTM 模板做版式精修。 - **dev 页加"改密码"功能 + 文件面板"选入"按钮文字改图标(防换行)**:① 自助改密码——`web/auth.py::change_password(user_id, old, new)`(验旧密码 → 新密码 ≥6 → bcrypt 重哈希写回,错误归一到现成 `UserCreateError` code 体系 `wrong_password/no_password/weak_password/user_not_found`,不为此新开异常类),`POST /v1/auth/change_password` 挂 `Depends(require_user)`(user_id 取自 JWT 不信前端,旧密码错/无密码→403、弱→400、行没了→401)。前端顶栏「退出登录」左侧加「改密码」按钮(`#hd-chpw`,并入 embed 隐藏规则——embed 模式不显示)+ 一个复用 `.modal` 骨架的弹框(旧/新/确认三项,前端先验长度+两次一致再提交,成功 `alert` 提示不登出,401 走 `logout()`)。否决"点用户名展开菜单"(多写菜单逻辑不划算)。② `#btn-src-pick` 的文字 `选入…` 改单字符图标 `⊕`(和旁边 `⬆ ↻ ›` 同款单色字形,`title` 保留"选入"语义)——原中文文字在窄面板偶发换行。 - **记账给 DeepSeek 前缀缓存命中折价(修虚高 ~2-3x)+ 前端体现缓存命中/真实成本**:排查"rust 优势→PPT"那 task(flash,34 轮)发现 `tokens_in` 累计 69.9 万里 **88.6% 是缓存命中**,但 `usage.py::_fallback_chat_cost_cny` 把命中段也按 `input` 全价(1.0)算 → 记 ¥0.84,真实(命中按 0.1x)只 ~¥0.28,**越大的 task 虚高越多**(文献采集 53% 命中:¥33→~¥16)。修:① `ModelCapabilities` 加 `cache_hit_cny_per_mtoken`(deepseek flash 0.1 / pro 0.2;0=不区分按全价兜底,绝不少记);② 成本公式拆三段「命中×缓存价 + (input−命中)×input价 + output×output价」,`loop.py` 把 `cache_hit_tokens` + 缓存单价透传进 `record_chat_usage`;③ 前端不加 DB 列——`web/app.py` 加 `_usage_aggregates`(单查询 GROUP BY `usage_events`,复用列表 `msg_counts` 同款批量范式,无 N+1)on-the-fly 算每 task 真实成本 + chat token + 缓存命中,`_task_dict` 带出;列表行**不内联花费**、只显 tok 数,花费/缓存命中率藏 hover tooltip(`taskUsageTooltip`,多行:输入/输出拆分 · 命中 + 命中率 · ¥真实花费),顶栏额外内联简版。**折价只对新 chat 事件生效**,历史走 backfill 脚本(`scripts/backfill_chat_cost_cache_discount.py`,默认 dry-run,`--apply` 落库;`--assume-cache-hit-rate RATE` 给无 `cache_hit_tokens` 字段的老事件按估算命中率折价——DeepSeek 当时缓存了只是没记,全价偏高;实测过的事件用真实值不受影响)。**坑修**:命中率分母原误用 `tasks.tokens_prompt`,但该列会被「清空对话」重置而 `usage_events` 不重置 → 跨源相除算出 822% 怪值;改为 `_task_dict` 的 token 总量也优先取 usage_events 聚合(与 cache_hit 同源,命中率恒 ≤100%)。**注**:真正压低 token 体量的杠杆是减少轮数(高成本 task 全是 100+ 轮的逐步 write/run_python 循环),非本次范围。 diff --git a/SKILL_LIST.md b/SKILL_LIST.md index d545736..78380cf 100644 --- a/SKILL_LIST.md +++ b/SKILL_LIST.md @@ -1,8 +1,8 @@ # zcbot Skill 清单 服务对象:中国建筑材料科学研究总院 —— 无机非金属材料 R&D(水泥 / 混凝土 / 玻璃 / 陶瓷 / 耐火 / 新型建材) -最后更新:2026-06-01 -Skill 总数:13 +最后更新:2026-06-05 +Skill 总数:14 zcbot 的"skill"是一份可加载的工作流脚本(`skills//SKILL.md` + 配套 templates / scripts / Python helper),模型在识别用户意图后挂载对应 skill,按其内置的阶段化流程产出可交付物。本文档面向**使用方 / 协作方**,按"做什么、什么时候用、什么时候别用、典型产物"组织。 @@ -13,6 +13,7 @@ zcbot 的"skill"是一份可加载的工作流脚本(`skills//SKILL.md` + | 分类 | Skill | 一句话 | |---|---|---| | 科研写作 | [proposal](#proposal) | 写本子 / 申报书 / 任务书(6 类基金) | +| 科研写作 | [standard](#standard) | 起草标准:国标 / 行标 / 团标(含 T/CSTM)+ 编制说明 | | 科研写作 | [patent](#patent) | 写发明专利技术交底书(供代理师转写) | | 科研写作 | [review](#review) | 审稿 / 润色 / 校对(中英文,长文档分段深审) | | 演示出图 | [ppt](#ppt) | 生成 PowerPoint 演示稿(商务红主题,逐页验收) | @@ -57,6 +58,36 @@ zcbot 的"skill"是一份可加载的工作流脚本(`skills//SKILL.md` + --- +### standard +**起草中国标准文件(国标 / 行标 / 团标)及配套编制说明。** + +把材料 / 方法 / 产品信息变成符合 **GB/T 1.1—2020《标准化工作导则》** 的标准草稿 .docx。流程:**先定层级与体裁 → 八条对齐 spec → 逐章起草 → 自检渲染**,不一口气出全文,核心技术章"一段一卡"。 + +**覆盖层级**(用户确认三类,不做地标): +- 国家标准(GB 强制 / GB·T 推荐) +- 行业标准(建材 **JC·T** 等) +- 团体标准(**T/**,重点对接 **CSTM → T/CSTM**,材料试验团标对口建材院检测方向,周期最短最易牵头) + +**覆盖体裁**(已做骨架):试验方法标准(GB/T 20001.4)、产品标准;术语 / 规程按需补。 + +**何时用**:写标准、起草标准、编标准、做试验方法 / 产品标准、写标准草案 / 征求意见稿 / 送审稿 / 报批稿、写标准编制说明。 + +**何时不用**: +- ⛔ "按 XX 标准做检测 / 写报告" → 是执行标准,不是写标准 +- ⛔ 写投标技术方案 → 不是标准;写申报书 → 走 proposal;写专利交底书 → 走 patent +- ⚠️ 用户说"标准"但其实指企业内部规程 / 作业指导书 → 先反问是否对外发布 + +**核心能力**: +- **GB/T 1.1 要素骨架**:封面 / 前言 / 引言 / 范围 / 规范性引用文件 / 术语 / 技术要素 / 附录 / 参考文献,标注必备 vs 可选、规范性 vs 资料性 + 封面前言固定套话 +- **层级选型**:国标 GB·T / 行标 JC·T / 团标 T·CSTM 的编号规则、归口路径、立项程序(含 CSTM 体系与三维结构)+ 选型决策树 +- **起草铁律**:能愿动词(应 / 不应 = 要求,宜 = 推荐,可 = 允许,能 = 能力)、不可考核词过滤、指标量化闭环(要求章 ↔ 试验方法章呼应)、术语一术一义、引用真实性 +- **编制说明**(报批必交件):立项依据 / 国内外现状 / 主要技术指标确定依据 / 试验验证骨架 +- 渲染复用 proposal 脚本(同一套 markdown + mermaid + 自动图表编号) + +**典型产物**:`<标准名称>.docx`(标准正文草稿)+ `<标准名称>_编制说明.docx`;正式报批前灌官方 TCS / CSTM 模板做版式精修。 + +--- + ### patent **撰写中国发明专利技术交底书(供专利代理师转写为正式申请文件)。** @@ -403,6 +434,7 @@ paper_server 是内部 Django 文献库:元数据来自 OpenAlex,PDF / XML 由 S - **写本子全流程**:analyze(拆问题) → research / documents(查文献) → stats_ml(算配方-性能模型出预实验数据) → plot_pub(出图) → proposal(写本子) → review(审稿) - **写专利全流程**:patent(挖点 + 检索 + 起草) → research(查现有技术) → plot_pub(出附图) → review(终审) +- **写标准全流程**:analyze(定标准化对象) → stats_ml(配方-性能 / 精密度试验数据定指标) → research / documents(查国内外现有标准与现状) → standard(起草标准 + 编制说明) → plot_pub(出图) → review(送审前终审) - **PPT 汇报**:analyze(提炼论点) → research / documents(找数据 + 引文) → plot_pub(出图) → ppt(组装 deck) → imagegen(可选,做封面 / 引子页) - **晶体计算**:pymatgen(算 XRD / 相图) → plot_pub(出图) → proposal / patent(写到本子 / 交底书里) diff --git a/skills/standard/SKILL.md b/skills/standard/SKILL.md new file mode 100644 index 0000000..e3645c4 --- /dev/null +++ b/skills/standard/SKILL.md @@ -0,0 +1,207 @@ +--- +name: standard +description: 撰写中国标准文件(国家标准 GB/GB·T、行业标准 JC·T 等、团体标准 T/ 含 T/CSTM)及配套编制说明,按 GB/T 1.1—2020 起草规则。当用户要写标准、起草标准、编标准、做试验方法标准/产品标准、写标准草案/征求意见稿/送审稿/报批稿、写标准编制说明时使用。 +--- + +# Standard (标准起草) + +把材料/方法/产品信息变成符合 **GB/T 1.1—2020** 的标准草稿 .docx + 配套编制说明。**先定层级与体裁 → 八条对齐 spec → 逐章起草 → 自检渲染** —— 不要一口气出全文。 + +> ⚠️ 与相邻 skill 区分:本 skill 写**标准文件本身**。要写投标技术方案走别处,要写申报书走 `proposal`,要写专利交底书走 `patent`,要审稿润色走 `review`。 + +## 资源 + +下面所有路径都相对 **``** —— `load_skill` 返回头里的 `[skill=standard, dir=<绝对路径>]`,用这个绝对路径拼脚本/资源,不要假设 cwd。 + +- `/references/gbt_1_1_structure.md` —— 要素骨架 + 编排顺序 + 必备/可选 + 规范性/资料性 + 封面/前言固定套话 (always read) +- `/references/standard_levels.md` —— 国标/行标/团标选型 + 编号规则 + CSTM 体系与立项程序 + 选型决策树 +- `/references/drafting_rules.md` —— 能愿动词(应/宜/可/能)+ 不可考核词过滤 + 指标量化闭环 + 术语规则 + 引用真实性 + 起草前自检清单 +- `/templates/spec.md` —— task 级"宪法"模板(层级/体裁/名称/范围/指标矩阵/引用清单/起草信息) +- `/templates/test_method.md` —— **试验方法标准**章节骨架(GB/T 20001.4,建材院+CSTM 主场) +- `/templates/product_standard.md` —— **产品标准**章节骨架(分类→技术要求→试验方法→检验规则→标志包装) +- `/templates/drafting_note.md` —— **编制说明**骨架(报批必交件) +- **渲染脚本复用 proposal skill**:`/../proposal/scripts/render_diagrams.py` + `render_docx.py` —— 同样的 markdown + ```mermaid``` + `%% caption:` 约定,不另写 + +## 触发 / 不触发 + +- ✅ "写个标准 / 起草标准 / 编标准 / 这个方法想做成团标 / 报 CSTM / 做成 JC 行标 / 产品标准 / 试验方法标准 / 标准征求意见稿 / 送审稿 / 报批稿 / 标准编制说明" +- ⚠️ 用户说"标准"但其实指"技术规范文档 / 作业指导书 / 企业内部规程" —— **先反问**是不是要做成对外发布的标准(GB/JC·T/团标),还是内部文件;内部文件不必套 GB/T 1.1。 +- ⛔ "符合 XX 标准写一份报告 / 按标准做检测" —— 那是执行标准,不是写标准,走对应业务 skill。 + +## 阶段零: 摄取素材 (有 PDF/DOCX/XLSX/URL 时才走) + +用户给已有相近标准 / 检测数据 / 实验报告 / 现状调研 → 用 `markitdown` CLI 转 md 落到 `/source/.md`,后续阶段直接 read: + +```bash +markitdown /相近标准.pdf -o /source/ref_std.md +markitdown /检测报告.docx -o /source/test_report.md +markitdown /数据.xlsx -o /source/data.md +markitdown https://example.com/ -o /source/policy.md +``` + +## 阶段一: 定层级与体裁 + 八条对齐 (spec) + +产物:**task 级 spec 文件**(标准"宪法",阶段二每章前都要重读)。文件路径按 system prompt 的《task 级「宪法」文件命名约定》: + + /--.spec.md + +**0. 先检测已有 spec**: + +``` +glob /*--*.spec.md → 按文件名字典序排,取最大者作 current +``` + +- 若已有 current → 展示给用户,问「**沿用进阶段二** / **重定调**(以 today 为前缀写新版,旧版保留)」,⛔ BLOCKING 等用户决定 +- 仅有其它 task 的(`*-<别的 short_id>-*.spec.md`)→ 不当 current 用,继续走下面 +- 完全没有 → 直接走下面 + +1. **先读 `references/standard_levels.md` 定层级**:国标 GB/T · 行标 JC/T · 团标 T/(默认建议 **T/CSTM** —— 研究院牵头最快最对口,理由见 standard_levels.md §1/§4);用决策树定**体裁**(试验方法 / 产品 / 术语 / 规程)。⛔ **BLOCKING:层级 + 体裁两个维度都要用户确认**(它们决定程序、效力、章节骨架)。 +2. **复制模板**:`read /templates/spec.md` → `write /--.spec.md` +3. **按字段填**:标准名称(引导+主体+补充要素)/ 范围 / 起草信息 / **关键技术指标矩阵**(每条指标+单位+判定方向+试验方法闭环)/ 规范性引用文件(真实标准号)/ 术语清单 / 编制说明要点 / TODO +4. 给用户预览 +5. ⛔ **BLOCKING:用户确认后才进阶段二** + +> 指标矩阵是 spec 的心脏 —— 阶段二技术要求章直接展开它,阶段三自检读它。指标定不下来就标 ``,不要编数值。 + +## 阶段二: 逐章起草 + +每章两段式:**先列要点 → 用户确认 → 再起草 → 用户确认**。不要直接出正文。 + +按 spec §2 选定的体裁,读对应骨架(`templates/test_method.md` 或 `product_standard.md`)。**每章起草前必读 `references/drafting_rules.md`** —— 能愿动词、不可考核词、量化闭环是逐条硬规则。 + +**A. 起草前列要点**: +1. 读 **current spec** 与对应体裁骨架,拿本章必备要素 +2. 列 3-6 条要点骨架:本章覆盖的条款/指标/表格,每条标注规范性 or 资料性、对齐 spec 的哪条指标 +3. ⛔ **BLOCKING:用户确认要点后才动正文** + +**B. 正文起草**: +4. 从体裁骨架复制对应小节到 `/sections/NN_xxx.md`(NN 控目次顺序) +5. **核心技术章一段一卡** —— 技术要求 / 试验步骤 / 结果计算 / 精密度 / 检验规则:写一段 → 报字数 + 自查能愿动词与可考核性 + **预告下一段** → 等用户确认 → 写下一段 + 普通章节一节一卡:整节写完再报 + **预告下一节要点** +6. 报告格式(每次卡点都按这个出): + - **本段(节)**:章节名 / 规范性 or 资料性 / 涉及的指标条 / 能愿动词与可考核性自查结果 + - **下一段(节)预告**:标题 + 3-5 条要点骨架;若已是本章最后一段,改预告**下一章**首段要点 + - 提问:"本段可以了吗?下一段要点要改 / 加 / 删什么?" +7. ⛔ **BLOCKING:停下来等用户明确反馈**("OK"、"下一段"、"继续")后才动笔。"看起来不错"、沉默、追问都不算确认 —— 用户对下一段要点没异议也算默认通过,但**指标值 / 试验条件 / 引用标准号异常**时必须主动追问。 +8. 用户确认了**实质改动**(改指标值 / 调试验条件 / 换引用标准 / 增删章条)后,追加一行到 `/REVISIONS.md` —— 见 §修订日志。 + +**编制说明同步**:技术要求章每定一条关键指标,把"确定依据"同步记进 spec §9 / 编制说明草稿 —— 报批时编制说明 §4 要逐条解释指标怎么来的,别等最后补。 + +**例外**:用户**主动且明确**说"别问,直接全做"或"一气呵成" —— 才能一次跑完,跑完必须按阶段三自检。"太慢/太碎"之类抱怨**不算**例外指令,继续问。 + +## 阶段三: 自检 + 渲染 + +```bash +# 1. 自检 (按 drafting_rules.md §8 清单 12 条逐条核 — 无脚本,模型逐条对照 sections/*.md) +read /references/drafting_rules.md # 看 §8 自检清单(要素齐全/能愿动词/可考核/指标闭环/术语/引用/单位/无 TODO 残留/无 ASCII 字符画) +# 不过的项回头 edit 章节 + +# 2. mermaid 图预渲染 (章节有 ```mermaid``` 块才跑) +python /../proposal/scripts/render_diagrams.py /sections/ + +# 3. 渲染标准正文 .docx (复用 proposal 脚本,--fund-type 只影响打印文案不影响排版) +python /../proposal/scripts/render_docx.py /sections/ --fund-type key_rd -o /<标准名称>.docx + +# 4. 渲染编制说明 .docx (有 note_sections/ 时) +python /../proposal/scripts/render_docx.py /note_sections/ --fund-type key_rd -o /<标准名称>_编制说明.docx +``` + +> ⚠️ 不要用 proposal 的 `quality_check.py` —— 它按申报书固定章节名(00_basic_info…)查"缺章节",对标准是误报。结构核对走 drafting_rules.md §8 人工清单(对标准更贴),与 `patent` skill 同一思路。 + +> 复用的 proposal 脚本是 standard 的**兄弟 skill**,用 `/../proposal/scripts/...` 定位(host 与 docker 后端都落到同级 proposal 目录)。**不要**拼 repo 根的宿主绝对路径 —— docker 容器里看不到宿主路径。 +> +> 产出是**结构规范的草稿**(宋体小四/1.5 倍行距/自动目次)。正式报批前把内容灌入标准发布机构官方模板(国标 TCS 2017 / CSTM 提供的 Word 模板)做版式精修 —— 本 skill 保证要素齐、顺序对、条款合规、措辞合规,版式交官方模板。见 gbt_1_1_structure.md §7。 + +## 工作目录 + +`` = system prompt 给的**绝对路径**。**所有产物都写到 task_dir 下**,不要写到 cwd / `skills/` / repo 根。 + +``` +/ +├── source/ # markitdown 转出的素材(相近标准/检测数据) +├── --.spec.md # 阶段一定调,task 级宪法;按 short_id 主锚,重定调写新日期旧版保留 +├── sections/ # 标准正文逐章产物(按体裁骨架切的小节) +├── note_sections/ # 编制说明逐章产物(drafting_note.md 切的小节) +├── figures/ # mermaid/matplotlib 预渲染 PNG +├── REVISIONS.md # 修订日志:每次卡点用户确认的实质改动 +├── <标准名称>.docx # 最终标准草稿(按标准名命名,不要 output.docx) +└── <标准名称>_编制说明.docx # 配套编制说明 +``` + +## 修订日志 (REVISIONS.md) + +`/REVISIONS.md` 是产物迭代的紧凑 changelog。**spec 是宪法(定调一次),REVISIONS 是实施日志(每次卡点累加)**。 + +### 何时记 / 何时不记 + +| 情形 | 记? | +|---|---| +| 用户确认改**技术指标值 / 试验条件 / 精密度限 / 判定规则** | ✅ 必记 | +| 用户确认换 / 增 / 删**引用标准 / 术语 / 章条 / 附录** | ✅ 必记 | +| 用户确认改**层级 / 体裁 / 标准名称 / 范围界定** | ✅ 必记 | +| 用户对要点骨架的主动修改(改 / 加 / 删) | ✅ 必记 | +| 自检发现能愿动词/不可考核词/指标不闭环后的统一改 | ✅ 必记(注明触发的自检条,如"自检 §8.5") | +| 章节首次起草(从 0 写出来) | ❌ 不记 | +| 错别字 / 标点 / 纯排版调整 | ❌ 不记 | + +> 拿不准 → 倾向不记。 + +### 格式 + +文件首次创建时写头(只写一次): + +```markdown +# 修订日志 + +> 产物迭代过程中每次用户确认的实质改动,按时间倒序追加(最新在上)。spec 是宪法定调,本文件是实施日志。 +``` + +每次记一笔追加在头注释之后、最新一笔的顶部: + +``` +- `` | <文件:章节/条> | <一句话改了什么> — <为什么> +``` + +### 实例 + +``` +- `2026-06-05 16:20` | sections/05_技术要求.md 表1 | 抗折强度由"≥5.0 MPa"提到"≥6.0 MPa" — 实测15组均值6.4,P5分位6.1,留裕量 +- `2026-06-05 14:05` | sections/10_精密度.md §10.2 | 再现性限 R 由 0.8 改为 1.0 MPa — 三家实验室验证数据离散,0.8 偏严 +- `2026-06-05 11:30` | --.spec.md §1 层级 | 由 JC/T 行标改为 T/CSTM 团标 — 行标周期长,先做团标快速落地 +``` + +### 操作 + +每次卡点用户确认后,用 `edit` 在头注释之后插入新一行(不要 append 到文件末尾)。文件不存在就 `write` 创建带头注释的新文件。 + +## 硬规则速查 (违反即被审评退回) + +- **要素齐 + 顺序对**:对照 gbt_1_1_structure.md §1;必备要素(封面/前言/名称/范围)一个不少 +- **规范性 vs 资料性**:资料性要素(前言/引言/参考文献/资料性附录)里**不准写"应/宜"等条款** +- **能愿动词**:应/不应=要求,宜/不宜=推荐,可/不必=允许,能/不能=能力;⛔ 不用"必须/应该/严禁/不得" +- **可考核**:删"高/好/适当/尽量/合理"等模糊词;每条要求 = 量+数值+单位+判定方向(≥/≤)+对应试验方法 +- **指标闭环**:每条技术要求在标准内有方可验(要求章 ↔ 试验方法章呼应) +- **术语规则**:一术一义、替换式定义、引用标来源、不重复已有国标术语 +- **引用真实**:标准号/名称/条款号一字不编,存疑用 research/web 核;固定引导语见 gbt_1_1_structure.md §5 +- **量与单位**:法定计量单位(SI),量符号斜体单位正体,修约按 GB/T 8170 +- **编制说明必交**:报批稿必附,§4 逐条解释关键指标确定依据 +- **命名**:按标准名命名 docx,不要 output.docx / 标准.docx + +## 反模式 + +- 未定层级/体裁就硬写正文 / 一次性出全文 / 跳过"列要点"段段卡 +- 核心技术章(技术要求/试验步骤/精密度/检验规则)整章一次出 —— 必须段段卡 +- **自己编指标数值 / 试验条件 / 精密度限 / 标准号** —— 不知道就 `` +- 资料性要素里写"应/宜"条款;用"必须/严禁/不得" +- 技术要求写"强度高、耐久性好"这种不可考核措辞 +- 技术要求无对应试验方法(指标不闭环) +- 把"编制说明"漏掉(报批一定被要) +- 跳过 drafting_rules.md §8 自检直接交付 + +## 输出 + +完成后给用户: +- 文件路径(`<标准名称>.docx` + `<标准名称>_编制说明.docx` + sections/*.md) +- 要素清单核对表(对照 gbt_1_1_structure.md §1:哪些要素已写、哪些可选项省略及理由) +- 技术指标矩阵(指标 ↔ 试验方法闭环逐项核对) +- `` 待补项清单(待用户/检测数据补的指标值 / 引用标准版本号 / 起草人信息) diff --git a/skills/standard/references/drafting_rules.md b/skills/standard/references/drafting_rules.md new file mode 100644 index 0000000..60f4b19 --- /dev/null +++ b/skills/standard/references/drafting_rules.md @@ -0,0 +1,112 @@ +# 标准起草铁律(GB/T 1.1—2020 表述规则) + +> 每章起草前过一遍。这些是审评/复核一票否决项:能愿动词用错、不可考核措辞、指标不闭环、编标准号 —— 都会被打回。 + +## 1. 能愿动词(GB/T 1.1—2020 附录,最高频踩坑) + +规范性要素里表达不同约束强度,**只准用下表助动词**,不准用同义替换: + +| 含义 | 肯定 | 否定 | 英文对应 | 说明 | +|---|---|---|---|---| +| **要求**(必须满足才合格) | **应** | **不应** | shall / shall not | 设定可考核条款的唯一要求词 | +| **推荐**(建议但非强制) | **宜** | **不宜** | should / should not | 多个可选中推荐其一 | +| **允许**(许可,不强制) | **可** | **不必** | may / need not | 给出许可或不必要 | +| **能力/可能性**(陈述事实) | **能** | **不能** | can / cannot | 描述能力或客观可能,**不是要求** | + +**禁止**: +- ⛔ 不用 **"必须"**(表外部不可抗约束如法律法规,不作标准条款用词)。 +- ⛔ 不用 **"应该 / 要 / 须 / 应当"** 替代"应";不用 **"最好 / 尽量"** 替代"宜"。 +- ⛔ 不用 **"严禁 / 禁止 / 不得"**,一律改 **"不应"**。 +- ⛔ 资料性要素(前言/引言/资料性附录/参考文献)里**不准出现"应/宜"等条款词** —— 那里只能陈述。 + +> 自检:正文每出现一个"应",问"这条能被试验方法验证吗?" 不能验证就不该用"应"。 + +## 2. 不可考核词过滤(可验证性铁律) + +技术要求必须**可测量、可判定**。下列模糊词出现即改: + +| 禁用模糊词 | 改成 | +|---|---| +| 高强度 / 强度高 | 抗压强度 ≥ 42.5 MPa(GB/T 17671 测) | +| 耐久性好 / 性能优良 | 给具体指标 + 单位 + 试验方法章号 | +| 适当 / 适量 / 尽量 / 必要时 | 给数值范围或明确条件 | +| 严格控制 / 合理 | 给上下限数值 | +| 少量 / 微量 / 大约 | 给量值 + 允差(如 (50±1) g) | +| 良好 / 明显 / 充分 | 给可观测判据 | + +口诀:**指标 = 量 + 数值 + 单位 + 判定方向(≥/≤/介于)+ 对应试验方法**,五者缺一不可。 + +## 3. 指标量化闭环(要求 ↔ 试验方法呼应) + +每条技术要求都要在标准内**有方可验**: + +``` +"要求"章: 抗折强度应不小于 6.0 MPa。 + ↕ 必须呼应 +"试验方法"章: 抗折强度按 GB/T 17671 测定 / 按第 X 章测定。 +``` + +- 要求章给**指标值**,试验方法章给**测法**,两者用相同的量名称呼应;指标无对应测法 = 不可考核 = 退回。 +- 试验方法标准本身就是"测法",其指标(如精密度:重复性限 r、再现性限 R)也要给具体数值。 + +## 4. 术语和定义规则(第3章) + +引导语: +``` +下列术语和定义适用于本文件。 +[若部分引用其他标准] GB/T XXXX 界定的以及下列术语和定义适用于本文件。 +``` + +每条格式: +``` +3.1 +<术语> <英文对应(可选)> +<定义:一个不含术语词本身、不以"是/指/是指"开头的名词性短语> +[来源:GB/T XXXX—XXXX,3.5,有修改] ← 引用已有定义时必标来源 +``` + +- **一个术语一条定义**;定义是**替换式**的(能在正文里替换该术语而句子成立)。 +- **不重复**已有国标/行标里的术语 —— 直接引用并标来源,不照抄改写。 +- 不给"显而易见的常用词"下定义(如"水""温度")。 +- 术语按概念关联或正文出现顺序排,逐条编号 3.1、3.2… + +## 5. 引用真实性(不可编造) + +- **标准号、标准名、来源条款号一字不编**。不确定真实性 → 用 research / web_search 核实,核不到就标 ``,不靠训练数据脑补。 +- 建材常用真实基础标准(可直接引,仍建议核版本年号): + - GB/T 8170 数值修约规则与极限数值的表示和判定 + - GB/T 17671 水泥胶砂强度检验方法(ISO 法) + - GB/T 1346 水泥标准稠度用水量、凝结时间、安定性检验方法 + - GB/T 1345 水泥细度检验方法 + - GB/T 6682 分析实验室用水规格和试验方法 + - GB/T 601、GB/T 602、GB/T 603 化学试剂相关 +- 注日期 vs 不注日期:见 gbt_1_1_structure.md §5。 + +## 6. 数值、单位、量(GB/T 1.1 + 相关基础标准) + +- 用**法定计量单位(SI)**;量符号**斜体**,单位符号**正体**(如 *t* = 28 d,质量 (50±1) g)。 +- 数值修约按 **GB/T 8170**;极限数值表示"不大于/不小于"或"≤/≥",**不混用"~"表范围歧义**。 +- 量值与单位间留空格:`6.0 MPa`、`(20±2) ℃`、`28 d`;百分数 `≥ 95 %` 或 `95%`(全文统一)。 +- 公差写 `(50±1) g` 这种带括号统一形式。 + +## 7. 条款层次与编号 + +- **章**:1、2、3…(每章有标题);**条**:5.1、5.1.1、5.1.1.1(最多分到第 5 层但尽量浅)。 +- **列项**:无序用破折号"——";有序用 `a) b) c)`,再分 `1) 2)`。列项不单独编章条号。 +- **图、表、公式**全标准连续编号(图1/图2、表1/表2、公式(1));render_docx 自动给图编号,**表与公式手动按章节连续编**。 +- 注、示例:`注:` / `示例:` 顶格,属资料性,**不写要求**。 + +## 8. 起草前自检清单(渲染前逐条过) + +1. □ 要素齐全且顺序对(对照 gbt_1_1_structure.md §1) +2. □ 必备要素(封面/前言/名称/范围)都在 +3. □ 规范性 vs 资料性归类正确(资料性要素无"应/宜"条款) +4. □ 能愿动词全部合规(无"必须/应该/严禁/不得") +5. □ 无不可考核模糊词;每条要求有数值+单位+判定方向 +6. □ 每条技术要求有对应试验方法(闭环) +7. □ 术语一术一义、引用标来源、不重复已有 +8. □ 引用标准号真实、排序正确、引导语固定 +9. □ 量/单位/修约合规,法定计量单位 +10. □ 图表公式编号连续,无 ASCII 字符画当图 +11. □ 无 `` 残留 +12. □ 编制说明已同步(报批必交,见 templates/drafting_note.md) diff --git a/skills/standard/references/gbt_1_1_structure.md b/skills/standard/references/gbt_1_1_structure.md new file mode 100644 index 0000000..70b98ab --- /dev/null +++ b/skills/standard/references/gbt_1_1_structure.md @@ -0,0 +1,111 @@ +# GB/T 1.1—2020 标准文件要素骨架 + +> 写国标 / 行标 / 团标的**元规范**。GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》强制适用于国家、行业、地方标准的起草,**团体标准参照使用**(CSTM 即按此 + GB/T 20001.4 起草)。本文件给要素清单、编排顺序、必备/可选、规范性/资料性的判定,以及封面与前言的固定套话。 + +## 1. 要素编排顺序(从前到后) + +| 序 | 要素 | 必备/可选 | 规范性/资料性 | 章号 | 说明 | +|---|---|---|---|---|---| +| 1 | 封面 | **必备** | 资料性 | — | ICS/CCS/编号/中英文名/发布实施日期/发布单位 | +| 2 | 目次 | 可选 | 资料性 | — | render_docx 自动生成 TOC,**不手写** | +| 3 | 前言 | **必备** | 资料性 | — | 固定套话见 §3 | +| 4 | 引言 | 可选 | 资料性 | — | 说明制定背景/技术内容由来;**不写要求** | +| 5 | 标准名称 | **必备** | — | — | 引导要素+主体要素[+补充要素],印在封面 | +| 6 | 范围 | **必备** | 规范性 | 第1章 | 界定对象与适用界限,见 §4 | +| 7 | 规范性引用文件 | 可选 | 规范性 | 第2章 | 固定引导语见 §5;只列正文规范性引用到的 | +| 8 | 术语和定义 | 可选 | 规范性 | 第3章 | 一术语一定义,带来源;见 drafting_rules.md | +| 9 | 符号、代号和缩略语 | 可选 | 规范性 | 第4章 | 有才写 | +| 10 | 分类和编码 / 系统构成 | 可选 | 规范性 | — | 产品标准常有"分类与标记" | +| 11 | 总体原则 / 总则 | 可选 | 规范性 | — | | +| 12 | **核心技术要素** | 体裁决定 | 规范性 | 多章 | 试验方法见 test_method.md;产品见 product_standard.md | +| 13 | 标志、标签、包装、运输、贮存 | 产品标准必备 | 规范性 | 末几章 | | +| 14 | 规范性附录 | 可选 | 规范性 | 附录 A… | 标"(规范性)";正文有引用才放 | +| 15 | 资料性附录 | 可选 | 资料性 | 附录 X… | 标"(资料性)" | +| 16 | 参考文献 | 可选 | 资料性 | — | 资料性引用的文献放这里(区别于第2章) | +| 17 | 索引 | 可选 | 资料性 | — | 长标准才需要 | + +**附录顺序**:规范性附录与资料性附录**按正文首次提及的先后混合编号**(A、B、C…),不是先规范后资料;每个附录标题下用"(规范性)"或"(资料性)"标明属性。 + +## 2. 四类要素的判定(写每一段前先归类) + +- **规范性要素**:界定标准范围或设定可考核条款的要素(范围、规范性引用文件、术语和定义、符号、要求、试验方法、规范性附录)。**这些里出现的"应/宜/可"才有约束力**。 +- **资料性要素**:标识标准、介绍内容、提供附加信息(封面、目次、前言、引言、参考文献、索引、资料性附录)。**资料性要素里不准写"应"等要求型条款** —— 引言里写"产品应满足…"是典型错误。 + +> 判定口诀:**这段话被引用时会成为必须遵守的条款吗?** 是 → 规范性;只是背景/出处/说明 → 资料性。 + +## 3. 前言固定套话(必背,逐条按需保留) + +前言**不准包含要求和推荐**,只交代来源与沿革。标准句式(按顺序): + +``` +本文件按照 GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定起草。 + +[修订时才写] 本文件代替 XXX—XXXX《……》,与 XXX—XXXX 相比,除结构调整和编辑性改动外,主要技术变化如下: +——更改了……(见 X.X,XXXX 年版的 X.X); +——增加了……(见 X.X); +——删除了……(见 XXXX 年版的 X.X)。 + +请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 + +本文件由 ×××× 提出。 +本文件由 ×××× 归口。 [团标:本文件由 ×××× 标准化技术委员会归口] +本文件起草单位:××××、××××。 +本文件主要起草人:×××、×××。 +[修订时] 本文件及其所代替文件的历次版本发布情况为:…… +``` + +- 团标(CSTM)归口写到对应专业技术委员会;提出单位通常是起草牵头单位或委员会。 +- 起草单位按贡献排序,牵头单位在前;起草人**真实姓名**,不编。 + +## 4. 范围(第1章)写法 + +两要素,**不写要求,不写"本标准规定了…的要求"以外的实质条款**: +1. 一句话**界定标准化对象和所覆盖的方面**:"本文件规定了……的术语和定义、……、试验方法……"(动词按体裁:规定/界定/确立)。 +2. **指明适用界限**:"本文件适用于……。"必要时加"本文件不适用于……。" + +> 句式:`本文件规定了 <对象> 的 <技术要素清单>。` + `本文件适用于 <适用范围>。` +> 试验方法标准用"本文件描述了……的试验方法";产品标准用"本文件规定了……的分类、技术要求、试验方法、检验规则以及标志、包装、运输和贮存"。 + +## 5. 规范性引用文件(第2章)固定引导语 + +``` +下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 + +GB/T 8170 数值修约规则与极限数值的表示和判定 +GB/T 17671 水泥胶砂强度检验方法(ISO 法) +…… +``` + +- 文件号在前、文件名在后,**按标准号字母+数字升序排**(GB 在前,然后 GB/T、JC/T、ISO…)。 +- **只列正文中以规范性方式引用到的**(即引用后构成必须遵守的条款);仅作背景参考的放"参考文献"。 +- 若无规范性引用文件,本章可省略(但试验/产品标准几乎都有)。 +- 不编标准号 —— 拿不准真实性时走 research/web 核实,见 drafting_rules.md §引用真实性。 + +## 6. 封面要素排布(自上而下) + +``` +ICS <国际标准分类号,如 91.100.10 水泥> +CCS <中国标准文献分类号,如 Q11> ← 注意是 CCS,不是旧的"中标分类号" + + <标准类别:国家标准 / 中华人民共和国建材行业标准 / 团体标准> + +<标准编号,如 GB/T xxxxx—2026 / JC/T xxxx—2026 / T/CSTM xxxxx—2026> +[代替 XXX—XXXX] ← 修订才有 + +<标准中文名称> +<标准英文名称> + +<发布稿/征求意见稿/送审稿 等阶段标注> ← 草稿阶段标注,正式发布去掉 + +XXXX—XX—XX 发布 XXXX—XX—XX 实施 + <发布单位 / 团体全称> +``` + +- 国标编号:强制 `GB xxxxx—年份`,推荐 `GB/T xxxxx—年份`。 +- 行标(建材):`JC/T xxxx—年份`(推荐)/ `JC xxxx—年份`(强制)。 +- 团标:`T/<团体代号> xxxxx—年份`,CSTM 即 `T/CSTM xxxxx—年份`。 +- 年份与编号之间是**一字线"—"**(占一个汉字宽),不是连字符"-"。 + +## 7. 与官方模板的关系(重要) + +本 skill 产出的是**内容结构规范的草稿 .docx**(复用 proposal 渲染:宋体小四/1.5 倍行距/自动目次)。**正式报批前需把内容灌入标准发布机构的官方模板**(国标 TCS 2017 模板 / CSTM 提供的 Word 模板)——官方模板才有双栏前言、精确页眉页脚、封面版式。本 skill 保证**要素齐、顺序对、条款合规、措辞合规**,版式精修交给官方模板。 diff --git a/skills/standard/references/standard_levels.md b/skills/standard/references/standard_levels.md new file mode 100644 index 0000000..ac3de2e --- /dev/null +++ b/skills/standard/references/standard_levels.md @@ -0,0 +1,64 @@ +# 标准层级选型:国标 / 行标 / 团标 + +> 阶段一定层级时读这份。覆盖三类(用户已确认不做地标):国家标准、行业标准、团体标准。给代号规则、归口路径、立项程序、制定周期,以及"研究院该选哪类"的决策。 + +## 1. 三类速查 + +| 维度 | 国标 GB / GB/T | 行标(建材 JC/T) | 团标 T/(重点 CSTM) | +|---|---|---|---| +| 编号 | `GB xxxxx—年份`(强制)/ `GB/T xxxxx—年份`(推荐) | `JC/T xxxx—年份`(推荐)/ `JC xxxx—年份`(强制) | `T/<团体代号> xxxxx—年份`,如 `T/CSTM xxxxx—年份` | +| 制定主体 | 国务院标准化主管部门(SAC/国家标准委) | 行业主管部门(建材归**工信部**) | 社会团体自行制定 | +| 归口 | 全国专业标准化技术委员会(TC/SC) | 行业标委会,报国标委备案 | 团体下属标准化技术委员会 | +| 效力 | 全国通用,强制性国标必须执行 | 行业范围,GB 缺位时填补 | **自我声明、自愿采用**;被合同/招标引用即有约束力 | +| 立项到发布 | 长(1.5~3 年,计划性强) | 中(1~2 年) | **短(最快 6~12 个月)**,程序自定 | +| 公开平台 | 全国标准信息公共服务平台 | 同上 | 全国团体标准信息平台 ttbz.org.cn | +| 起草依据 | GB/T 1.1—2020 + GB/T 20001.x | 同国标 | 参照 GB/T 1.1—2020 + GB/T 20001.x(CSTM 明确按此) | + +**采用优先级**(选用现成标准时):国标 > 行标 > 团标 > 企标。 +**制定可行性**(研究院想牵头立项时,反过来):团标(T/CSTM)最易牵头、周期最短 > 行标 > 国标。建材院做检测方法/新材料评价,**首选 T/CSTM 试验方法团标**,成熟后再向行标/国标转化。 + +## 2. 行业标准代号(建材相关) + +| 代号 | 行业 | 对建材院 | +|---|---|---| +| **JC / JC/T** | **建筑材料** | **主战场**(水泥、玻璃、陶瓷、耐火、新型建材) | +| JG / JGJ | 建筑工程 / 工程建设 | 建材用于工程时相关 | +| GB / GB/T | (国标,非行标) | 通用基础、检测方法多在国标 | +| YB | 黑色冶金 | 耐火材料部分交叉 | +| HG | 化工 | 部分无机非金属交叉 | + +> 行标代号后加"/T"表推荐性(JC/T),不加为强制性(JC)。建材产品/方法标准绝大多数是 JC/T。 + +## 3. CSTM(中关村材料试验技术联盟)专题 + +研究院做材料试验/评价类团标的首选平台,与建材院检测方向高度对口。 + +- **来头**:2016 年在中国工程院、工信部、国家标准化管理委员会、中关村管委会指导下成立的市场化社团标准化组织,北京市民政局注册,全国范围非营利社团法人。 +- **体系三维**:从**材料属性、材料应用、通用技术**三个维度设专业技术委员会(领域委员会),实现"基本属性—应用属性—通用技术"协调复合。 +- **编号**:`T/CSTM xxxxx—年份`(五位流水号)。例:`T/CSTM 00524—2022 水泥混凝土和砂浆用合成纤维试验方法`(建材+试验方法,直接对口)。 +- **起草依据**:**GB/T 1.1—2020 + GB/T 20001.4(试验方法标准编写规则)**,产品标准走 GB/T 20001 对应部分。 +- **公开**:全国团体标准信息平台自我声明公开。 + +### CSTM 立项与制定程序(团标通用,各团体细节自定) + +1. **立项申请**:需求/研制方提交《立项申请书》+ 论证材料。论证材料一般含:制定的目的意义、国内外现状、主要技术要素及参数说明、**有法定资质检验机构出具的相关检测报告**。 +2. **起草**:成立起草组(需覆盖面与代表性),形成**征求意见稿 + 编制说明**(编制说明骨架见 templates/drafting_note.md,**报批必交**)。 +3. **征求意见**:公开/定向征求,处理意见汇总形成送审稿。 +4. **审查**:技术委员会会审(会审/函审),通过形成报批稿。 +5. **批准发布**:团体批准,平台公开,赋编号。 + +> 国标/行标程序类似但更长、更刚性(预研→立项→起草→征求意见→审查→报批→批准→出版),且须经对应 TC 归口、国标委审批。**研究院牵头时把"立项依据 + 检测数据 + 起草组代表性"备齐是过会关键。** + +## 4. 选型决策树(阶段一用) + +``` +要解决什么? +├─ 把一种"测材料某性能的方法"标准化(原理/试剂/仪器/步骤/结果) → 试验方法标准 +│ └─ 优先 T/CSTM(快、对口);若已有行业共识且主管部门推动 → JC/T 行标 +├─ 规定一类"产品该满足的要求"(分类/技术要求/检验规则/标志包装) → 产品标准 +│ └─ 行业通用且需准入 → JC/T;企业联盟先行先试 → T/CSTM +├─ 统一一个领域的"术语" → 术语标准(GB/T 20001.1),多为国标/行标 +└─ 规范一套"工艺/施工/管理过程" → 规程/规范标准(GB/T 20001.5/.10) +``` + +层级与体裁是两个正交维度:**层级**(谁发布:GB/JC/T·CSTM)定程序与效力,**体裁**(写什么:方法/产品/术语/规程)定章节骨架。spec 里两者都要定。 diff --git a/skills/standard/templates/drafting_note.md b/skills/standard/templates/drafting_note.md new file mode 100644 index 0000000..3daa737 --- /dev/null +++ b/skills/standard/templates/drafting_note.md @@ -0,0 +1,106 @@ +# 编制说明骨架(标准报批必交件) + +> 标准草稿(征求意见稿/送审稿/报批稿)**必须随附《编制说明》** —— 国标/行标/团标(含 CSTM)报批都要。它回答"为什么要这条标准、指标怎么定出来的、验证没有"。本骨架另存一份 docx,与标准正文一起交。 +> +> 渲染:可作为独立 sections 集渲染成 `<名称>_编制说明.docx`,或并入主文档后段。`#`=章标题。 + +--- + +## 01_工作简况.md + +``` +# 一、工作简况 + +## 1.1 任务来源 +本标准由 提出,,由 归口。 + +## 1.2 起草单位与分工 +。 + +## 1.3 主要工作过程 +。 +``` + +--- + +## 02_制定背景与意义.md + +``` +# 二、标准制定的目的和意义 + + +``` + +--- + +## 03_国内外现状.md + +``` +# 三、国内外标准现状与本标准的关系 + +## 3.1 现有相关标准 +。 + +## 3.2 与现有标准的协调 +本标准与 的关系:。 +[采用国际标准时] 本标准 采用 。 +``` + +> 此节常需真实文献/标准支撑 → 可联动 research / documents / web_search 查证,**不编标准号**。 + +--- + +## 04_主要技术内容确定依据.md + +``` +# 四、主要技术内容及其确定依据 + +> 逐条对应正文关键指标(抄 spec §6 矩阵展开),给"为什么取这个值"。这是审查最关注的一节。 +## 4.1 <指标1,如抗折强度 ≥ 6.0 MPa> +确定依据: +试验数据:。 + +## 4.2 <指标2> +... + +## 4.3 试验方法的选择依据 +。 +``` + +--- + +## 05_试验验证.md + +``` +# 五、试验(验证)情况 + +。 +``` + +--- + +## 06_征求意见处理.md + +``` +# 六、征求意见与处理情况 + +。 +``` + +--- + +## 07_其他.md + +``` +# 七、其他 + +## 7.1 标准类别 + + +## 7.2 知识产权 +。 + +## 7.3 实施建议 +。 +``` diff --git a/skills/standard/templates/product_standard.md b/skills/standard/templates/product_standard.md new file mode 100644 index 0000000..daf8280 --- /dev/null +++ b/skills/standard/templates/product_standard.md @@ -0,0 +1,174 @@ +# 产品标准骨架(GB/T 20001 产品标准编写规则) + +> 体裁=产品 时复制本骨架到 `/sections/NN_xxx.md`。建材产品(水泥/玻璃/陶瓷/耐火/新材)常用。每章前读 references/drafting_rules.md;核心是"分类→技术要求→试验方法→检验规则→标志包装"五段闭环。 + +> 渲染约定同 test_method.md:`#`=章,`##`=条;`>` 引用块是写作提示,不入正稿。 + +--- + +## 00_封面前言.md(资料性) + +``` +# 封面信息 +ICS CCS +标准类别:<团体标准 / 中华人民共和国建材行业标准> +编号: +中文名称: 英文名称: +发布:XXXX—XX—XX 实施:XXXX—XX—XX 发布单位: + +# 前言 + +本文件按照 GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定起草。 + +请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 + +本文件由 提出。 +本文件由 归口。 +本文件起草单位:。 +本文件主要起草人:。 +``` + +--- + +## 01_范围.md + +``` +# 1 范围 + +本文件规定了 的 <分类(和标记)、技术要求、试验方法、检验规则以及标志、包装、运输和贮存>。 + +本文件适用于 。 +[可选] 本文件不适用于 。 +``` + +--- + +## 02_规范性引用文件.md + +``` +# 2 规范性引用文件 + +下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 + +GB/T 8170 数值修约规则与极限数值的表示和判定 + +``` + +--- + +## 03_术语和定义.md + +``` +# 3 术语和定义 + +下列术语和定义适用于本文件。 + +## 3.1 +<术语> <英文(可选)> +<定义> +[来源:GB/T XXXX—XXXX,3.x] +``` + +> 无需定义则整章省。 + +--- + +## 04_分类和标记.md + +``` +# 4 分类(和标记) + +## 4.1 分类 / 型号 + + +## 4.2 标记 +产品标记由 组成。 +示例: +``` + +--- + +## 05_技术要求.md + +``` +# 5 技术要求 + +> 本章是产品标准的核心。每条要求**可考核**:量+数值+单位+判定方向,且在第6章有对应试验方法。 +## 5.1 <外观 / 尺寸偏差> + mm> + +## 5.2 <物理力学性能> +各项性能应符合表 1 的规定。 + +表 1 <产品>物理力学性能 + +| 项目 | 单位 | 指标(等级A) | 指标(等级B) | +|---|---|---|---| +| | MPa | ≥ | ≥ | +| | | | | + +## 5.3 <化学成分 / 其他> + + +## 5.4 <安全/环保限量(如适用)> + +``` + +--- + +## 06_试验方法.md + +``` +# 6 试验方法 + +> 与第5章逐项呼应(5.1↔6.1)。能引现成方法标准就引,引不到才在本章/附录写细法。 +## 6.1 <外观/尺寸> +按 测定。 + +## 6.2 <强度> +按 GB/T 17671 测定。 + +## 6.3 ... +``` + +--- + +## 07_检验规则.md + +``` +# 7 检验规则 + +## 7.1 检验分类 +检验分为出厂检验和型式检验。 +出厂检验项目:。型式检验项目:。 +型式检验在 时进行。 + +## 7.2 组批与抽样 +以 为一批,按 抽样。 + +## 7.3 判定规则 +检验结果全部符合第5章 → 判该批合格。 +。 +``` + +--- + +## 08_标志包装运输贮存.md + +``` +# 8 标志、包装、运输和贮存 + +## 8.1 标志 +产品包装上应标明:产品名称、规格型号、本文件编号、生产单位、生产日期/批号、。 + +## 8.2 包装 + + +## 8.3 运输 + + +## 8.4 贮存 + +``` + +> 规范性附录标"(规范性)",资料性附录标"(资料性)",按正文首次提及编 A、B…;参考文献放资料性引用文献。 diff --git a/skills/standard/templates/spec.md b/skills/standard/templates/spec.md new file mode 100644 index 0000000..845649f --- /dev/null +++ b/skills/standard/templates/spec.md @@ -0,0 +1,75 @@ +# 标准 spec(task 级宪法) + +> 阶段一产物。**写定后不再改**,阶段二每章前都要 read。`` 是占位符,需用户明确填值;不要硬编。 + +## 1. 标准层级与类别 + +- 层级:``(选型见 references/standard_levels.md) +- 拟编号:`` +- 强制/推荐:`` +- 归口/提出单位:`` + +## 2. 标准体裁 + +``(决定章节骨架,见对应 template) + +## 3. 标准名称 + +- 中文:`` +- 英文:`` + +## 4. 范围 + +> 一字界定对象与适用界限。不写要求。 + +- 规定了:`` +- 适用于:`` +- 不适用于:`` + +## 5. 起草信息(进前言) + +- 提出单位:`` +- 归口单位/委员会:`` +- 起草单位(按贡献排序,牵头在前):`` +- 主要起草人(真实姓名):`` +- 是否修订:`` + +## 6. 关键技术指标矩阵 ← 阶段三自检会读这一节 + +> 一行一条指标。每条必须**指标+单位+判定方向+对应试验方法**闭环(见 drafting_rules.md §3)。 + +| # | 技术指标(量名称) | 要求值(含单位+≥/≤/区间) | 对应试验方法(章号/引用标准) | 指标确定依据(进编制说明) | +|---|---|---|---|---| +| 1 | `` | `` | `` | `` | +| 2 | `` | `` | `` | `` | +| ... | + +## 7. 规范性引用文件清单(真实标准号) + +> 只列正文规范性引用到的;真实性存疑先核实,见 drafting_rules.md §5。按标准号升序。 + +``` +GB/T 8170 数值修约规则与极限数值的表示和判定 + +... +``` + +## 8. 术语清单(第3章用) + +- `` — 定义要点:``(若引用已有标准定义,标来源 GB/T xxx,3.x) +- `` — ... + +## 9. 编制说明要点(报批必交,见 templates/drafting_note.md) + +- 立项依据/目的意义:`` +- 国内外现状:`` +- 主要技术指标确定依据:`` +- 试验验证情况:`` + +## 10. TODO 列表 + +> 阶段一冒出的"等用户提供"事项。阶段二每章开头扫一眼;阶段三自检扫余留 ``。 + +- [ ] `` +- [ ] `` +- [ ] `` diff --git a/skills/standard/templates/test_method.md b/skills/standard/templates/test_method.md new file mode 100644 index 0000000..ca09281 --- /dev/null +++ b/skills/standard/templates/test_method.md @@ -0,0 +1,200 @@ +# 试验方法标准骨架(GB/T 20001.4 / 对标 T/CSTM 试验方法标准) + +> 体裁=试验方法 时复制本骨架到 `/sections/NN_xxx.md`(NN 控目次顺序)。这是建材院 + CSTM 主场。每章前读 references/drafting_rules.md。**section 文件不写封面/前言以外的资料性套话由 SKILL 阶段二处理**。 + +> 渲染约定:`#`=章标题(→ Heading 1),`##`=条(→ Heading 2)。正文用"应/宜/可";模板里 `>` 引用块是写作提示,render_docx 不入正稿。 + +--- + +## 00_封面前言.md(资料性) + +``` +# 封面信息 + +> 以下封面要素由起草人填,正式版灌官方模板;此处先占位。 +ICS +CCS +标准类别:<团体标准 / 中华人民共和国建材行业标准> +编号: +中文名称: +英文名称: +发布:XXXX—XX—XX 实施:XXXX—XX—XX +发布单位: + +# 前言 + +本文件按照 GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定起草。 + +请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 + +本文件由 提出。 +本文件由 归口。 +本文件起草单位:。 +本文件主要起草人:。 +``` + +> 引言(可选,资料性):说明方法由来/原理背景,不写要求。无则删本节。 + +--- + +## 01_范围.md + +``` +# 1 范围 + +本文件描述了 的 的试验方法。 + +本文件适用于 。 +[可选] 本文件不适用于 。 +``` + +--- + +## 02_规范性引用文件.md + +``` +# 2 规范性引用文件 + +下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 + +GB/T 6682 分析实验室用水规格和试验方法 +GB/T 8170 数值修约规则与极限数值的表示和判定 + +``` + +--- + +## 03_术语和定义.md + +``` +# 3 术语和定义 + +下列术语和定义适用于本文件。 + +## 3.1 +<术语> <英文(可选)> +<定义:替换式名词短语,不以"是/指"开头> +[来源:GB/T XXXX—XXXX,3.x] ← 引用才标 + +## 3.2 +... +``` + +> 无需定义术语时整章可省。符号和缩略语有才单列第 4 章。 + +--- + +## 04_方法原理.md + +``` +# 4 方法原理 + + +``` + +--- + +## 05_试剂和材料.md + +``` +# 5 试剂和材料 + +除非另有说明,仅使用确认为分析纯的试剂和 GB/T 6682 规定的 水。 + +## 5.1 <试剂名> + + +## 5.2 ... +``` + +> 纯试验方法无试剂时本章可改为"材料"或省略。 + +--- + +## 06_仪器设备.md + +``` +# 6 仪器设备 + +## 6.1 <仪器名> +。 + +## 6.2 ... +``` + +--- + +## 07_试样.md + +``` +# 7 试样(试样制备 / 取样) + + +``` + +--- + +## 08_试验步骤.md + +``` +# 8 试验步骤 + +> 按操作时序分条,每步可考核;条件给数值+允差。 +## 8.1 <准备> + +## 8.2 <测定> + min……> +## 8.3 <平行测定数量> +每个试样测定 次。 +``` + +--- + +## 09_结果计算.md + +``` +# 9 试验结果 + +## 9.1 结果计算 +按式(1)计算 <目标量>: +公式 (1): X = ... +式中: +X —— ,单位为 ; +... —— ... +计算结果按 GB/T 8170 修约至 。 + +## 9.2 结果表示 +以 次平行测定的算术平均值作为试验结果,。 +``` + +--- + +## 10_精密度.md + +``` +# 10 精密度 + +> 试验方法标准的"考核指标",必须给数值。 +## 10.1 重复性 +在重复性条件下两次独立测定结果之差不大于 。 + +## 10.2 再现性 +在再现性条件下两次独立测定结果之差不大于 。 +``` + +--- + +## 11_试验报告.md + +``` +# 11 试验报告 + +试验报告应包括下列内容: +a) 本文件编号; +b) 试样标识; +c) 试验结果及表示; +d) 试验中观察到的异常现象; +e) 试验日期、操作人员。 +``` + +> 规范性附录(如有,标"(规范性)")按正文首次提及编 A、B…;资料性附录标"(资料性)";参考文献放资料性引用文献。