tywinlu1988/Credence-China / dev/.claude/skills/credit-report-builder
credit-report-builder
VerifiedUse when turning a completed Chinese fixed-income credit analysis into a deliverable report — selecting the correct report template (Type 1–19, 6/9/12 archived), mapping findings to the L0/L1/L2 output tiers, rendering a multi-stakeholder dashboard, or assembling a layered credit report from an analysis artifact. Triggers on '生成报告', '出一份授信审批报告', '做成仪表盘', 'L0信号卡', or when a work-path sheet's templates must be produced. Requires an upstream analysis artifact; does not perform analysis itself.
Purpose
对应引擎版本: v0.12.3-release
装配层,本 skill 不做分析(does not perform analysis)。职责仅两步:把上游 fixed-income-credit-analysis 产出的《分析产物》映射到 L0/L1/L2 输出层并选中正确模板 → 装配为交付报告并产出《交付单》。本 skill 不复制任何引擎阈值/分层时间预算/评级映射;模板选择与分层语义一律以引擎文档为单一事实源。
Inputs(消费)
- 《工作路径单》(Path Sheet):router 产出,提供
path_id/depth/quality_gates。path_id是贯穿四段链的 join key,本 skill 原样继承、不得更改。 - 《分析产物》(Analysis Artifact):fixed-income 产出,提供 findings / completeness / veto / system_readouts / mode_b_gaps(字段形状见
dev/engine/pipeline-contract.md§2.2)。
Outputs(产出)
- 交付报告:渲染自
dev/templates/(模板单一事实源,本 skill 不自带模板副本)。用哪个模板由该路径在dev/engine/work-path-registry.md的templates字段决定,不擅自更换。 - 《交付单》(Delivery Note):结构化 yaml,字段形状见
dev/engine/pipeline-contract.md§2.3。
Assembly Protocol(装配协议)
- 读 join key:从路径单与分析产物取
path_id,校验它指向注册表中的已注册路径;不一致即停止并上报。 - 选模板:按
path_id在 registry 的templates字段取模板清单(Type 1–19,Type 6/9/12 已归档;或允许的标记值planned/L0-spec:)。标记值含义以 registry §schema 为准;命中planned须如实告知"模板待开发",不得伪造渲染产物。 - 映射分层:把分析产物映射到 L0 信号卡 / L1 快照 / L2 深度报告三层。三层的定义、消费时间与信息密度以
dev/engine/output-layered-framework.md§二(三层总览)/§三(L0 信号卡)/§五(L2 深度报告)为单一事实源,本 skill 不重新定义。 - 渲染:用
dev/templates/的模板装配报告;完备性灯号口径见 output-layered-framework §8.4。 - 写文件:将装配完成的每份报告写入磁盘为独立
.html文件(每个 registrytemplates字段指定的模板产出一份)。文件命名规则:{发行人简称}-{路径简称}-{日期}.html(示例:隆基绿能-审贷评级-20260729.html、某城投-盯市信号卡-20260729.html)。若同一路径产出多份报告,第二份起加报告类型标识,如{发行人简称}-{路径简称}-{报告类型}-{日期}.html。报告为完全自包含 HTML(CSS 已内联于模板<style>块首段),可直接在浏览器打开或转发。写入位置:当前工作目录或用户指定目录,文件名写入rendered列表。 - 索引页:若
rendered报告文件数 >2,额外生成report-index.html放入同目录。索引页为自包含 HTML(内联 base.css),深色主题,简洁居中布局,包含:- 页头标题:
{发行人简称} · 信用分析报告集+ 生成日期 - 每条报告一行:文件名(相对链接) + 报告类型中文名 + 一句话简介(从交付单
tier_mapping取对应层描述) - 页脚:同模板 footer(报告编号占位 + 生成日期 + "不构成投资建议")
索引页本身写入
rendered列表末尾。
- 页头标题:
- 产交付单:按下述 schema 输出《交付单》。
装配纪律
- 逐节溯源:每个 section 的内容必须可溯源至上游分析产物;任何数据点不得凭模板示例或印象生成。
- 示例区整节替换:模板中的示例/演示内容(含数值、公司名、结论)必须整节替换,禁止部分保留。
- 交付前残留自查:搜索
{残留占位符与已知实例名(tests/test_template_contract.py的 INSTANCE_NAMES),任一命中即回炉。 - 文件交付即交付:仅有文字摘要、无
.html文件落盘 = 未完成交付(协议违规)。rendered列出的每个文件必须对应磁盘上可打开的独立 HTML 文件。若rendered> 2 且缺report-index.html—pass-with-findings。
Delivery Note Output(《交付单》)
模板(schema 单一事实源为 dev/engine/pipeline-contract.md §2.3):
path_id: "" # join key(承自路径单,不得更改)
depth: "" # L0|L1|L2|专项(承自路径单)
templates_used: [] # 该路径 registry templates 字段选中的模板
rendered: [] # 实际写入磁盘的报告文件名(完全自包含 HTML,CSS 已内联)
tier_mapping: # 分析产物 → L0/L1/L2 层
L0: ""
L1: ""
L2: ""
completeness_lamp: "" # 完备性灯号
source_analysis: "" # 上游分析产物引用(溯源)
示例(审贷单标的 L2 深度报告,路径 WP-M0-01 配 Type 1,含马赛克完备性附录):
path_id: WP-M0-01
depth: L2
templates_used:
- dev/templates/template-type1.html
rendered:
- 隆基绿能-审贷评级-20260729.html
tier_mapping:
L0: 信号卡(评级+展望+今日关键信号+完备性灯号)
L1: 快照(四维雷达+关键异常+评级对比)
L2: 深度报告(金字塔逐层+双轨对撞+马赛克完备性附录)
completeness_lamp: 黄色(中置信度,口径见 output-layered-framework §8.4)
source_analysis: 上游分析产物(findings/completeness/veto,见 pipeline-contract §2.2)
Chaining(链式交接)
- 上游:
fixed-income-credit-analysisskill —— 消费其《分析产物》。无分析产物时本 skill 不启动(自身不做分析,先回上游完成分析)。 - REQUIRED NEXT SUB-SKILL:
credit-qa-verifier—— 《交付单》产出后自动移交质检 skill 做交付前终态复核(质量门 + 强制检查),质检通过方可交付。不得就"是否质检/是否继续"询问用户——质检是链的必经终态,不是可选步骤。全链交互点预算见dev/engine/pipeline-contract.md§三「链式接续规则」。
Guardrails
- 禁自造报告形式(防漂移):交付报告一律使用 registry
templates字段指定的dev/templates/模板,章节结构与模板逐节对应;禁止自行设计版式或"参考模板风格自制"。无可用模板时按planned标记规则如实告知,不自创。 - 交付物 = 文件:链的完成态 = HTML 文件已落盘且质检通过;
rendered字段列出的是磁盘上真实存在的文件名,不是模板引用路径。 - 自动接续:本 skill 由上游 analysis 自动触发,《交付单》产出后自动移交 qa-verifier;链上不设"是否继续/是否质检"确认点。
- 不做分析:本 skill 只做模板选择、分层映射与装配,不重新计算评分、不补信号、不改评级。分析结论一律来自上游《分析产物》。
- 不复制引擎内容:只引用路径 ID、模板名与文档章节,不复制任何阈值、分层时间预算、信号优先级门槛或评级映射。分层语义以
dev/engine/output-layered-framework.md为准,模板清单以dev/engine/work-path-registry.md为准。 - 低密度不补数值:上游分析产物中因密度不足而置 null 的维度评分(信息不足无法评估),在报告中保持"信息不足"标注,不得为了报告完整而编造数值。
- planned 模板如实告知:路径模板为
planned标记时,明示"该模板待开发",并给出该路径已可用的替代交付物,不得伪造渲染产物。
References
references/report-mapping.md— 路径→模板→分层 映射视图(单源指针,不含复制值)dev/engine/pipeline-contract.md— 四段链 I/O 契约(产物 schema 单一事实源)dev/engine/work-path-registry.md— 工作路径注册表(templates字段单一事实源)dev/engine/output-layered-framework.md— L0/L1/L2 分层输出(分层语义单一事实源)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |