Diecast：为Claude Code铸造结构化工作流的模具

Diecast通过 maker-checker 模式和工作流链设计，为Claude Code用户提供了一套可复现、可审计的AI辅助开发框架，解决了AI生成代码风格不一致和PR审查爆炸的痛点。

Diecast的名字来源于金属铸造工艺——将熔融金属注入精密模具，产出形状确定、质量可控的零件。类比到AI辅助开发，Diecast希望每一次AI参与的工作都能按照预设的「模具」（spec）执行，消除随机性和漂移（drift）。

项目采用双层架构：

*Layer-1： opinionated agents（cast-系列）

每个agent都是从spec「铸造」而成，配有对应的checker进行输出验证。这种「maker-checker」模式是系统的可靠性基石——maker负责生成，checker负责验证，两者配对确保输出符合预期形状。

Layer-2：工作流链（Workflow Chain）

将复杂目标分解为研究、规划、执行、审查四个阶段，支持父-子任务委派。无论是否运行本地服务器，这种委派机制都能正常工作，避免了 brittle prompt（脆弱提示词）的问题。

项目文档中明确指出了三个反复困扰资深工程师的问题：

痛点一：AI写的代码正确，但不是你想要的方式

这导致工程师逐渐丧失对代码库的直觉理解。Diecast的应对是通过规范化的spec强制输出形状一致性，让AI的产出符合人类可预期的模式。

痛点二：Junior成员借助AI爆炸式产出PR，人工审查不堪重负

Diecast引入checker机制自动验证输出是否符合spec，将部分审查工作从人类转移到自动化流程。

痛点三：AI无法按预期完成大型、有主见的任务

每个RBAC风格的集成都需要大量前期spec编写。Diecast通过工作流链将大任务分解为可组合的小步骤，每个步骤都有明确的输入输出契约。

Diecast定义了一条清晰的工作流链，每个环节都有对应的/cast-*命令和输出产物：

1. /cast-refine —— 将粗糙需求精炼为结构化文档，输出到 docs/requirement/<goal>_refined_requirements.collab.md

2. /cast-goal-decomposer —— 将目标分解为可执行子任务，输出到 docs/exploration/<goal>/decomposition.ai.md

3. /cast-explore —— 研究阶段，收集相关技术资料，输出到 docs/exploration/<goal>/research.ai.md

4. /cast-high-level-planner —— 高层规划，输出到 docs/plan/<date>-<goal>.collab.md

5. /cast-detailed-plan —— 详细计划，按阶段拆分，输出到 docs/plan/<date>-<goal>-phase-N.collab.md（自动触发/cast-plan-review）

6. /cast-orchestrate —— 执行阶段，协调各phase的落地

每个步骤的输出都遵循稳定的文件命名约定，下一步骤可以无缝读取上一步的产物。这种设计使得工作流可中断、可恢复、可审计。

Diecast的部署流程设计得相当简洁：

# 1. 克隆仓库
git clone https://github.com/sridherj/diecast.git ~/workspace/diecast
cd ~/workspace/diecast

# 2. 安装（自动配置skills、agents，并将cast-server加入PATH）
./setup

# 3. 在任意项目初始化docs/结构
cd ~/your-project
/cast-init

# 4. 开始工作流链
/cast-refine
/cast-high-level-planner
/cast-orchestrate

安装后，cast-server作为用户级守护进程在后台运行（默认端口8005），状态存储在~/.cast/diecast.db，日志位于~/.cache/diecast/。所有其他操作都通过Claude Code内的/cast-*命令完成。

工作流链的核心创新是「父-子委派原语」（parent-child delegation primitive）。当某个工作流步骤需要生成并监督子任务时，无需编写复杂的prompt，系统会自动处理子任务的创建、监控和结果汇总。这一机制让单条链式步骤能够优雅地处理并行子任务，而不会因为prompt复杂度失控而失效。

Diecast明确了自己的定位边界：它不是要替代Claude Code，也不是要修复底层模型本身的局限，而是修复「围绕模型的工作流」。如果你已经在用胶带和胶水拼接各种.claude/agents/文件，Diecast提供了一套你希望自己早就写下的规范；如果你已经构建了基于Claude Code的自定义harness，Diecast则是「如果你有足够时间清理代码，你会交付的样子」。

Diecast目前主要面向使用Claude Code的开发者，其slash命令和server架构深度绑定这一特定AI编程环境。对于使用Copilot、Cursor或其他AI编程助手的团队，直接迁移可能并不适用。此外，项目强调「opinionated」（有主见）的设计理念，意味着使用者需要接受其预设的工作流规范和文件组织方式，灵活性换取一致性。