AIDocxWorkFlow: Skill for Claude Code

AIDocxWorkFlow 编排契约

v35 新增四大能力：

1. S1 项目级需求检测 — 显式识别项目需求 vs 单次需求，找到或创建项目目录
2. 项目级-模块级知识沉淀 — 后续阶段收到项目级需求时整理知识沉淀到知识库
3. 8 expert 并行 + merge-expert 串行收尾 — 8 个模块专家并行产出 TP/TC，merge-expert 专门合并，防止主 agent 长上下文脱轨
4. S6 强制公共级 xlsx — 不受 project_name 影响，始终产出公共级 xlsx

本 skill 不再承担"完整手工操作指南"职责。 它只定义一件事：对话层如何通过 run_stage() / run_pipeline() 驱动运行时编排。

1. 目标

• 统一单阶段与多阶段入口，避免脚本绕过 gate / ledger / review 资产。
• 让“人看到的入口说明”和“代码实际编排路径”保持一致。
• 把旧式“分阶段手工说明”降级为历史兼容背景，而不是当前推荐入口。

2. 唯一推荐入口

from ai_workflow.conversation_skills import run_stage, run_pipeline

单阶段

result = run_stage("S6", req_name="游戏道具商城系统", project_name="<project_name>", version="v3.01")
print(result["status"])

多阶段

pipeline = run_pipeline(
    ["S5", "S6", "S7"],
    req_name="游戏道具商城系统",
    project_name="<project_name>",
    version="v3.01",
)
for item in pipeline["stages"]:
    print(item["stage"], item["status"])

阶段开始前：旧产物清理询问（v8 实战决策）

run_stage() / run_pipeline() / run_s1_pipeline() 在执行每个阶段前会自动检测 该阶段目录是否存在且非空——若命中，会在 preflight 之前询问：

┌─ [AIDocxWorkFlow] 阶段开始前询问 ─────────────────────────────┐
│ 检测到阶段目录已存在且非空，是否删除旧产物后重新执行？       │
└──────────────────────────────────────────────────────────────┘
  阶段        ：S6
  需求        ：游戏道具商城系统
  版本        ：v3.01
  阶段目录    ：workflow_assets/游戏道具商城系统/v3.01/「S6 测试用例生成」
  现有文件数  ：7
  现有总大小  ：28.4 KB
  最近修改    ：2026-07-09T23:54:17
  文件清单    ：
    - test_cases.json
    - test_cases.md
    - ...

请选择：
  [Y] 删除旧产物，重新跑该阶段（推荐）
  [N] 保留旧产物，跳过该阶段（status=SKIPPED）
  [A] 中止整个流水线（abort）

决策语义：

用户输入	行为	返回 status
Y	shutil.rmtree(stage_dir) 删除整个阶段目录（含 raw + ledger），重新执行	阶段正常推进
N / 空回车	保留旧产物，跳过该阶段	SKIPPED + skip_reason=user_chose_keep_existing
A	中止整个流水线	SystemExit（run_pipeline 抛出后停）
非交互环境（无 TTY）	默认 auto_keep（不阻塞 CI）	SKIPPED + skip_reason=non_interactive_env_default_keep

作用域：

• run_stage("S6", ...) → 仅 S6 询问
• run_pipeline(["S5","S6","S7"], ...) → 每个阶段独立询问（不会批量问）
• run_s1_pipeline(...) → S1 子模块入口同样询问（覆盖直接调用场景）