元公(yotta-school-doc)
本地、确定性的学校公文可信起草与校验技能。元公把「文种要求、事实输入与已有文稿」变成两件可复算的东西:
- 一份不编造事实的文书骨架;
- 一份带行号证据的确定性缺口清单。
可信契约:
- 缺失事实统一显示为
〔待补〕,并进入缺口清单; - 日期支持
YYYY-MM-DD与YYYY年M月D日,内部归一化后比较; - 同一事实 JSON + 同一规则包 = 同一骨架(仅生成时间变化);
- 核心路径不联网、不调用模型,文稿与校情数据只在本机流转。
何时使用
- 先把通知、告家长书、请示、报告、工作总结、会议纪要、工作方案或简报的结构骨架搭起来;
- 用
check核对已有文稿:标题、受文对象、成文单位、日期、联系方式、办理要求是否齐全; - 核对日期格式、成文日期与截止日期是否倒置、文稿日期与事实清单是否一致;
- 核对附件引用、未定占位值、学生个人信息、过度承诺表述与会议待办;
- 把学校公文结构检查接入批处理或 CI(
--gate findings=n)。
Do NOT trigger:
- 不生成完整成稿,也不编造姓名、日期、数字、文号、单位、政策依据或会议结论;
- 不提供法律、合规、督导或意识形态审查结论;
- 不替代学校审批链与最终签发责任:输出是骨架与缺口清单,最终定稿由学校负责人确认;
- 不联网、不调用模型、不上传学校文稿与校情数据;
- 不内置党政机关公文标准全文、真实学校模板或案例正文;需要润色时交给元真,需要统一呈现时交给元呈。
快速使用
# 生成规则包、事实 JSON 与骨架示例
python3 scripts/yotta_school_doc.py template --output-dir ./school-doc-template
# 按事实 JSON 生成文书骨架
python3 scripts/yotta_school_doc.py draft --type notice --facts facts.json
# 输出 JSON 骨架
python3 scripts/yotta_school_doc.py draft --type notice --facts facts.json --format json
# 检查已有文稿,缺口 ≥ 1 时让 CI 失败
python3 scripts/yotta_school_doc.py check --doc notice.md --type notice --facts facts.json --gate findings=1
# 查看内置文种
python3 scripts/yotta_school_doc.py types list
# 校验自定义规则包
python3 scripts/yotta_school_doc.py types validate --types school-types.json
退出码:0 正常 | 1 触发 --gate | 2 输入错误 | 3 文种或规则包错误 | 4 运行时错误。
输入与输出
- 文种规则包:JSON,声明
id/name/title_keywords/required_fields/required_sections/sensitive_terms/visibility_default; - 结构化事实:JSON,声明
doc_type/visibility与标题、单位、日期、受文对象、联系方式、正文要点、附件等; - 骨架:Markdown 或 JSON(
schema_version 1.0,含document/facts/fields/body_points/attachments/findings/sources/disclaimer); - 检查报告:Markdown 或 JSON(含
document/facts/checked/findings/summary/sources/disclaimer)。
字段规范见 references/types-format.md;报告契约见 references/report-format.md。
检查项
| 缺口 | 含义 |
|---|---|
field_missing |
必填字段在文稿中找不到 |
section_missing |
必填结构段缺失 |
date_format_invalid |
出现 2026/9/24、2026.9.24 等不符合约定格式的日期 |
date_order_invalid |
成文日期晚于办理截止日期 |
fact_date_mismatch |
文稿日期与事实清单不一致 |
attachment_missing |
事实附件未在正文或附件清单中出现 |
attachment_unknown |
文稿写了附件但事实清单没有 |
placeholder_present |
文稿仍含 〔待补〕、未完成标记、待定 等未定值 |
privacy_risk |
公开文书出现学生身份证号、手机号、邮箱或家庭住址等个人信息 |
action_item_incomplete |
会议纪要待办缺少责任人或完成时间 |
sensitive_term_review |
出现处分、开除、罚款、追责、承诺、保证等需人工复核的表述 |
overclaim_review |
出现确保、全部、彻底、100% 等过度承诺 |
隐私与边界
- 本地运行:零网络、零模型;学校文稿、校情事实、参会人员信息只在本机流转;
- 个人信息识别只做规则命中提示,不做身份判断;命中即建议删改、脱敏或改走内部流转;
- 不内置 GB/T 9704 或任何标准全文、真实公文模板;内置规则只记录结构性字段与通用词;
- 输出为文书辅助与风险提示,不构成法律、合规、督导或意识形态审查结论;最终签发责任在学校。
详见 references/privacy.md。
家族协同
- 元真 yotta-humanize:对学校作者写好的正文做中文文风润色;
- 元呈 yotta-present:把骨架与检查报告渲染成统一格式;
- 元规 yotta-compliance:需要条款级合规审查时另行使用,元公不代替它下结论;
- 元忆 yotta-memory:按需保存规则包版本与检查摘要。
渐进披露
- 规则包与字段契约:
references/types-format.md - 骨架 / 检查报告契约与退出码:
references/report-format.md - 隐私与使用边界:
references/privacy.md
按需读取,不必每次全读。
