| name | financial-data-agent-bootstrap |
| description | Use when bootstrapping agent rules, contracts, validation, task packages, reports, and handoff boundaries for financial data engineering or operations projects. |
| metadata | {"triggers":["bootstrap a financial data agent project","create financial data project AGENTS template","define data contract and source contract","prepare financial data task package","enforce read-only and production-write boundaries"],"side_effects":["read_only","write_files"]} |
Financial Data Agent Bootstrap
financial-data-agent-bootstrap 是面向金融数据工程、运营数据治理、估值/NAV、衍生品、邮箱归档、Oracle 数据服务等项目的 agent bootstrap skill。它用于帮助项目建立薄入口、数据契约、数据源契约、验证清单、任务包、执行回执和 handoff/context 模板。
它不是投资建议 skill，不是交易策略 skill，不是 alpha research skill，不是 provider-specific API 手册，也不是某一个真实业务项目的规则集合。
Purpose
本 skill 的目标是把金融数据项目里容易混在一起的内容拆开：
- 项目级入口保持 thin / reference-first；
- 项目事实进入项目 docs；
- 本轮授权进入 task package；
- 数据口径进入 data contract / source contract；
- 验证证据进入 validation 和 execution report；
- 敏感事实留在受控项目环境内，不进入开源 skill-hub。
When to use
当金融数据项目需要以下任一能力时使用：
- 初始化或审阅项目级
AGENTS.md / CLAUDE.md 薄入口；
- 建立 dataset、source、validation、handoff、task package、execution report 模板；
- 把 read-only、dry-run、production write、DDL、scheduler、full refresh、backfill 等边界写清楚；
- 为 Wind、Oracle、Excel workbook、mail archive、Web/API、CSV/Parquet 等数据源建立可复核的约束；
- 在多 agent / 旁路 / 总控回灌工作流中固定金融数据项目的安全边界。
Project type classification
适用项目类型包括：
desktop automation scriptvaluation workbook parserWind data extraction pipelineOracle-backed data servicemail raw archive pipelineanalysis/reporting serviceagent skill hub / workflow governance project- 其他金融数据处理/分析脚本或服务
使用前应先判断项目是否包含生产写入、真实敏感数据、外部系统副作用、批处理调度、人工桌面操作或强 provider coupling。风险越高，默认越应停留在 Review Mode 或 Scaffold Mode。
Operating Modes
Review Mode
只读取项目文档、任务包、目录结构和脱敏样例，评估现有 agent 边界、数据契约、source contract、validation 和 handoff 是否足够。默认不写文件，不读取真实金融数据，不连接外部系统。
Scaffold Mode
在 task package 明确授权的路径内生成项目级薄入口和模板草案。输出应使用 placeholder，不写真实账号、DSN、token、cookie、URL、产品映射、客户映射、raw workbook 路径或邮箱附件名。
Align Mode
把既有项目文档、task package、data/source contract 和 validation 清单对齐到同一组字段与边界。只做结构和引用收敛，不扩写 provider-specific 手册，不把项目私有规则复制进 skill。
Enforce Mode
在 bounded execution 中检查本轮操作是否遵守 read-only/write authorization、敏感信息、验证证据、manifest/audit trail 和 out-of-scope 边界。发现未授权 production write、DDL、scheduler change、full refresh、backfill 或外部副作用时必须停止。
Fixed Safety Rules
- Default to read-only。
- 未经 task package 明确授权，不得进行 production write。
- 未经明确授权，不得进行 DDL、scheduler change、full refresh、backfill 或任何外部副作用。
- 不提交 raw valuation workbooks。
- 不提交 raw mail attachments。
- 不提交 credentials / DSNs / tokens / cookies。
- 不提交 private product registry exports。
- 不提交完整敏感 customer/product mapping tables。
- 生成物默认进入 ignored output 目录，除非 task package 明确授权写入源码树。
- 优先 dry-run 后 write。
- 数据产物应优先保留 manifest / audit trail。
- 报告证据优先使用 counts、schema summary、hash、manifest path、redacted sample、validation summary。
- 示例必须虚构、脱敏或 placeholder 化。
- 不把 AMS_Data、Pricing_sheet、Derivative_Data 或任何业务项目的真实路径、真实字段、真实数据或真实口径写入本 skill。
Project-fill fields
项目接入时由维护者或 task package 填写，agent 不应自行定稿：
- project name / chain name
- business purpose
- data domain
- dataset names
- source systems
- target systems
- runtime environment
- owner / reviewer / approver
- product universe
- date semantics
- sample data policy
- redaction policy
- output policy
- ignored output directory
- validation baseline
- write authorization policy
- production side-effect policy
- manifest / audit trail policy
- handoff and control-thread policy
Expected Outputs
本 skill 可产出以下文档草案或检查结果：
- 项目级薄
AGENTS.md
- 可选薄
CLAUDE.md
data_contractsource_contractvalidationtask_packageexecution_reporthandoff/context- read-only review notes
- maintainer confirmation checklist
Human vs agent responsibilities
Human / maintainer 负责：
- 确认业务目的、数据口径、source ownership、target ownership；
- 确认是否允许真实数据读取、production write、DDL、scheduler、full refresh、backfill；
- 确认敏感字段、脱敏策略、样本数据策略和输出归档策略；
- 审核任何会影响生产数据、客户输出、估值/NAV、衍生品计算或审计链路的变更。
Agent 负责：
- 按 task package 读取授权材料；
- 结构化项目事实与待确认项；
- 草拟薄入口、contract、validation、task package、execution report、handoff；
- 优先 dry-run；
- 执行明确授权的验证；
- 输出 execution report，并列明未做事项、风险、假设和下一步。
Sensitive Information Boundary
开源 skill-hub、模板、examples 和 references 不得包含：
- 真实数据库连接、真实账号、真实 URL、真实 DSN；
- token、cookie、private key、session 信息；
- 真实产品映射、客户映射、估值 workbook 路径、邮箱附件名称；
- raw valuation workbook、raw mail attachment、private product registry export；
- 完整敏感 mapping table 或可还原客户/产品身份的数据样本。
需要证据时，优先使用 count、schema summary、hash、manifest path、redacted sample、validation summary，而不是复制原始数据。
Recommended Workflow
- 读取项目
AGENTS.md、项目 docs、task package 和本 skill。
- 复述本轮 scope、allowed changes、forbidden changes、data scope、write authorization、validation plan。
- 判断使用模式：Review / Scaffold / Align / Enforce。
- 建立或检查 data contract、source contract、validation 清单。
- 先 dry-run 或生成草案，再由 maintainer 确认关键事实。
- 只有 task package 明确授权时才执行写入或外部副作用。
- 输出 execution report，记录验证结果、敏感信息检查、out-of-scope confirmation 和下一步。
Stop Conditions
遇到以下情况必须停止并报告：
- task package 未明确授权生产写入、DDL、scheduler change、full refresh、backfill 或外部副作用；
- 需要真实金融数据、raw workbook、raw attachment、credentials 或 DSN 才能继续；
- 发现未脱敏客户/产品映射或 private registry export；
- 当前工作区存在未确认改动，且本轮可能覆盖用户工作；
- 项目事实缺失会影响数据口径、估值/NAV、衍生品、客户输出或审计判断；
- 验证结果与 task package 的 acceptance criteria 冲突；
- requested change 会把薄入口扩写成第二规则库。
Validation Expectations
按项目风险选择验证深度，至少考虑：
- row count
- primary key uniqueness
- date min/max
- product universe coverage
- required field null check
- illegal value check
- source-target reconciliation
- idempotency
- dry-run vs real-run delta
- manifest completeness
- sensitive output check
- focused tests
git diff --check
如果本轮只生成模板，也应执行 path/scope 检查和 git diff --check。
Relationship To Templates / References / Examples
templates/ 是可复制到业务项目后由人补充事实的起点，不包含真实敏感信息。references/ 记录本 skill 吸收的模式和明确不复制的内容。examples/ 只说明非敏感使用方式，不提供真实路径、真实产品名、真实数据库、真实邮箱规则或真实数据样本。chatgpt-handoff-pilot 继续拥有通用 task package、bounded execution、execution report 协议。workflow-bootstrap 继续拥有 role chain 与 thin entrypoint 原则。financial-data-project-migration 负责迁移 readiness 与结构建议；本 skill 负责 bootstrap、contracts、templates 和安全边界。
