rfc3339-ixdtf
Audit code for RFC 3339 (Internet timestamps, the usual 'ISO timestamp format' of APIs and logs) and RFC 9557 (IXDTF: suffixes such as 2026-09-24T12:00:00+02:00[Europe/Paris] and [u-ca=hebrew] tags; Z now means 'local offset unknown'). USE FOR: parsing, validating or emitting these timestamps in any language (Python, JS and Temporal ZonedDateTime, Java, .NET, Go, Rust, Swift); choosing Z or +00:00 when the offset is unknown; leap second 23:59:60 legality; reviewing producers, consumers and schemas (JSON Schema/OpenAPI format date-time, protobuf Timestamp, API contracts); ServiceNow GlideDateTime and Fluent SDK date handling; running conformance vectors against a parser; scanning source for risky date-time APIs (strftime %z, literal 'Z'). DO NOT USE FOR: ISO 8601 durations, week or ordinal dates, intervals; HTTP-date or RFC 5322 email dates; time-zone arithmetic unrelated to serialization.
- License 许可
- MIT
- 最近更新
- 2026-10-25
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- rfc3339-ixdtf
- metadata
- { "author": "local", "sources": "RFC 3339 (July 2002) + errata 293,1584,3710,4110,5624,5783,6533; RFC 9557 (April 2024) + erratum 8192; IANA Internet Date/Time Format registry (snapshot 2026-09-24)", "version": "1.0.0" }
- description
- Audit code for RFC 3339 (Internet timestamps, the usual 'ISO timestamp format' of APIs and logs) and RFC 9557 (IXDTF: suffixes such as 2026-09-24T12:00:00+02:00[Europe/Paris] and [u-ca=hebrew] tags; Z now means 'local offset unknown'). USE FOR: parsing, validating or emitting these timestamps in any language (Python, JS and Temporal ZonedDateTime, Java, .NET, Go, Rust, Swift); choosing Z or +00:00 when the offset is unknown; leap second 23:59:60 legality; reviewing producers, consumers and schemas (JSON Schema/OpenAPI format date-time, protobuf Timestamp, API contracts); ServiceNow GlideDateTime and Fluent SDK date handling; running conformance vectors against a parser; scanning source for risky date-time APIs (strftime %z, literal 'Z'). DO NOT USE FOR: ISO 8601 durations, week or ordinal dates, intervals; HTTP-date or RFC 5322 email dates; time-zone arithmetic unrelated to serialization.
02 资源文件 253
- 参考文档.claude-plugin/plugin.json579 B
- 其他.gitignore66 B
- 参考文档evals/baselines/probes/go-vectors/json.txt5.8 KB
- 参考文档evals/baselines/probes/go-vectors/jsonv2.txt5.1 KB
- 参考文档evals/baselines/probes/go-vectors/parse3339.txt5.8 KB
- 参考文档evals/baselines/probes/go-vectors/parse3339nano.txt5.8 KB
- 参考文档evals/baselines/probes/go-vectors/strict.txt3.3 KB
- 参考文档evals/baselines/probes/go-vectors/unmarshaltext.txt5.8 KB
- 参考文档evals/baselines/probes/rust-reports/chrono-fromstr.json116.1 KB
- 参考文档evals/baselines/probes/rust-reports/chrono-fromstr.txt6.3 KB
- 参考文档evals/baselines/probes/rust-reports/chrono-serde.json109.8 KB
- 参考文档evals/baselines/probes/rust-reports/chrono-serde.txt6.3 KB
- 参考文档evals/baselines/probes/rust-reports/chrono.json113.4 KB
- 参考文档evals/baselines/probes/rust-reports/chrono.txt4.4 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-timestamp-both.json151.2 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-timestamp-both.txt17.9 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-timestamp.json125.9 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-timestamp.txt9.0 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-always-offset.json152.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-always-offset.txt11.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-always-timezone.json152.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-always-timezone.txt11.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-bracketed-probes.json8.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-prefer-offset.json152.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-prefer-offset.txt11.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-reject.json149.7 KB
- 参考文档evals/baselines/probes/rust-reports/jiff-zoned-reject.txt9.3 KB
- 参考文档evals/baselines/probes/rust-reports/time.json113.9 KB
- 参考文档evals/baselines/probes/rust-reports/time.txt4.2 KB
- 参考文档evals/baselines/probes/vector-runs/dotnet.txt86.3 KB
- 参考文档evals/baselines/probes/vector-runs/go.txt55.9 KB
- 参考文档evals/baselines/probes/vector-runs/java.txt113.8 KB
- 参考文档evals/baselines/probes/vector-runs/js.txt124.1 KB
- 参考文档evals/baselines/probes/vector-runs/jsonschema.txt33.3 KB
- 参考文档evals/baselines/probes/vector-runs/protobuf.txt9.1 KB
- 参考文档evals/baselines/probes/vector-runs/python.txt43.7 KB
- 参考文档evals/baselines/probes/vector-runs/ruby.txt69.7 KB
- 参考文档evals/baselines/probes/vector-runs/rust.txt112.0 KB
- 参考文档evals/baselines/probes/vector-runs/sql.txt131.5 KB
- 参考文档evals/baselines/probes/vector-runs/swift.txt182.8 KB
- 参考文档evals/fixtures/tempo/answer-key.md10.4 KB
- 脚本evals/fixtures/tempo/project/api.py3.5 KB
- 脚本evals/fixtures/tempo/project/client/parse.mjs3.7 KB
- 参考文档evals/fixtures/tempo/project/docs/API.md2.9 KB
- 参考文档evals/fixtures/tempo/project/schema/event.schema.json1.8 KB
- 脚本evals/fixtures/tempo/project/tests/test_timeutil.py2.4 KB
- 脚本evals/fixtures/tempo/project/timeutil.py5.2 KB
- 脚本evals/graders/gen_suite.py8.6 KB
- 参考文档evals/graders/keyspec.json10.9 KB
- 脚本evals/graders/summarize.py6.2 KB
- 参考文档evals/plugin/.claude-plugin/plugin.json203 B
- 参考文档evals/plugin/cases/rfc-consumer/case.yaml868 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/no-peek.md97 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/nodecoy-judge.md1.5 KB
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C1.md203 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C2.md188 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C3.md281 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C4.md199 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C5.md179 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C6.md182 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C7.md211 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C8.md163 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/recall-C9.md181 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C1.md246 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C2.md231 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C3.md324 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C4.md249 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C5.md222 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C6.md225 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C7.md254 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C8.md206 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/severity-C9.md224 B
- 参考文档evals/plugin/cases/rfc-consumer/graders/skill-used.md112 B
- 脚本evals/plugin/cases/rfc-consumer/scaffold.sh609 B
- 参考文档evals/plugin/cases/rfc-decoys/case.yaml1.0 KB
- 参考文档evals/plugin/cases/rfc-decoys/graders/decoy-verdicts.md1.5 KB
- 参考文档evals/plugin/cases/rfc-decoys/graders/no-peek.md97 B
- 参考文档evals/plugin/cases/rfc-decoys/graders/nodecoy-D1.md322 B
- 参考文档evals/plugin/cases/rfc-decoys/graders/nodecoy-judge.md1.8 KB
- 参考文档evals/plugin/cases/rfc-decoys/graders/skill-used.md112 B
- 脚本evals/plugin/cases/rfc-decoys/scaffold.sh609 B
- 参考文档evals/plugin/cases/rfc-producer/case.yaml857 B
- 参考文档evals/plugin/cases/rfc-producer/graders/no-peek.md97 B
- 参考文档evals/plugin/cases/rfc-producer/graders/nodecoy-D1.md322 B
- 参考文档evals/plugin/cases/rfc-producer/graders/nodecoy-judge.md1.2 KB
- 参考文档evals/plugin/cases/rfc-producer/graders/recall-P1.md288 B
- 参考文档evals/plugin/cases/rfc-producer/graders/recall-P2.md270 B
- 参考文档evals/plugin/cases/rfc-producer/graders/recall-P3.md231 B
- 参考文档evals/plugin/cases/rfc-producer/graders/recall-P4.md272 B
- 参考文档evals/plugin/cases/rfc-producer/graders/recall-P5.md263 B
- 参考文档evals/plugin/cases/rfc-producer/graders/recall-P6.md292 B
- 参考文档evals/plugin/cases/rfc-producer/graders/severity-P1.md331 B
- 参考文档evals/plugin/cases/rfc-producer/graders/severity-P2.md313 B
- 参考文档evals/plugin/cases/rfc-producer/graders/severity-P3.md274 B
- 参考文档evals/plugin/cases/rfc-producer/graders/severity-P4.md315 B
- 参考文档evals/plugin/cases/rfc-producer/graders/severity-P5.md313 B
- 参考文档evals/plugin/cases/rfc-producer/graders/severity-P6.md335 B
- 参考文档evals/plugin/cases/rfc-producer/graders/skill-used.md112 B
- 脚本evals/plugin/cases/rfc-producer/scaffold.sh609 B
- 参考文档evals/plugin/cases/rfc-refusal-duration/case.yaml437 B
- 参考文档evals/plugin/cases/rfc-refusal-duration/graders/skill-not-used.md119 B
- 参考文档evals/plugin/cases/rfc-refusal-httpdate/case.yaml444 B
- 参考文档evals/plugin/cases/rfc-refusal-httpdate/graders/skill-not-used.md119 B
- 参考文档evals/plugin/cases/rfc-schema/case.yaml819 B
- 参考文档evals/plugin/cases/rfc-schema/graders/no-peek.md97 B
- 参考文档evals/plugin/cases/rfc-schema/graders/nodecoy-D1.md322 B
- 参考文档evals/plugin/cases/rfc-schema/graders/nodecoy-judge.md1.2 KB
- 参考文档evals/plugin/cases/rfc-schema/graders/recall-S1.md338 B
- 参考文档evals/plugin/cases/rfc-schema/graders/recall-S2.md194 B
- 参考文档evals/plugin/cases/rfc-schema/graders/recall-S3.md257 B
- 参考文档evals/plugin/cases/rfc-schema/graders/severity-S1.md393 B
- 参考文档evals/plugin/cases/rfc-schema/graders/severity-S2.md227 B
- 参考文档evals/plugin/cases/rfc-schema/graders/severity-S3.md312 B
- 参考文档evals/plugin/cases/rfc-schema/graders/skill-used.md112 B
- 脚本evals/plugin/cases/rfc-schema/scaffold.sh609 B
- 参考文档evals/README.md4.6 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/aggregate-result.json130.1 KB
- 其他evals/results/2026-09-25/plugin-eval-attempt1/console.log2.3 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/replies/rfc-consumer-run1.md17.7 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/replies/rfc-decoys-run1.md9.5 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/replies/rfc-producer-run1.md11.9 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/replies/rfc-refusal-duration-run1.md2.6 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/replies/rfc-refusal-httpdate-run1.md1.1 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/replies/rfc-schema-run1.md12.3 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/report.html147.7 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/summary.json4.8 KB
- 参考文档evals/results/2026-09-25/plugin-eval-attempt1/summary.md866 B
- 参考文档evals/results/2026-09-25/plugin-eval/aggregate-result.json131.1 KB
- 其他evals/results/2026-09-25/plugin-eval/console.log2.3 KB
- 参考文档evals/results/2026-09-25/plugin-eval/replies/rfc-consumer-run1.md17.7 KB
- 参考文档evals/results/2026-09-25/plugin-eval/replies/rfc-decoys-run1.md9.8 KB
- 参考文档evals/results/2026-09-25/plugin-eval/replies/rfc-producer-run1.md11.7 KB
- 参考文档evals/results/2026-09-25/plugin-eval/replies/rfc-refusal-duration-run1.md2.1 KB
- 参考文档evals/results/2026-09-25/plugin-eval/replies/rfc-refusal-httpdate-run1.md1.0 KB
- 参考文档evals/results/2026-09-25/plugin-eval/replies/rfc-schema-run1.md13.7 KB
- 参考文档evals/results/2026-09-25/plugin-eval/report.html146.5 KB
- 参考文档evals/results/2026-09-25/plugin-eval/summary.json4.6 KB
- 参考文档evals/results/2026-09-25/plugin-eval/summary.md865 B
- 参考文档evals/results/2026-09-25/RESULTS.md2.3 KB
- 参考文档evals/results/2026-09-25/triggers.json4.7 KB
- 其他evals/results/2026-09-25/triggers.log1.2 KB
- 参考文档evals/results/2026-09-26/post-wave2/aggregate-result.json121.1 KB
- 其他evals/results/2026-09-26/post-wave2/console.log2.3 KB
- 参考文档evals/results/2026-09-26/post-wave2/replies/rfc-consumer-run1.md12.8 KB
- 参考文档evals/results/2026-09-26/post-wave2/replies/rfc-decoys-run1.md8.0 KB
- 参考文档evals/results/2026-09-26/post-wave2/replies/rfc-producer-run1.md12.0 KB
- 参考文档evals/results/2026-09-26/post-wave2/replies/rfc-refusal-duration-run1.md2.0 KB
- 参考文档evals/results/2026-09-26/post-wave2/replies/rfc-refusal-httpdate-run1.md1.1 KB
- 参考文档evals/results/2026-09-26/post-wave2/replies/rfc-schema-run1.md11.9 KB
- 参考文档evals/results/2026-09-26/post-wave2/report.html136.8 KB
- 参考文档evals/results/2026-09-26/post-wave2/summary.json4.7 KB
- 参考文档evals/results/2026-09-26/post-wave2/summary.md864 B
- 参考文档evals/results/2026-09-26/triggers.json4.9 KB
- 脚本evals/run_plugin_eval.sh2.5 KB
- 脚本evals/triggers/run_trigger_eval.py7.9 KB
- 参考文档evals/triggers/trigger-eval.json1.9 KB
- 脚本probes/analyze.py16.6 KB
- 脚本probes/go/analyze.py4.7 KB
- 脚本probes/go/cmd/extra/main.go2.1 KB
- 脚本probes/go/cmd/extra2/main.go593 B
- 其他probes/go/go.mod22 B
- 脚本probes/go/main.go12.9 KB
- 参考文档probes/go/results/tables.md17.4 KB
- 脚本probes/go/strict.go1.6 KB
- 参考文档probes/go/testdata/risky_go.txt756 B
- 参考文档probes/inputs.json278.8 KB
- 其他probes/jsonschema/dotnet/JsProbe.csproj336 B
- 其他probes/jsonschema/dotnet/Program.cs3.5 KB
- 参考文档probes/jsonschema/extras.json3.8 KB
- 其他probes/jsonschema/go/go.mod130 B
- 其他probes/jsonschema/go/go.sum527 B
- 脚本probes/jsonschema/go/main.go3.4 KB
- 脚本probes/jsonschema/JsonSchemaProbe.java4.7 KB
- 其他probes/jsonschema/openapi/GenCsProgram.cs1.5 KB
- 参考文档probes/jsonschema/openapi/spec.yaml438 B
- 脚本probes/jsonschema/probe_all.py4.7 KB
- 脚本probes/jsonschema/py_adapter.py2.9 KB
- 其他probes/probe_dotnet.cs8.9 KB
- 脚本probes/probe_js.mjs8.7 KB
- 脚本probes/probe_jsonschema_nodep.py2.4 KB
- 脚本probes/probe_python.py8.4 KB
- 脚本probes/probe_ruby.rb4.7 KB
- 脚本probes/Probe.java13.9 KB
- 脚本probes/protobuf/compare_instants.py3.6 KB
- 其他probes/protobuf/go/go.mod67 B
- 其他probes/protobuf/go/go.sum342 B
- 脚本probes/protobuf/go/main.go5.7 KB
- 脚本probes/protobuf/probe_protobuf.py6.9 KB
- 参考文档probes/README.md5.4 KB
- 脚本probes/run_vector_probes.py15.8 KB
- 脚本probes/rust/bracket_probe.py1.3 KB
- 其他probes/rust/Cargo.lock14.5 KB
- 其他probes/rust/Cargo.toml50 B
- 脚本probes/rust/producer_table.py5.4 KB
- 其他probes/rust/rfc-eval/Cargo.toml360 B
- 脚本probes/rust/rfc-eval/src/bin/adapter.rs10.9 KB
- 脚本probes/rust/rfc-eval/src/bin/probe.rs18.6 KB
- 脚本probes/rust/rfc-eval/src/lib.rs1.6 KB
- 脚本probes/rust/scan-sample/sample.rs770 B
- 参考文档probes/rust/tables-full.md119.8 KB
- 脚本probes/rust/validate_producers.py1.2 KB
- 参考文档probes/servicenow/fluent-build-diff/app/now.config.json107 B
- 参考文档probes/servicenow/fluent-build-diff/app/package.json174 B
- 脚本probes/servicenow/fluent-build-diff/app/src/fluent/index.now.ts2.2 KB
- 脚本probes/servicenow/fluent-build-diff/build_diff.sh2.2 KB
- 脚本probes/servicenow/fluent-build-diff/helpers_probe.cjs2.9 KB
- 参考文档probes/servicenow/fluent-build-diff/package.json140 B
- 脚本probes/servicenow/glide_adapter.cjs3.0 KB
- 脚本probes/servicenow/glide_rfc3339.js2.3 KB
- 脚本probes/servicenow/instance_probe.js17.3 KB
- 参考文档probes/servicenow/README.md4.4 KB
- 脚本probes/sql/common.py5.2 KB
- 脚本probes/sql/probe_pg.py18.1 KB
- 脚本probes/sql/probe_sqlite.py7.9 KB
- 参考文档probes/sql/testdata/risky_sql.txt1.3 KB
- 脚本probes/swift/instant_check.py3.9 KB
- 其他probes/swift/main.swift18.2 KB
- 其他probes/swift/RFC3339Strict.swift6.0 KB
- 参考文档probes/swift/testdata/risky_swift.txt1.1 KB
- 参考文档references/check-index.md15.9 KB
- 参考文档references/ecosystem.md808 B
- 参考文档references/ecosystem/dotnet.md28.0 KB
- 参考文档references/ecosystem/go.md22.1 KB
- 参考文档references/ecosystem/java.md37.0 KB
- 参考文档references/ecosystem/javascript.md20.9 KB
- 参考文档references/ecosystem/jsonschema.md26.9 KB
- 参考文档references/ecosystem/protobuf.md16.7 KB
- 参考文档references/ecosystem/python.md28.8 KB
- 参考文档references/ecosystem/README.md32.2 KB
- 参考文档references/ecosystem/ruby.md30.4 KB
- 参考文档references/ecosystem/rust.md53.1 KB
- 参考文档references/ecosystem/servicenow.md759 B
- 参考文档references/ecosystem/sql.md26.3 KB
- 参考文档references/ecosystem/swift.md52.4 KB
- 参考文档references/hotspots.md6.9 KB
- 参考文档references/interpretation.md8.4 KB
- 参考文档references/rfc3339-checks.md70.9 KB
- 参考文档references/rfc9557-checks.md50.7 KB
- 参考文档references/servicenow.md32.3 KB
- 参考文档references/tools.md8.4 KB
- 脚本scripts/rfcdt.py127.8 KB
- 脚本scripts/run_vectors.py54.6 KB
- 脚本scripts/test_rfcdt.py100.3 KB
- 脚本scripts/test_vectors.py28.0 KB
- 其他SOURCES.lock5.4 KB
- 脚本tools/fromiso_adapter.py194 B
- 脚本tools/gen_check_index.py1.0 KB
- 脚本tools/gen_probe_inputs.py14.0 KB
- 脚本tools/gen_vectors.py58.4 KB
- 其他tools/launchd/com.local.skill-revalidate.plist.template2.4 KB
- 参考文档tools/README-maintenance.md8.2 KB
- 脚本tools/revalidate.py30.9 KB
- 参考文档vectors/vectors.json242.3 KB
03 SKILL.md 正文
RFC 3339 + RFC 9557 (IXDTF) adherence audit
RFC 3339 is the Internet profile of ISO 8601 (2026-09-24T12:00:00.5+02:00). RFC 9557 updates it (Z now
means "UTC known, local offset unknown") and adds an optional suffix: …+02:00[Europe/Paris][u-ca=hebrew].
| Role (Target) | What it is | Main sections |
|---|---|---|
| producer | Code that emits timestamps | 3339 §3, §4, §5.6 NOTE (case), §5.7; 9557 §1.2, §2 (Z vs +00:00), §3 |
| consumer | Code that parses or validates timestamps | 3339 §5.6–5.7, App. C/D; 9557 §3.2–3.4, §4.1 |
| schema | JSON Schema, OpenAPI, IDL, DB column docs | 3339 §5.6 productions (erratum 5624); 9557 profile choice |
Sources. Quote ABNF and short normative sentences with a section (IETF Trust, BCP 78): the catalogs hold the
verbatim ABNF and every erratum. Verified errata apply; Held for Document Update errata (5624 partial productions,
5783 space separator) are profile options; the Rejected erratum 9557 #8192 is a note only. Library behaviour is in
references/ecosystem/: probed versions, otherwise "unverified (from docs)". Re-probe the target's version before
you rely on a row.
Severity (rule 1)
| RFC level | Report as |
|---|---|
MUST/MUST NOT, or grammar (ABNF incl. range comments, §5.7 restrictions) |
Nonconformity |
SHOULD/SHOULD NOT |
Deviation (departing needs a stated reason) |
MAY, lower-case should/may, informative |
Advisory |
| Ambiguous RFC text, profile readings, choices the RFC leaves open | Review note (never a defect) |
- Consumer too lenient: Nonconformity if it gates input or claims RFC 3339/9557, unless documented; else Advisory.
- Producer outside the grammar: Nonconformity when claimed or consumed as RFC 3339.
- Well-formed but wrong instant or tags (local time labelled
Z, last-wins duplicate keys, years 0–99 → 19xx): Nonconformity. - False contract or docs claim: Deviation, reported once.
+00:00for an unknown local offset, orZ↔+00:00rewritten on a round trip: Advisory (9557 §2).- MAY-level or optional items about compliant code are not findings; mention them only in Review notes if useful.
Read references/interpretation.md before step 3: the full rules (1 grading, 2 Z semantics, 3 profiles,
4 RFC 9557 consumer obligations, 5 known ambiguities and leap-second policies) and how to grade vector results.
Workflow
Clone or copy audit targets outside iCloud-synced folders (~/Documents, ~/Desktop): files that are not
available locally are skipped and counted, and reading them can stall. Below, S=~/.claude/skills/rfc3339-ixdtf/scripts.
Flags and output shapes: references/tools.md.
- Scope. Roles, claimed profile (RFC 3339 only, or IXDTF), declared options (space separator, lower case,
productions, fraction precision, leap-second policy, tz database, experimental keys). A stated restriction is
fine (§5.6 NOTE) if its output stays in the grammar. Platform formats (ServiceNow
yyyy-MM-dd HH:mm:ssUTC) are profiles: judge them at boundaries (references/servicenow.md§1). Filterreferences/check-index.md(109 checks) by role. - Static scan.
python3 $S/rfcdt.py scan <paths> --json [--include-dist] [--max-bytes N](86 patterns; languages inreferences/tools.md). Output{meta, summary, findings};summaryis the denominator (files seen, scanned, skipped by reason and extension). Hits are leads: confirm each in context.# rfcdt: ignoresuppresses a line. Never call a skipped file clean. - Dynamic vectors (strongest evidence). Write an adapter that calls the target's real parser: string on
stdin, prints
{"ok": true|false},{"skip": true}, or{"ok": true, "resolved": true}, plusfieldsit exposes (year…second,offset_minutes,effective_tags, …). Examples:run_vectors.pydocstring.
310 vectors (python3 $S/run_vectors.py --target "<adapter cmd>" --target-kind rfc3339|ixdtf|both \ --target-options fixed --target-has-tzdata yes|no [--batch | --jobs N] \ [--tz-matrix UTC,America/St_Johns,Asia/Kathmandu] [--report md|json]vectors/vectors.json); each lists its check IDs, and every objective consumer/grammar check has one. Buckets: TOO LENIENT, TOO STRICT, WRONG VALUE (returnedfieldsdiffer), HOST-TZ DEPENDENT (--tz-matrix), ADAPTER ERROR; INTERPRETATION records choices the RFC allows (Review notes, not failures). Route byRFCDT_PROFILE; use--target-kind ixdtffor a suffix-only parser.--batchfor JVM/.NET/Node.--report mdprints a findings-table skeleton. - Producers. Capture real output and validate each string:
python3 $S/rfcdt.py check '<string>' [--profile ixdtf] [--leap-seconds …] [--lmt-tolerance nearest|any-sub-minute] --json. Probe with the instants inreferences/hotspots.md(read it before this step).rfcdt.py adapteris rfcdt as a vector target;rfcdt.py selfcheckconfirms the leap-second table, calendars and tz release: record it. - Code review. Read
references/hotspots.md,references/ecosystem/README.md(Top 10, matrix), then only the target language's file inreferences/ecosystem/. Also: semantic probes for consumers, schemas without a configured validator, and checks the grammar cannot see (string sorting, leap-second mapping, zone vs offset on reload). - Report in the format below.
Report format
# RFC 3339 / RFC 9557 adherence — <target>
Scope: targets <producer|consumer|schema>, profile <rfc3339|ixdtf>, declared options: <...>
Evidence: <tool runs with counts, e.g. scan 412 files (3 skipped) 9 hits; vectors per adapter 140/147 (5 too lenient, 2 too strict, 0 wrong value, 6 interpretation); producer samples 2 invalid of 30; semantic probes 5; selfcheck OK>
Summary: N nonconformities, N deviations, N advisories, N review notes
## Findings
| # | Severity | Check ID | Ref | Target | Location | Finding | Evidence | Fix |
## Review notes
(ambiguous RFC text and the reading used; INTERPRETATION choices; optional items worth knowing)
## Not run / not applicable
(tools, vectors or roles not run, and why; scan skips)
## Assumptions
(profile, options and tz data assumed where the target does not state them)
## Reproduction
(adapter source, commands, library and tzdata versions, rfcdt/runner versions, selfcheck result)
Ref = the RFC section (§5.6, 9557 §3.3); Target = producer, consumer or schema; Location = file:line;
Evidence = a concrete input → output pair. Report one root cause once and list the other check IDs it breaks in
the same row. Never report a clean result for vectors or checks you did not run.
Files
| Path | Contents |
|---|---|
references/interpretation.md |
Rules 1–5 in full, severity vocabulary, grading vector results |
references/hotspots.md |
Producer and semantic probes, schema checks, code hotspots by role, semantic checks |
references/tools.md |
rfcdt.py (check, adapter, scan, selfcheck) and run_vectors.py: flags, JSON shapes, buckets |
references/check-index.md |
All 109 checks: ID, level, roles, judgment. Filter this first |
references/rfc3339-checks.md |
RFC 3339: verbatim ABNF, errata, checks for §1–§7 and App. A–D |
references/rfc9557-checks.md |
RFC 9557: consumer decision table, ABNF, checks, examples, erratum, IANA registry |
references/ecosystem/ |
Probed behaviour per language (Python, JS, Java, .NET, Ruby, Go, Rust, Swift, SQL, protobuf, JSON Schema); README.md has the legend, matrix, strict regex, Top 10 |
references/servicenow.md |
ServiceNow profile, Glide/REST/Flow/Fluent APIs, Fluent SDK 4.13.0 findings, audit steps |
scripts/rfcdt.py, scripts/run_vectors.py |
Reference validator and scanner; conformance runner |
vectors/vectors.json |
310 vectors with check IDs, options, requires, fields, interpretation |
probes/ |
Probe programs behind ecosystem/ (inputs.json; servicenow/ has its own README) |
evals/ |
Skill eval harness (plugin-eval cases, trigger prompts, fixtures); see evals/README.md |
04 同仓库更多 Skills
wcag22-a11y
暂无简介
wcag22-a11y
Audit web content for WCAG 2.2 conformance (also WCAG 2.1/2.0 Level A/AA) with tool-assisted and manual checks. USE FOR: accessibility (a11y) audits and reviews of web pages, sites, HTML, components (React/JSX/TSX, Vue, Svelte, server templates) and CSS; colour contrast; keyboard access, focus order, focus visible, focus not obscured; target size; screen reader issues in markup (names, roles and states, ARIA); forms, labels and error messages; reflow, zoom and text spacing; accessible authentication, consistent help, redundant entry, dragging; status messages; VPAT/ACR evidence and Section 508 / EN 301 549 mapping at the WCAG level. DO NOT USE FOR: native mobile app platform guidelines beyond WCAG applicability, legal advice, PDF remediation (unless the content is HTML), SEO, performance or security audits, ISO 999 indexes, RFC 3339 timestamps, ASD-STE100 writing.
ste100
Write, rewrite, audit, or answer questions about ASD-STE100 Simplified Technical English (STE, STE100), the controlled language for technical documentation. USE FOR: drafting or rewriting READMEs, guides, manuals, runbooks, install docs, procedures, and help text in STE; technical writing review and STE conformance audits with rule IDs and severities; word questions such as 'Is utilize allowed in ASD-STE100?' or 'is this an approved word?'; approved words, part of speech, technical nouns and technical verbs, a DOCS_TERMS.md term list; sentence length (20/25 words), active voice, imperative steps, WARNING/CAUTION/NOTE safety instructions, punctuation. DO NOT USE FOR: code, code comments, commit messages, chat replies, marketing copy, non-English text, ISO 999 indexes, RFC 3339 timestamps.
rfc3339-ixdtf
暂无简介
iso999
Audit indexes and index-producing software for adherence to ISO 999:1996 (content, organization and presentation of indexes). USE FOR: reviewing a back-of-book index or book index; code that generates indexes (collation/filing, locators and page ranges, see/see also resolution, subheading nesting; makeindex/xindy styles, Sphinx genindex, Docusaurus/MkDocs index plugins, custom indexers); linting a generated index (text, Markdown, LaTeX .ind, HTML); reviewing index entries and markup in doc sources (\index{}, .. index::, DITA indexterm). DO NOT USE FOR: general source-code quality, search-engine/database indexes, keyword extraction, tables of contents, or choosing what subjects to index (ISO 5963).
foxit-pr-check
Review a branch or pull request prepared for a Fox-IT open-source repository (fox-it/dissect.*, dissect.target, dissect.cstruct, flow.record, acquire, ...) against Fox-IT's contribution rules before it is pushed or opened: the Developing, Style guide and Tooling pages (docs.dissect.tools/en/latest/contributing/), the repository's own tox.ini, pyproject.toml (Ruff) and pull request template. USE FOR: commit message format (50-character imperative subject, 72-column body), fix/ and feature/ branches, one change per branch, the PR description and its closing keyword, running the repo's tox lint and tests, missing unit tests, type hints, names, cstruct definitions, dependency reasons, and whether the CLA (DissectBot) is accepted. DO NOT USE FOR: reviewing what the code does (correctness, design); repositories outside fox-it; accepting the CLA (only the author may).