菜单
Run canonical session-start gates (HEAD pin, working tree clean, settings.local.json baseRef, bd lint parse) with machine-parseable output for linter consumption.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Close a bd issue with structured rationale, evidence-path verification, worktree-owner lifecycle enforcement, and post-close verification. Idempotent.
Assemble a bdClosureAttestation JSON object (bd-close evidence shape — issueId/head/timestamp/evidenceBundle/evidencePaths/rationaleHash). This is DISTINCT from the canonical ADR-016 §6 closureAttestation (post-sign-off-correction) shape; see amnesia-pdqi.
Resolve P1 references per-class (Cerberus-aggregate; no halt-on-first) — invoke tools/validate-refs.sh to validate file_path / commit_sha / bd_id / adr_anchor / memory_binding citations against their named targets via the 5 per-class adapters at tools/role_schema/adapters/refs/. Returns full inventory of {resolved, violations, warnings}; exit 1 on any block-severity (STALE/NOT_FOUND/AMBIGUOUS for non-warn classes), exit 0 on all RESOLVED OR only warn-severity (bd_id STALE; memory ACTIVE_PENDING_CODIFICATION) per ADR-017 §2.4 + AC
Assemble a canonical role identity (P3 adapter per ADR-017 §2.1 Layer 3) for a dispatch — resolve a role name against the canonical roster (Directive
Manage halt-condition state across a dispatch lifecycle (ARMED → CHECKED → FIRED → ATTESTED) per ADR-017 §2.4 — arm halts pre-flight via tools/halt-arm.sh (Task 3.2), query/fire mid-dispatch via tools/halt-check.sh (Task 3.3 TBD).
Validate a dispatch contract YAML against ADR-017 §2.2 canonical packet shape + P4 structural + P3 role-canonical + P1 reference resolution; emit conformance diagnostic for pre-launch gating.
| name | preflight-verify |
| description | Run canonical session-start gates (HEAD pin, working tree clean, settings.local.json baseRef, bd lint parse) with machine-parseable output for linter consumption. |
At session start before opening any non-trivial work; before issuing any agent dispatch; before any commit-on-main. The four checks together establish the baseline environmental contract that downstream tools assume.
Invokes tools/preflight-verify.sh to run four canonical gates (HEAD pin, working tree porcelain, .claude/settings.local.json worktree.baseRef presence, bd lint --json parse) and returns a single aggregated JSON object describing each check's pass/fail state. The output shape is documented in the script header as the o4fp.2 GSOM linter extensibility contract.
tools/preflight-verify.sh--check <head|tree|settings|bd-lint|all> (default all)--expected-head <sha> (optional; pin HEAD to a known SHA)--json (machine-readable output){
"checks": [
{"name": "head", "pass": true, "actual": "<sha>", "expected": "<sha-or-empty>"},
{"name": "tree", "pass": true, "actual": "", "expected": ""},
{"name": "settings", "pass": true, "actual": "<baseRef>", "expected": "<non-MISSING>"},
{"name": "bd-lint", "pass": true, "actual": "total=<n>", "expected": "parses"}
],
"all_pass": true
}
all_pass is true; 1 if any check fails.tools/preflight-verify.sh --check all --json
tools/preflight-verify.sh --check head --expected-head 62aaf6842da1b0fd614dd0b9303f93ee0f2da022 --json
head check fails (HEAD missing or mismatched against --expected-head) — blocking; halt + surface the actual SHA.tree check fails (working tree dirty) — blocking; halt + surface the porcelain output.settings check fails (file missing, JSON unparseable, or worktree.baseRef MISSING) — warning-class; surface but do not block routine engineering work.bd-lint check fails (cannot parse bd lint --json) — warning-class; surface and continue.amnesia-o4fp.2 GSOM linter: downstream consumer of the schema; this primitive's output is one input source.tools/divergence-report.sh (HEAD vs remote drift), tools/bundle-extract.sh (post-dispatch artifact extraction).