用途
MCDA Sales Comparison（多准则决策分析销售比较法）用于对商业物业进行可辩护、可审计的价值评估。与传统 DCA（顺序美元调整法）不同，本方法采用序数排名，在可比集合异质时表现更稳定。其输出为可直接用于演示的 markdown 报告，包含完整排名表、得分到价格映射和明确的估值结论。
主要能力
- 对可比销售条目按多个特征进行 MCDA 序数排名（得分越低越好）。
- 通过“得分到价格映射”推导价值，包含两种方法：插值法（Interpolation）与回归法（Regression），再进行加权调和（Reconciliation），得到单一指示值。
- 输出每平方英尺指示价值与总价值、价值区间（±5%）、R²、回归方法等统计信息。
- 支持的权重配置：industrial_default、industrial_logistics、industrial_manufacturing、office_default、retail_default；若未指定则使用 auto，由计算器依据 JSON 中的 property_type 自动检测。
- 生成完整的 markdown 报告，并复制结果 JSON 以便复现。
使用方式
通过消息触发，例如：
- “Run MCDA sales comparison on inputs/hamilton_industrial.json”
- “Value 2550 Industrial Parkway using MCDA comps”
- “/mcda-sales-comparison inputs/data.json --profile industrial_logistics”
参数解析：输入 JSON 文件路径（必需）；可选的 --profile <weight-profile> 权重配置标志；可选的 --output <report-path> 输出标志。若未提供路径，则在工作区的 inputs/ 目录中扫描 JSON 文件并询问。
执行流程包含若干步骤：
- 第 0 步：在主上下文中解析路径，包括插件根目录、工作区路径、时间戳，并构建脚本目录、计算器路径，验证计算器存在，解析输入 JSON 绝对路径。时间戳通过
TZ=America/Toronto date +%Y-%m-%d_%H%M%S获取。若计算器缺失则报告错误并停止。 - 第 1 步：派发分析子代理（若 Agent 工具不可用，则直接在当前上下文执行步骤 A 到 E）。
- 步骤 A：校验输入。读取输入 JSON，确认包含 subject_property（含 address 和 building_sf）、comparable_sales 数组（至少 3 条）、以及 valuation_date（在根或 market_parameters 中）。校验失败则停止并报告缺失字段。
- 步骤 B：运行 MCDA 计算器。需先 cd 到脚本目录（计算器使用相对 CWD 的兄弟模块导入），命令形如：
cd "{{ SCRIPTS_DIR }}" && python3 mcda_sales_calculator.py "{{ INPUT_JSON_PATH }}" --output /tmp/mcda_results.json --verbose
若指定了权重配置，则附加 --profile {{ PROFILE }}。捕获输出，命令非零退出则报告错误并停止。
- 步骤 C：校验结果 JSON。检查 indicated_value_psf 存在、非空且为正；indicated_value_total 存在、非空且为正；comparable_analysis 至少 3 条；subject_property.composite_score 存在且为数值；analysis_summary.comparables_used 等于 comparable_analysis 长度；value_indication.regression.r_squared 存在且介于 0 与 1。任一检查失败则报告并记录错误，仍继续生成报告并加警告段。
- 步骤 D：生成 markdown 报告，写入 Reports/ 目录，文件名含时间戳，使用给定模板填充真实值，并将结果 JSON 复制到 Reports/ 以便复现。
- 步骤 E：验证输出文件存在且大小大于 0。
子代理最终返回一个 ANALYSIS_RESULT 块，包含主体地址、指示价值（每 SF 与总计）、价值区间、可比数量、R²、回归方法、报告与 JSON 路径、错误信息。主上下文解析后向用户汇报。
适用场景
- 商业物业估值（工业、物流、制造、办公、零售等类型，取决于权重配置）。
- 需要对多个可比销售进行稳健排序而非美元调整的场景。
- 需要可审计、可复现的估值报告输出的场景。
限制
- 序数排名反映相对位置，而非差异幅度。
- 需要至少 3 个可比条目才能进行有意义的分析。
- 得分到价格映射假设单调性（得分越好价格越高）。
- 超出可比范围的外推会带来较低置信度。
其他说明
该技能以 Claude Code 插件形式运行，涉及 Bash、Read、Write、Agent 等工具调用。具体安装命令与官方安装方式暂未提供。