القائمة
用于旧系统、微服务、平台型仓库的代码知识梳理与中央知识库沉淀。统一支持跨服务 create_codemap、跨服务业务域梳理、crate_router_map、单服务纵切梳理、事实需求抽取。强调严格按代码事实输出，并显式区分 scope、参数清晰度、链路类型、需求证据等级与证据闭环状态。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | backend-service-spec-skill |
| description | 用于旧系统、微服务、平台型仓库的代码知识梳理与中央知识库沉淀。统一支持跨服务 create_codemap、跨服务业务域梳理、crate_router_map、单服务纵切梳理、事实需求抽取。强调严格按代码事实输出，并显式区分 scope、参数清晰度、链路类型、需求证据等级与证据闭环状态。 |
用于把单服务、跨服务、业务域、通信链路、事实需求五类梳理动作统一成一套可复用知识技能。
当用户出现以下目标时，使用本技能：
如果只是实现功能、修 Bug、写测试，而不是做知识梳理，不优先使用本技能。
始终遵守以下约束：
在运行核心功能前，先用最小成本判断当前 scope 属于哪一种：
single-system: 单一系统 / 单一运行时家族service-family: 同一家族、多服务协作multi-system-workspace: 多套系统共存的工作区最少要回答三个问题：
mydocs/ 的哪一层如果识别为 multi-system-workspace：
create_codemap: mode=service_landscapebuild_domain_map详见：references/workspace-classification.md
create_codemap用途：
create_codemap 思想，但升级为“服务间视角”适用输入：
create_codemap: mode=service_landscape, scope=<系统名或服务群>, goal=<梳理目标>
也兼容：
create_codemap: mode=project, scope=<项目名>, goal=<输出项目总图与核心流程>
create_codemap: mode=feature, scope=<关键功能或链路>, goal=<梳理核心入口与主链路>
create_codemap: mode=service_chain, scope=<跨服务业务链>, goal=<梳理服务级链路>
输出重点：
默认产物：
mydocs/codemap/YYYY-MM-DD_hh-mm_<name>服务总图.mdmydocs/codemap/YYYY-MM-DD_hh-mm_<name>链路地图.md详情模板见 references/codemap-modes.md
用途：
适用输入：
build_domain_map: scope=<系统或服务群>, goal=<按业务域梳理>
输出规则：
code-fact-summary 与 team-proposed-standardservice_deep_dive，再做业务域梳理详情模板见 references/domain-layering.md
crate_router_map用途：
说明：
crate_router_mapcreate_router_map适用输入：
crate_router_map: scope=<业务链路或入口>, goal=<梳理跨服务通信链路>
输出必须拆开：
证据等级至少区分：
fact-closedfact-send-sidefact-receive-sidecontract-visibleclue详情模板见 references/router-map.md
用途：
适用输入：
service_deep_dive: scope=<服务名>, goal=<梳理高价值服务>
推荐输出：
overview.mdentrypoints.mddependencies.mdmq.mdsources.md大服务第二轮按需补：
api.mdcall-chain.mdexternal-dependencies.mdroute-map.mdtopic-detail.mdws.mdruntime-config.mdrisk-and-hotspots.md其中 api.md 必须显式标注参数清晰度分层：
详情模板见 references/service-deep-dive.md
requirement_fact_map用途：
适用输入：
requirement_fact_map: scope=<系统、服务群、功能模块或关键链路>, goal=<按功能模块抽取当前事实需求>
输出重点：
默认产物：
mydocs/requirements/index.mdmydocs/requirements/modules/<module>.mdmydocs/requirements/evidence/requirement-evidence-matrix.mdmydocs/requirements/gaps/requirement-gaps.md详情模板见 references/requirement-fact-extraction.md
classify_workspace -> create_codemap(service_landscape) -> 按 family 拆 scope -> 选关键服务做 service_deep_dive -> 对关键链路做 crate_router_map -> 最后再评估 build_domain_map
先做 create_codemap -> 再做关键链路 crate_router_map -> 再做关键服务 service_deep_dive -> 按需做 requirement_fact_map -> 服务事实和事实需求稳定后再做 build_domain_map
先做 service_deep_dive -> 若发现明显上下游协作，再补 crate_router_map / build_domain_map
输出任何文档时，优先区分：
禁止：
clue、fact-data-only、fact-entry-only 直接写成已确认需求mydocs/
codemap/
services/
domains/
requirements/
routermap/
diagrams/
context/
specs/
validation/
index/
使用建议：
mydocs/codemap/：地图索引层mydocs/services/：单服务纵切知识页mydocs/domains/：业务域上卷页mydocs/requirements/：按功能模块沉淀当前系统事实需求、证据矩阵和需求缺口mydocs/routermap/：跨服务通信链路层mydocs/diagrams/：图产物层，统一放 Markdown 内嵌 Mermaid 的架构图、调用关系图、依赖图、时序图mydocs/context/：上下文资料与补充材料mydocs/specs/：Research / Plan / Review 等过程文档mydocs/validation/：闭环验证、未闭环清单、质量检查页mydocs/index/：总索引、导航页与汇总入口references/workspace-classification.mdreferences/codemap-modes.mdreferences/router-map.mdreferences/domain-layering.mdreferences/service-deep-dive.mdreferences/requirement-fact-extraction.mdreferences/central-repo-conventions.mdreferences/quality-checklist.mdreferences/usage-guide.mdreferences/output-templates.mdreferences/diagram-output-guidelines.mdreferences/mermaid-safety-checklist.zh-CN.mdMarkdown + Mermaid，图片只作为派生结果，不替代源文件mydocs/diagrams/mydocs/diagrams/，正文里仍需保留简短说明和直接链接，保证上下文可读method(arg) 这类方法签名直接塞进节点references/mermaid-safety-checklist.zh-CN.md 做最后一轮自检为弥补长期中央仓库维护能力，本技能新增三份规则型参考页：
references/knowledge-lifecycle.mdreferences/incremental-update-policy.mdreferences/workflow-state-model.md使用时建议：
workspace-classification.md 判断范围knowledge-lifecycle.md 判断优先读取 current 还是 draftincremental-update-policy.md 决定增量补齐还是重建workflow-state-model.md 判断当前处于哪种执行状态