| name | supervision-log-autofill |
| description | Generate, complete, review, normalize, and template-fill Chinese construction supervision daily logs or construction logs. Use when the user asks to upload/register a 监理日志模板 or 施工日志模板, write, auto-fill, polish, extract, convert, or batch-generate 监理日志, 施工监理日志, 施工日志, 旁站记录, 巡视记录, 平行检验记录, 监理日报, or project supervision log content from field notes, photos, voice transcripts, weather, schedules, existing logs, Excel/Word/Markdown templates, or informal Chinese construction notes. |
Supervision Log Autofill
Core Workflow
- Identify the target artifact: 监理日志, 旁站记录, 巡视记录, 平行检验记录, 监理日报, or a user-provided template.
- Read any provided template, previous log, Excel/Word/Markdown file, image OCR text, voice transcript, or field notes before drafting.
- Extract facts into structured fields: date, weather, project, construction part, work activities, workforce, machinery, materials, quality, safety, progress, supervision actions, issues,整改要求,闭环状态, and next-day focus.
- Draft in formal Chinese supervision style. Distinguish facts from inferences. Do not invent names, quantities, inspections, test results, measurements, or整改闭环.
- Mark missing critical fields with
待补充: instead of fabricating them.
- Run a consistency pass: no contradiction between weather/progress/activities, no impossible dates, no closed-loop language without evidence, no vague "正常" if field notes mention issues.
- Output in the requested format. If none is specified, output clean Markdown with headings that can be pasted into a log system.
Voice Input Quick Entry
Support text produced by a phone or desktop Chinese voice input method. Treat it as dictated text, not an audio file. The user can speak one continuous paragraph; the skill should split it into fields and现场事项.
Recommended spoken pattern:
项目 某房建工程 日期 2026年6月20日 天气 多云转阵雨 温度 24到31度 监理 张三 施工单位 某总包 部位 1号楼三层梁板 上午钢筋绑扎 木工12人钢筋工18人 塔吊1台 发现板筋保护层垫块不足 要求施工单位补设后复查 下午检查临边防护 电梯井口防护门松动 要求立即加固 明天计划浇筑混凝土
Normalize voice-input text:
python D:\Codex\Home\skills\supervision-log-autofill\scripts\voice_quick_input.py --text "项目 某房建工程 天气 多云 部位 1号楼三层 梁板钢筋绑扎 木工12人 发现垫块不足 要求整改"
Generate a log directly from voice-input text:
python D:\Codex\Home\skills\supervision-log-autofill\scripts\generate_supervision_log.py --voice-text "项目 某房建工程 天气 多云 部位 1号楼三层 梁板钢筋绑扎 木工12人 发现垫块不足 要求整改"
Voice-input rules:
- Keep short cue words in the spoken text:
项目、日期、天气、温度、监理、施工单位、部位.
- Say issue and action together when possible:
发现...要求...整改...复查.
- If the voice text is ambiguous, preserve the original clause under现场事项 and mark missing fields as
待补充.
- Do not treat dictated future plans as completed work.
Template Upload
When the user provides a supervision log or construction log template, first register it:
python D:\Codex\Home\skills\supervision-log-autofill\scripts\import_template.py --template ".\监理日志模板.docx" --name "公司监理日志模板" --type supervision-log
Supported source files: .docx, .xlsx, .xls, .doc, .pdf, .md, .txt, .csv, .json.
The import script copies the original template into assets/templates/<template-id>/, extracts readable text when possible, detects field labels/placeholders, and updates assets/templates/index.json.
List imported templates:
python D:\Codex\Home\skills\supervision-log-autofill\scripts\import_template.py --list
Use an imported template when generating a draft:
python D:\Codex\Home\skills\supervision-log-autofill\scripts\generate_supervision_log.py --template "公司监理日志模板" --project "项目名称" --date 2026-06-20 --notes-file ".\现场记录.txt" --output ".\监理日志-2026-06-20.md"
If a Word/Excel template has complex merged cells or formatting, preserve the original template file and use the extracted field list as the fill map. Do not overwrite the original template unless the user explicitly asks.
Field Standard
Use references/field-schema.md when the user needs a formal schema, template adaptation, batch conversion, or quality review.
Default sections:
- 基本信息: 工程名称、日期、星期、天气、温度、监理人员、施工单位、施工部位。
- 施工情况: 当日施工内容、人员机械、材料进场、形象进度。
- 监理工作: 巡视、旁站、平行检验、见证取样、资料核查、会议/协调、通知指令。
- 质量控制: 检查项目、验收/复核结果、质量问题、处理要求。
- 安全文明: 安全巡视、隐患、整改要求、文明施工。
- 进度与协调: 进度偏差、原因、协调事项、次日关注。
- 问题闭环: 问题来源、责任单位、整改期限、复查结果、未闭合事项。
Drafting Rules
- Prefer concise, objective, construction-professional wording.
- Use "经巡视检查", "现场要求施工单位", "已督促", "经复查" only when supported by notes.
- Use "未见明显异常" only for scoped checks, such as "模板支撑体系外观检查未见明显异常".
- Use "待补充" for absent weather, quantities, personnel, machinery, exact locations, or test results.
- Keep quality and safety issues separate.
- Include supervision action for every issue: verbal instruction, written notice,整改期限, reinspection, or escalation.
- Preserve project-specific terminology from the user's notes, including floor/axis/area names.
- Do not cite laws, codes, or mandatory clauses unless the user provides the standard or asks for a code-based review.
Quick Generator
For a first draft from notes, run:
python D:\Codex\Home\skills\supervision-log-autofill\scripts\generate_supervision_log.py --project "项目名称" --date 2026-06-20 --weather "多云" --notes-file ".\现场记录.txt" --output ".\监理日志-2026-06-20.md"
The script creates a structured Markdown draft and preserves missing items as 待补充. It is deterministic and does not call external APIs.
Output Checklist
Before finalizing, verify:
- Date and weekday match.
- Weather and temperature are present or marked missing.
- Each issue has a responsible party or
待补充.
- Each整改闭环 says whether it is complete, pending, or awaiting reinspection.
- The text does not exaggerate site activities beyond the notes.
- The final format matches the user's target system or document template.
