AI Delivery Spec 5.5.1

已有 ZIP 安装包？解压到宿主识别的 ai-delivery-spec 技能目录，让 SKILL.md 位于目录根部，再按宿主要求重新加载技能。
Have a ZIP package? Extract it into your host's ai-delivery-spec skill directory, with SKILL.md at its root, then reload skills as required by the host.

宿主提供技能导入界面时，也可按其说明导入目录或 ZIP。仓库与社区各自更新版本，安装后请核对包内版本。
If your host provides a skill-import interface, follow its instructions to import the directory or ZIP. Repository and community channels update separately; check the installed package's version.

• 只有一句话，或只改一个字段，也能用吗？ 能。明确小改直接交付差异与验收；模糊想法先找关键决定，不要求全套 PRD、等级或流程。 / Can I start with an idea or one field? Yes. Clear edits need a bounded change and acceptance; vague ideas need the relevant decision first.
• 已有 PRD 或 HTML，要重做吗？ 读取相关基线，从当前阶段继续；继承有效决定并保护未取消的功能。 / Must I rewrite existing work? No. Continue from the relevant baseline, preserving valid decisions and existing scope.
• 原型和评审态是否必交？ 按目标提供；需要原型时默认可操作产品态，双态评审按需启用。 / Are prototypes and review mode mandatory? They follow the task. Requested prototypes are interactive; dual-mode review is optional.
• 检查 PASS 就能上线，领域资料能直接当政策吗？ 都不能。PASS 只覆盖已运行的检查；规则适用性、真实系统和验收各需证据。编码与上线交给相应工作流。 / Does PASS authorize launch or adopting a domain policy? No. Applicability, implementation and acceptance need their own evidence; coding and deployment use their respective workflows.

在技能目录内运行，使用 Python 3.10+。这些是交付检查工具；日常澄清与小改可直接在对话中完成。
Run from the skill directory with Python 3.10+. Use these tools at relevant delivery checkpoints; everyday clarification and small edits can stay in the conversation.

python -m pip install -r scripts/requirements.txt
python scripts/ai_delivery_spec_cli.py version
python scripts/ai_delivery_spec_cli.py check
python scripts/ai_delivery_spec_cli.py triage --input examples/minimal-v5/intake.yaml --format json
python scripts/ai_delivery_spec_cli.py gate --profile prd --prd examples/minimal-v5/requirement-card.md --stage specify

按任务需要使用以下命令；analysis.md、app.html、old-app.html 换为你的文件：
Use these as needed; replace analysis.md, app.html and old-app.html with your files:

python scripts/ai_delivery_spec_cli.py gate --profile prd --prd analysis.md --stage explore
python scripts/ai_delivery_spec_cli.py query-domain --search confidence --limit 8
python scripts/ai_delivery_spec_cli.py query-domain --search 完成率 --limit 8
python scripts/ai_delivery_spec_cli.py query-domain --domain ai-native --section "Metric / Indicator Governance"
python scripts/ai_delivery_spec_cli.py query-domain --domain medical-hospital-it --section "Policy / Privacy Constraints" --source-detail full --language en-US
python scripts/ai_delivery_spec_cli.py gate --profile prototype --prototype app.html --prototype-baseline old-app.html

• 阶段 / Stage：分析建议用 explore 检查；不传 --stage 仍默认 baseline。建议暂缓不会自动降低检查阶段或改变需求状态。 / Use explore for analysis. Omitting --stage retains the baseline default; a deferral recommendation does not change the stage or lifecycle.
• 风险 / Risk：triage 读取声明和部分正文线索，只给建议；未声明 ai_write_scope 表示未知，正文自动写回风险仍会独立提示。 / Triage returns advice using declarations and bounded text cues. Missing ai_write_scope means unknown; write-back cues are checked separately.
• 变更 / Impact：impact 接受顶层 seed_refs: [REQ-A] 或 request.seed_refs，同时给出时必须一致。图上的相关对象先作为候选核实。 / Impact accepts either seed location; both must agree if supplied. Related graph objects remain candidates until their dependencies are verified.
• 领域 / Domains：也可用 --section 指标。搜索命中是候选线索，不能直接变成项目已批准规则。 / Chinese section aliases are supported. Search hits are leads, not approved project rules.

搜索结果给出扩展词、原文位置及 literal/alias 命中方式；它是有界关键词检索，未命中也可能只是术语表未覆盖。--source-detail full 可查看来源 URL、法域及适用范围，原文章节不会由脚本自动翻译。
Results show expanded terms, source locations and literal/alias matches. This is bounded keyword retrieval; zero hits may mean a vocabulary gap. --source-detail full exposes source URLs, jurisdictions and applicability. The script preserves source passages without automatically translating them.

常用中文词可检索已有台账、报销和里程知识；“活跃”按客户/企业/用户相关短语召回，不等同于所有 active 状态。账本也保留 JS 动态声明候选及来源；候选进入盘点不代表已经渲染，门禁保留相应 GAP。UNK 表头未被识别时提示定位问题；显式无效状态、无依据关闭与真实冲突仍分别检查。
Chinese ledger, reimbursement and mileage queries retrieve existing domain passages. Activity terms target relevant customer, enterprise or user phrases. Interaction ledgers retain JS declaration candidates with their origins; unresolved rendering remains a GAP. Unlocated unknown-status columns are distinguished from explicitly invalid statuses, unsupported closure and conflicting declarations.

5.4.x 产物可继续读取，稳定 ID 和已批准事实保留。artifact_mode 使用 direct/card/prd；旧 L0–L4 在 PRD 中只作呈现提示，不能覆盖显式模式或自动提高风险、证据要求。专业原型、评审、Truth、handoff 与执行状态工具保留其版本化 Schema，不自动迁移旧产物，也不成为日常任务的默认依赖。

5.4.x artifacts remain readable with stable IDs and approved facts preserved. artifact_mode uses direct/card/prd; legacy tiers are presentation hints in PRDs. Specialized prototype, review, Truth, handoff and execution-state tools retain their versioned schemas and remain optional. Old artifacts are not automatically migrated.

旧未知项状态 partial、in_progress 及“部分关闭/部分解决”按 open 理解：只要仍有未决部分，就按其依赖范围与阻断阶段处理。同一未知项的相同诊断合并，冲突声明仍保留。其他未识别状态必须明确迁移，不能被当作关闭。
Legacy partial, in_progress and equivalent Chinese partial-resolution labels are treated as open. Remaining decisions retain their scope and blocking stage. Repeated identical findings are merged; conflicting declarations remain visible. Other unknown status values require explicit migration and never count as closed.

接入脚本需注意：5.5 triage 使用 recommendation / artifact_mode / risk_facets / governed，移除旧 tier/mode 推导结果键；旧 Markdown PRD 入口复用新内核，退出码可能改变；旧 validate_prd_quality.py --domain-rules 已退役，领域约束通过显式 custom gate 或领域工具处理。

Script consumers: update to the triage keys above. Old derived tier/mode output keys are removed; legacy Markdown PRD entry points share the new engine, so exit codes may differ. The old --domain-rules keyword check is retired; use explicit custom gates or domain tools. See the changelog for version history.

正文检查对状态权威、指标口径、恢复路径、空值/陈旧、权限边界与变更传播做有界抽查，返回带位置的待核实 GAP。填写评阅 pass 不能覆盖正文疑点。PASS 只表示实际执行的确定性检查未发现对应阻断或缺口；业务语义、来源授权、浏览器交互、真实实现和客户验收仍需各自的证据。

Text checks sample known ambiguity patterns in state authority, metrics, recovery, null/stale values, permissions and change propagation. Findings are located GAPs for review; a declared review pass cannot suppress them. A deterministic PASS covers only the checks executed. Business meaning, source authority, browser behavior, implementation and customer acceptance require their own evidence.

对“补考成绩取最新”等取值政策，依据未显式出现时只给 WARN 提示；附近同时存在未决声明才给 GAP。提示不能鉴定授权真伪，也不要求为每个界面默认值补决策表。
For selected policies such as using the latest retake score, an absent explicit basis produces a WARN advisory; a nearby unresolved decision produces a GAP. This does not authenticate authority or require decision tables for ordinary UI defaults.

本 Skill 管需求与其产物，连接工程反馈；排期、编码、部署与运营由相应工作流负责。公共反馈与示例请使用脱敏材料。
The skill manages requirements and their artifacts, incorporating engineering feedback. Scheduling, coding, deployment and operations belong to the relevant workflows. Use sanitized material in public examples and feedback.

维护者可在完整源码仓库运行以下命令；构建发布包要求干净 Git 来源。运行包不包含 maintainer/，其中 check 只检查实际携带的文件与契约。
Maintainers can run these commands in the full source repository. Release packaging requires a clean Git source. Runtime packages exclude maintainer/; their check covers the files and contracts actually shipped.

python -m pip install "pytest>=8,<9"
python scripts/ai_delivery_spec_cli.py check --profile release
python maintainer/tools/build_runtime_package.py --release --check --output dist/ai-delivery-spec-5.5.1.zip