sudocode

概述

sudocode 是一个基于 TypeScript 的代理编排系统，驻留在您的代码库中，为 AI 编码代理提供上下文管理和任务协调。它实现了四层抽象结构：规范（用户意图）、问题（代理任务）、代理（执行抽象）和工件（状态变化）。该系统提供人类可编辑的 Markdown 格式和机器优化的 JSONL+SQLite 存储方案，并支持自动同步。其 MCP 服务器使 AI 代理能够长期跟踪上下文，并通过 git 原生内存管理系统协作处理复杂需求。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• create_spec

  Create a new specification in sudocode

  试试:Create a new spec for user authentication system试试:Create a spec called api-design for the new REST API
• list_specs

  List all specifications in the sudocode system

  试试:Show me all specs in this project试试:List existing specifications
• create_issue

  Create a new implementation issue linked to a spec

  试试:Create an issue for implementing OAuth 2.0试试:Create a new issue for the user registration flow
• list_issues

  List all issues in the sudocode system

  试试:Show me all issues for the auth system spec试试:List all unimplemented issues
• update_spec

  Update an existing specification with new requirements

  试试:Update the auth system spec to include multi-factor authentication试试:Add API rate limiting requirements to the API design spec
• update_issue

  Update an existing issue with new information or status

  试试:Mark the OAuth 2.0 issue as completed试试:Update the user registration issue with new requirements
• link_spec_to_issue

  Create a bidirectional link between a spec and an issue

  试试:Link the user auth spec to the OAuth issue试试:Connect the API design spec to the implementation issues
• execute_issue

  Execute an issue with a coding agent

  试试:Execute the user registration issue with a coding agent试试:Implement the OAuth 2.0 issue
• create_workflow

  Create a workflow to execute multiple issues in topological order

  试试:Create a workflow to execute all auth-related issues试试:Build a workflow for the entire API implementation
• list_agents

  List all configured agents in the sudocode system

  试试:Show me all configured agents试试:List available coding agents
• open_in_editor

  Open a spec or issue in the configured editor

  试试:Open the auth spec in VS Code试试:Show the user registration issue in Cursor
• get_dependencies

  Get dependency graph for specs and issues

  试试:Show dependencies for the auth system试试:What issues block the API implementation?

说明：Tool names inferred from CLI usage patterns and documentation. The README describes the system's capabilities but doesn't provide a complete API reference. Tool signatures are unknown as they are not explicitly documented.

可对比工具

安装

npm install -g sudocode

sudocode init

FAQ

规范(specs)和问题(issues)之间有什么关系？

规范代表用户意图和需求（要做什么），而问题是从规范中衍生出的工作项，由代理实现（如何实现）。问题可以使用 [[SPEC-001]] 语法引用特定的规范。

sudocode 如何处理代理会话之间的上下文持久化？

sudocode 将上下文存储为 git 跟踪的文件，位于 .sudocode/specs/ 和 .sudocode/issues/ 目录中，同时提供人类可读的 Markdown 和机器优化的 JSONL 格式。这创建了一个版本控制化的记忆系统，可以在会话之间持久保存。

Hacker News 讨论

开发者社区最近的相关讨论。

• Show HN: sudocode – manage specs, tasks, and context-as-code for coding agents▲ 15💬 5
  帖子 by alexsngai · 2025-11-05

sudocode 对比