Skip to content

tywinlu1988/Credence-China / version/v0.12.3-release/.claude/skills/credit-report-builder

credit-report-builder

Verified

Use 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.

FileKindSize
SKILL.mdskill md8.5 KB
references/report-mapping.mdmarkdown2.9 KB
---
name: credit-report-builder
description: Use 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(字段形状见 `engine/pipeline-contract.md` §2.2)。

## Outputs(产出)

- **交付报告**:渲染自 `templates/`(模板单一事实源,本 skill 不自带模板副本)。用哪个模板由该路径在 `engine/work-path-registry.md` 的 `templates` 字段决定,不擅自更换。
- **《交付单》(Delivery Note)**:结构化 yaml,字段形状见 `engine/pipeline-contract.md` §2.3。

## Assembly Protocol(装配协议)

1. **读 join key**:从路径单与分析产物取 `path_id`,校验它指向注册表中的已注册路径;不一致即停止并上报。
2. **选模板**:按 `path_id` 在 registry 的 `templates` 字段取模板清单(Type 1–19,Type 6/9/12 已归档;或允许的标记值 `planned` / `L0-spec:`)。标记值含义以 registry §schema 为准;命中 `planned` 须如实告知"模板待开发",不得伪造渲染产物。
3. **映射分层**:把分析产物映射到 L0 信号卡 / L1 快照 / L2 深度报告三层。三层的定义、消费时间与信息密度以 `engine/output-layered-framework.md` §二(三层总览)/§三(L0 信号卡)/§五(L2 深度报告)为单一事实源,本 skill 不重新定义。
4. **渲染**:用 `templates/` 的模板装配报告;完备性灯号口径见 output-layered-framework §8.4。
5. **写文件**:将装配完成的每份报告**写入磁盘为独立 `.html` 文件**(每个 registry `templates` 字段指定的模板产出一份)。文件命名规则:`{发行人简称}-{路径简称}-{日期}.html`(示例:`隆基绿能-审贷评级-20260729.html`、`某城投-盯市信号卡-20260729.html`)。若同一路径产出多份报告,第二份起加报告类型标识,如 `{发行人简称}-{路径简称}-{报告类型}-{日期}.html`。报告为完全自包含 HTML(CSS 已内联于模板 `<style>` 块首段),可直接在浏览器打开或转发。写入位置:当前工作目录或用户指定目录,文件名写入 `rendered` 列表。
6. **索引页**:若 `rendered` 报告文件数 **>2**,额外生成 `report-index.html` 放入同目录。索引页为自包含 HTML(内联 base.css),深色主题,简洁居中布局,包含:
   - 页头标题:`{发行人简称} · 信用分析报告集` + 生成日期
   - 每条报告一行:**文件名(相对链接)** + 报告类型中文名 + 一句话简介(从交付单 `tier_mapping` 取对应层描述)
   - 页脚:同模板 footer(报告编号占位 + 生成日期 + "不构成投资建议")
   索引页本身写入 `rendered` 列表末尾。
7. **产交付单**:按下述 schema 输出《交付单》。

## 装配纪律

1. **逐节溯源**:每个 section 的内容必须可溯源至上游分析产物;任何数据点不得凭模板示例或印象生成。
2. **示例区整节替换**:模板中的示例/演示内容(含数值、公司名、结论)必须整节替换,禁止部分保留。
3. **交付前残留自查**:搜索 `{` 残留占位符与已知实例名(`tests/test_template_contract.py` 的 INSTANCE_NAMES),任一命中即回炉。
4. **文件交付即交付**:仅有文字摘要、无 `.html` 文件落盘 = 未完成交付(协议违规)。`rendered` 列出的每个文件必须对应磁盘上可打开的独立 HTML 文件。若 `rendered` > 2 且缺 `report-index.html` — `pass-with-findings`。

## Delivery Note Output(《交付单》)

模板(schema 单一事实源为 `engine/pipeline-contract.md` §2.3):

```yaml
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,含马赛克完备性附录):

```yaml
path_id: WP-M0-01
depth: L2
templates_used:
  - 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-analysis` skill —— 消费其《分析产物》。无分析产物时本 skill 不启动(自身不做分析,先回上游完成分析)。
- **REQUIRED NEXT SUB-SKILL**:`credit-qa-verifier` —— 《交付单》产出后**自动**移交质检 skill 做交付前终态复核(质量门 + 强制检查),质检通过方可交付。**不得就"是否质检/是否继续"询问用户**——质检是链的必经终态,不是可选步骤。全链交互点预算见 `engine/pipeline-contract.md` §三「链式接续规则」。

## Guardrails

- **禁自造报告形式(防漂移)**:交付报告一律使用 registry `templates` 字段指定的 `templates/` 模板,章节结构与模板逐节对应;禁止自行设计版式或"参考模板风格自制"。无可用模板时按 `planned` 标记规则如实告知,不自创。
- **交付物 = 文件**:链的完成态 = HTML 文件已落盘且质检通过;`rendered` 字段列出的是磁盘上真实存在的文件名,不是模板引用路径。
- **自动接续**:本 skill 由上游 analysis 自动触发,《交付单》产出后自动移交 qa-verifier;链上不设"是否继续/是否质检"确认点。
- **不做分析**:本 skill 只做模板选择、分层映射与装配,不重新计算评分、不补信号、不改评级。分析结论一律来自上游《分析产物》。
- **不复制引擎内容**:只引用路径 ID、模板名与文档章节,不复制任何阈值、分层时间预算、信号优先级门槛或评级映射。分层语义以 `engine/output-layered-framework.md` 为准,模板清单以 `engine/work-path-registry.md` 为准。
- **低密度不补数值**:上游分析产物中因密度不足而置 null 的维度评分(信息不足无法评估),在报告中保持"信息不足"标注,不得为了报告完整而编造数值。
- **planned 模板如实告知**:路径模板为 `planned` 标记时,明示"该模板待开发",并给出该路径已可用的替代交付物,不得伪造渲染产物。

## References

- `references/report-mapping.md` — 路径→模板→分层 映射视图(单源指针,不含复制值)
- `engine/pipeline-contract.md` — 四段链 I/O 契约(产物 schema 单一事实源)
- `engine/work-path-registry.md` — 工作路径注册表(`templates` 字段单一事实源)
- `engine/output-layered-framework.md` — L0/L1/L2 分层输出(分层语义单一事实源)
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall