Takt SDD 工作流
经 AI Skill Hub 精选评估，Takt SDD 工作流 获评「强烈推荐」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.0 分，适合有一定技术背景的用户使用。
📚 深度解析
Takt SDD 工作流 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.0 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
Spec-Driven Development工作流定义仓库
Takt SDD 工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
Spec-Driven Development工作流定义仓库
Takt SDD 工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g takt-sdd # 方式二：npx 直接运行（无需安装） npx takt-sdd --help # 方式三：项目依赖安装 npm install takt-sdd # 方式四：从源码运行 git clone https://github.com/j5ik2o/takt-sdd cd takt-sdd npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
takt-sdd --help
# 基本用法
takt-sdd [options] <input>
# Node.js 代码中使用
const takt_sdd = require('takt-sdd');
const result = await takt_sdd.run(options);
console.log(result);
# takt-sdd 配置说明 # 查看配置选项 takt-sdd --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export TAKT_SDD_CONFIG="/path/to/config.yml"
takt-sdd
Write the spec. takt reliably ships the rest.
A Spec-Driven Development (SDD) workflow definition repository using takt.
Automates the entire development flow — from requirements definition through design, task decomposition, implementation, review, and validation — using takt workflows (YAML workflows) and facets.
takt-sdd is compatible with Kiro (.kiro/specs/) and can be used alongside it.
Features
takt-sdd uses takt's state-machine-based workflow control to deterministically manage AI agent execution paths.
- Declarative Workflow Control — Define AI agent execution order and transition conditions declaratively in workflows (YAML). While AI output itself is non-deterministic, "which step, in what order, under what conditions" is deterministically controlled by YAML rules. Workflows progress as state machines, not free-form chat.
- Faceted Prompting — Separate prompts into 5 independent concerns (Persona / Policy / Instruction / Knowledge / Output Contract). Each facet is reusable and swappable, shareable across workflows. Eliminates duplication of monolithic prompts and improves maintainability.
- Multi-stage Validation — Place validation gates at each phase: requirements, design, and implementation. Gap analysis, design review (GO/NO-GO decisions), and parallel architecture/QA/implementation reviews detect quality issues early and minimize rework.
- Loop Detection and Supervisory Control — Automatically detect repetitive patterns like plan→implement and review→fix. When thresholds are exceeded, a supervisor intervenes to assess progress and automatically escalates unproductive loops.
- Adaptive Batch Implementation — Analyze inter-task dependencies and automatically choose between sequential and parallel execution. Independent tasks are processed in parallel by multiple workers.
- Provider Agnostic — The same workflow definitions work across different providers such as Claude and Codex.
Check the {feature} name in .kiro/specs/{feature}
Prerequisites
- Node.js 22+
takt-sdduses thetaktdependency bundled with the installed package for workflow execution. A project-localtaktdependency or copied.takt/directory is not required for ordinary use.
Requirements generation
takt-sdd kiro-spec-requirements -- "description of requirements..."
Installation
npm install -g takt-sddManual npm script examples
{
"scripts": {
"kiro:spec:quick": "takt-sdd kiro-spec-quick",
"kiro:impl": "takt-sdd kiro-impl",
"kiro:validate:impl": "takt-sdd kiro-validate-impl"
}
}Then pass workflow arguments after --, for example:
npm run kiro:impl -- "feature={feature}"Global options
| Option | Description |
|---|---|
--cwd <dir> | Set the target project root directory (default: current working directory) |
`.takt/config.yaml` ownership
.takt/config.yaml is a user-owned file. It may be placed globally at ~/.takt/config.yaml or per-project, and is created and maintained by the user, not by the CLI. The CLI only reads it to determine workflow language and the default eject language. The CLI never creates or modifies this file.
Optional discovery
takt-sdd kiro-discovery -- "feature idea..."
Run workflows
takt-sdd kiro-spec-quick "description of requirements..."
takt-sdd kiro-impl -- "feature={feature}"Retired workflows
cc-sdd-* workflows (retired in v2.0.0): The global CLI rejects cc-sdd-* commands with an explicit error:
takt-sdd cc-sdd-full # Error: `cc-sdd-*` workflows were retired in v2.0.0 and are no longer available.
takt-sdd run cc-sdd-full # Error: same rejectionopsx-* workflows (retired, future re-provision planned): The global CLI rejects opsx-* commands:
takt-sdd opsx-propose # Error: `opsx-*` workflows have been retired and will be re-provided in a future release.
takt-sdd run opsx-full # Error: same rejectionKiro Compatibility Workflow
Run SDD workflows directly with takt-sdd kiro-*. kiro:* npm scripts are optional project-owned aliases; takt-sdd init and create-takt-sdd no longer create or update them. The cc-sdd:* npm scripts compatibility surface ended in v2.0.0.
| Phase | Direct command | Optional npm alias | Description |
|---|---|---|---|
| Discovery | takt-sdd kiro-discovery | kiro:discovery | Route a feature idea, update brief/roadmap when needed |
| Spec quick path | takt-sdd kiro-spec-quick | kiro:spec:quick | Generate requirements, design, and tasks through the closed-loop path |
| Requirements | takt-sdd kiro-spec-requirements | kiro:spec:requirements | Generate requirements in EARS format |
| Gap validation | takt-sdd kiro-validate-gap | kiro:validate:gap | Compare requirements with the current codebase |
| Design | takt-sdd kiro-spec-design | kiro:spec:design | Generate technical design and discovery notes |
| Design validation | takt-sdd kiro-validate-design | kiro:validate:design | Review design quality and return a GO/NO-GO decision |
| Tasks | takt-sdd kiro-spec-tasks | kiro:spec:tasks | Generate implementation tasks |
| Batch specs | takt-sdd kiro-spec-batch | kiro:spec:batch | Generate multiple specs from roadmap dependency order |
| Status | takt-sdd kiro-spec-status | kiro:spec:status | Report spec phase, approvals, and readiness |
| Implementation | takt-sdd kiro-impl | kiro:impl | Implement approved tasks with review/debug/verify gates |
| Implementation validation | takt-sdd kiro-validate-impl | kiro:validate:impl | Validate implementation evidence and remaining manual checks |
takt-sdd 是一个基于 takt 状态机工作流控制的项目，旨在通过确定性的方式管理 AI agent 的执行路径。它能够将非确定性的 AI 输出转化为可控的执行逻辑，确保 AI 在预设的流程中按序运行。
核心特性是声明式工作流控制（Declarative Workflow Control）。开发者可以通过 YAML 文件声明式地定义 AI agent 的执行顺序和转换条件。虽然 AI 的具体输出具有随机性，但“在��种条件下执行哪一步骤”这一执行逻辑是完全确定且可控的。
使用本项目需要安装 Node.js 22 或更高版本。takt-sdd 内置了用于工作流执行的 takt 依赖，因此在常规使用场景下，您无需在项目中额外安装本地 takt 依赖或手动复制 .takt/ 目录。
可以通过 npm 全局安装 takt-sdd，执行命令为：`npm install -g takt-sdd`。
可以通过 npm scripts 定义自定义别名（如 `kiro:impl`）来简化操作。在执行脚本时，需在命令末尾使用 `--` 来传递工作流参数，例如：`npm run kiro:impl -- "feature={feature}"`。此外，您还可以使用 `kiro-discovery` 进行功能构思探索。
项目支持通过 `--cwd <dir>` 参数指定目标项目根目录。关于 `.takt/config.yaml`，该文件属于用户所有（user-owned），您可以将其放置在全局目录 `~/.takt/config.yaml` 或项目本地。CLI 仅负责读取该文件以确定工作流语言和默认的 eject 语言，不会自动创建或修改此文件。
开发者可以使用 `takt-sdd kiro-*` 系列命令直接运行 SDD 工作流。请注意，`cc-sdd-*` 系列工作流已在 v2.0.0 版本中退役，若尝试调用将收到明确的错误提示。建议通过 `kiro-spec-quick` 生成需求规格，再配合 `kiro-impl` 进行实现。
高质量的AI工作流定义仓库
- 构建多智能体协作系统的 Agent 开发者
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 构建多智能体协作系统的 Agent 开发者
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +Apache-2.0 协议，可免费商用
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：Takt SDD 工作流 的核心功能完整，质量优秀。对于自动化工程师和运维人员来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | takt-sdd |
| 原始描述 | 开源AI工作流：A Spec-Driven Development (SDD) workflow definition repository using takt。⭐37 · TypeScript |
| Topics | ai-agentai-dlcsddtakttypescript |
| GitHub | https://github.com/j5ik2o/takt-sdd |
| License | Apache-2.0 |
| 语言 | TypeScript |
收录时间：2026-06-09 · 更新时间：2026-06-11 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。