用途:这是 RepoSkillOpt 的仓库专用分析层,把仓库中立的 Repository Specification 深化为基于证据的现状架构视图,并回答“改动会波及什么”,产出架构视图与变更影响(blast-radius)分析,供后续 plan to-be 技能(repo-orchestration)消费。技能内容本身与厂商无关,输出则针对具体仓库。
触发条件:用户要求梳理架构、评估依赖/耦合/分层,或评估“如果改 X 会怎样 / 改 X 是否安全”等类似请求时激活;无关请求不激活。
前置条件:需要 Repository Specification(.reposkillopt/specs/repository-specification.md)。若缺失,应说明前置条件并指向仓库理解技能,不得凭浅层检查编造架构。
主要能力与工作流:读取规格说明及其引用的入口、清单和核心模块;产出架构视图(.reposkillopt/architecture/architecture-view.md,按模板),采用 C4 风格层级——Context(系统与外部参与者)、Containers(运行时/可部署单元)、Components(容器内模块),外加关键序列(端到端流程,每跳引用)和依赖图(内部边引用),每个组件与边都引用真实 file:line;产出变更影响分析(.reposkillopt/impact/change-impact-analysis.md,按模板),针对指定目标/改动列出受影响模块、测试、契约和调用点,每行带置信度标签(high|medium|low)与引用,用 rg/grep 快速扫描定位,只读所引用的匹配行。
输出纪律:每条主要论断只带一个标签——[fact](须有可解析的 file:line/符号引用)、[inference](说明依据)、[unknown](同时列出)、[human](引用 Feedback Item id);引用格式为 path:line、path:start-end、path:Symbol[:line] 或 cmd:/output:。不得静默省略,无法解析的结构或影响标为 [unknown] 并说明原因,不得过度断言。
完成门槛:结束前产物须通过确定性检查(check_architecture_view、check_impact_analysis):每个组件/边可引用且可解析,每条影响行带引用与置信度标签。
反馈与收敛:人工纠正记录为 Feedback Items(templates/human-feedback.md)存于 .reposkillopt/feedback/ 并就地应用到产物,仓库特定纠正保持仓库范围。当 ≥3 条相关且标记 candidate-for-generic 的反馈暴露技能弱点时,起草 Skill Edit Proposal(templates/skill-edit-proposal.md),须通过验证门槛(rubric/validation-gate.md)方可接受,接受后升版本并加 CHANGELOG,且同步到四个适配器。
限制:依赖前置规格说明;动态或无法解析的影响只能标为 low 与 [unknown];图表仅作视觉辅助、不携带引用。