Jjk Api Doc Sync

执行流程（强制顺序）

0) 上下文检查

至少检查：

1. 是否命中 app/api/**、app/schemas/**、前端 API 调用层；
2. 变更属于新增接口、字段变更、语义变更、错误码变化还是鉴权变化；
3. 是否要求发布正式产品/设计文档。

1) 建立同步清单

至少输出三栏：

1. Must Update
2. Should Review
3. Not In Scope

基础映射规则：

1. 命中 API 变化时，docs/API文档/接口文档.md 必须进入 Must Update；
2. 命中测试行为变化时，测试资产进入 Must Update 或 Should Review；
3. 仅当 publish_product_doc=true 时，正式产品/需求文档进入 Must Update；
4. 仅当 publish_design_doc=true 时，正式设计/架构文档进入 Must Update。

2) 输出同步判定

必须输出：

1. 受影响接口 / 文件范围；
2. Must Update / Should Review / Not In Scope 清单；
3. api_doc_required=true|false；
4. publish_product_doc / publish_design_doc 状态；
5. sync_status=READY|BLOCKED|NOT_APPLICABLE。

禁止项（强制）

1. 禁止把 API 文档自动同步降级为“后续再补”；
2. 禁止因为没带 --doc 就跳过 API 文档；
3. 禁止把正式产品/设计文档默认列为必改；
4. 禁止无映射依据地凭印象列文档清单。

推荐链路

$jjk-design -> $jjk-api-doc-sync -> $jjk-plan

$jjk-imp -> $jjk-api-doc-sync -> $jjk-verify

使用示例

$jjk-api-doc-sync

使用 $jjk-api-doc-sync 触发。目标是“API 文档自动同步、正式文档按发布标志扩展”，不是“一刀切全改”。