Skip to content

Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.

1.8 KB
Raw Blame

Claude Code DevFlow

.claude/ 是 Claude Code 独立工作流资产,不是 .claude/ 的符号链接或运行时代理。

资产边界

Claude Code devflow 只读取:

  • .claude/assets/devflow.defaults.yaml
  • .claude/runtime/start-workflow.md
  • .claude/runtime/workflow-state-spec.md
  • .claude/skills/superpowers/brainstorming/SKILL.md
  • .claude/agents/*.md
  • .claude/agents/devflow-*.toml
  • .claude/rules/*.mdc
  • .claude/checklists/*.md
  • .claude/skills/devflow-codex/SKILL.md

.claude/ 保留给 CodeBuddy 使用。Claude Code 工作流不得在运行时读取 .claude/ 的 agents、rules、runtime、commands、hooks 或 settings。

medium/large 需求必须先由主 Claude Code 线程执行 TASK-01:读取并使用 superpowers:brainstorming 做需求分析与澄清,产物写入 artifacts/{task_slug}/01-requirement/requirement-report.md,再进入 TASK-02。 small 路径进入 SOLO,不执行 TASK-01。

Claude Code 适配差异

  • Claude Code 不注册仓库内 slash start-devflow 命令。
  • 用 $devflow-codex start ... 或自然语言触发。
  • 主 Claude Code 线程负责 orchestration。
  • TASK-02 及之后必须使用 Claude Code Agent 派发角色 agent。
  • 不使用 team_create、send_message、team_delete。
  • workflow-state.json 是阶段交接、恢复和审计的唯一状态。

恢复检查

新线程无法识别 skill 时,检查:

  1. .agents/skills/devflow-codex 是否指向 ../../.claude/skills/devflow-codex
  2. .agents/skills/superpowers-brainstorming 是否指向 ../../.claude/skills/superpowers/brainstorming
  3. .claude/skills/devflow-codex/SKILL.md 是否存在且权限为 644
  4. .claude/skills/superpowers/brainstorming/SKILL.md 是否存在
  5. .claude 是否为真实目录,而不是指向 .claude 的符号链接