Codex 快速上手包：新同事协作与启动指南

[timyefi]

这条 issue 的用途

这是一份给新同事的快速上手包，目的是把 financialanalysis 的工作边界、启动顺序、协作方式和可复用 prompt 一次性说清楚。

先读什么

1. README.md
2. AGENTS.md
3. automation_blueprint.md
4. docs/quickstart.md
5. docs/architecture.md
6. docs/contracts.md
7. docs/troubleshooting.md
8. codex_execution_runbook.md
9. production_execution_runbook.md

核心协作原则

• 一个线程只做一个主 workstream。
• 主分支固定是 main。
• scaffold 文件只是中间产物，不是最终结论。
• 对外交付和内部知识治理分开。
• 遇到结构性决策，优先更新蓝图和 runbook，而不是只在聊天里说。

可直接复制的启动 prompt

先阅读 AGENTS.md、README.md、automation_blueprint.md、codex_execution_runbook.md，以及当前 workstream 对应的专项文档。确认当前在 main 分支。请先用一句话确认本线程属于哪个 workstream，再用一句话确认唯一主交付物，然后开始执行。

可直接复制的收尾 prompt

请在结束前检查：1. 是否仍在 main 分支；2. 是否只做了一个主 workstream；3. 相关文档是否已同步；4. 是否留下了任何临时文件或半成品；5. 当前工作是否可以交接给下一个线程。

为什么这条 issue 值得保留

因为它能把“怎么开始、怎么推进、怎么结束”变成统一入口，避免新同事每次都从聊天记录里反推流程。