Preface

The design philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” In Odoo development scenarios, a common problem is that agents directly modify code without proper specifications or validation, leading to production risks. dsh-odoo-sdd aims to solve this problem by transforming DeepSeek Harness into a Spec-Driven Development (SDD) pipeline for Odoo.

What This Is

This is a DeepSeek Harness plugin for Spec-Driven Development in Odoo. It is maintained by fhidalgodev and categorized as model reasoning. It connects to an existing Odoo instance (via JSON-RPC), orchestrates a five-stage SDD workflow, and enforces fail-closed safety gates.

Core Features

  1. Spec before code, always: Write the spec before code. Without a verified PASSED state, DONE is unreachable.
  2. Closed feedback loop: Establish a closed loop on a real, running Odoo instance. Use odoo_module install to install modules, use odoo_errors to read server tracebacks and retry.
  3. Pipeline safety: Use fail-closed gating. Each stage is persisted to disk, stop.md stops all operations, and a maximum of 5 repair iterations is allowed.
  4. No change without a spec: Requests made after the pipeline is closed are treated as new changes, requiring a new spec or an exemption.
  5. Credentials are not consent: The first socket requires explicit human authorization, bound to url + db + user.
  6. Rollback with truth reporting: Checkpoint snapshot files record the pre-image of each odoo_execute. During recovery, files created after the checkpoint are reported.
  7. Documentation generation: Generate OCA snippets, Apps index.html, and changelog.
  8. Instance-free static layers: Use odoo_validate and odoo_security_scan to check structure and security vulnerabilities before installation (such as sudo() and auth="none").
  9. Supervised or autonomous: Support human responses for each gate or use agents for unattended rounds.
  10. Cross-platform support: Supports Linux, macOS, and Windows.

Installation and Enablement

The plugin is provided as an npm package and requires meeting system environment requirements to run.
* System requirements: DSH version >= 0.1.2-rc.1, Node.js version >= 20.
* Installation method: Install the package via npm. Execute npm install dsh-odoo-sdd according to the project environment, or build from source.

Typical Usage

The development process follows the path spec → architecture → code → verify and is verified against a real instance.
1. Write the spec: Create spec.md and list acceptance criteria.
2. Architecture design: Define models, views, security, and the test plan.
3. Write code: Generate module source code and OCA documentation.
4. Verify and fix: Use odoo_module install or odoo_execute to perform operations on the instance, and read error logs via odoo_errors. If it fails, enter the repair loop.
5. Generate documentation: Use odoo_docs to generate the required documentation files.

Use Cases and Notes

  • Use cases: Odoo developers who need strict process control and want the code to be verified on a real instance before delivery.
  • Notes:
    • This plugin is not an infrastructure orchestrator, chat credential manager, or automatic committer. It does not write commits and does not ask for the password.
    • An existing Odoo instance (development/test environment) and a disposable database are required.
    • The first socket connection for the project requires explicit human authorization.

Conclusion

dsh-odoo-sdd reduces the trial-and-error cost of Odoo development by enforcing spec-driven development and closed-loop verification. It transforms DeepSeek Harness into a secure development workbench.

  • GitHub: https://github.com/fhidalgodev/dsh-odoo-sdd
  • Directory page: https://www.skillhub.cn/plugins/fhidalgodev/dsh-odoo-sdd