前言¶
在使用 DeepSeek Harness 或其他 Agent Skills 兼容工具时，智能体往往容易在需求不明确的情况下直接跳转到代码实现，这容易导致返工或交付物不符合预期。SpecWorkflow 为智能体提供了一条从粗糙请求到需求澄清、实现规范、代码执行、交付审查、修复规划，再到基于源码研究的完整路径。
是什么¶
SpecWorkflow 是一个共享工作流技能包，由 MoonCoder-HAPPY 维护。它兼容 DeepSeek Harness 和其他 Agent Skills 工具。其核心作用是赋予智能体一条有序的工作流：从最初的模糊请求出发，经过需求质询，生成实现规范，执行代码，进行交付审查，制定修复计划，诊断故障，最后完成基于源码的研究。
核心功能¶
SpecWorkflow 提供以下技能：
- Research (deep-research)：基于源码、文档、API、标准或其他第一手资料的调查。
- Requirement Grilling (to-grill)：需求质询、消除歧义、风险审查，以及决定是直接修复还是进入完整工作流。
- Implementation Specs (to-spec)：生成实现就绪的规范、修改、验收标准、验证计划和可选的任务工单。
- Execution (spec-do)：从已批准的规范、问题集、修改或修复计划中执行代码。
- Delivery Review (do-review)：对照原始请求、规范、代码差异、测试和证据进行最终交付审查。
- Repair Planning (fix-review)：针对审查中发现的必须修复项，生成修复规范和修复工单。
- Bug Diagnosis (bugs-fix)：重现故障、根因诊断、修复并生成修复证据。
安装与启用¶
在 DeepSeek Harness 中安装：
dsh plugin --profile web add specworkflow
dsh web
安装完成后，可以通过 dsh --profile web --dump-config 检查配置是否包含 specworkflow 插件。
典型用法与工作流¶
SpecWorkflow 并非对每个请求都强制走完整流程。对于小而具体的编辑（如“把表格字体变大”），智能体会直接进行实现，避免流程冗余。只有涉及跨模块影响、产品层面的需求、数据语义、权限边界、API 或发布敏感性的工作，才会被提升到完整工作流中。
进入完整工作流后，顺序如下：
to-grill -> to-spec -> spec-do -> do-review -> fix-review -> spec-do repair -> do-review
to-grill 会将模糊请求转化为具体的结论，并决定后续走向；to-spec 将其转化为实现契约；spec-do 是首次接触生产代码的阶段；do-review 决定是否可以交付；fix-review 针对必须修复的问题生成计划；bugs-fix 和 deep-research 则作为辅助技能，分别用于故障诊断和深度源码研究。
目录结构与目标模式¶
SpecWorkflow 将工作流文件保存在项目根目录下的 .spec-workflow 文件夹中，以确保项目代码和智能体的证据记录相互分离。
目录结构示例：
.spec-workflow/<feature-slug>/
requirements.md
spec.md
issues/
amendments/
implementation/
review/
repair-spec.md
repair-issues/
verification/
debug/
bugs/
research/
Goal Mode 是一个连续执行开关。开启后，智能体可以在不中断的情况下连续完成一个规范的实施、审查、修复实施和二次审查，直到完成或遇到产品选择、安全、Git 决策等阻断点。
总结¶
SpecWorkflow 通过标准化的技能组合，帮助 DeepSeek Harness 中的智能体在复杂任务中保持清晰的执行路径。通过区分简单编辑和复杂工作流，它既保证了效率，又确保了交付质量。
- GitHub: https://github.com/MoonCoder-HAPPY/SpecWorkflow
- 目录: https://www.skillhub.cn/plugins/MoonCoder-HAPPY/SpecWorkflow
