Delivery Harness Framework / 仅归档

每个生命周期阶段该用哪个 skill。

仅归档。这个经典版 Flow Map 保留用于对比;当前公共入口请使用 status-style 的当前 Skill Routing Map。

8标准生命周期阶段
9+helper / 验证 / brief 入口
3generic、repo-specific、gstack 分工
4完成证据字段

归档流程

经典 Mermaid 纵向流程图,仅保留用于对比;当前 status-style 页面是主要 Flow Map。
flowchart TD
  Start(["用户任务进入
delivery-harness-framework"]) AGENTS["读取 AGENTS.md
README 与 docs/repo-index.md"] Recover["运行 harness_recover.py --json
恢复 phase、dirty state、next safe task"] Env["运行 harness_env_probe.py --json
观测 hooks、policy、schema"] NeedsReq{"目标、范围、验收是否清晰?"} Req["需求锁定
planner / req-to-dev / task-flow-orchestrator"] ReqVal["harness_requirements.py validate PATH"] Classify{"分类生命周期阶段
和风险边界"} Repo{"是否有 repo-specific harness?"} RepoSkill["交给项目 adapter
业务路径、命令、smoke matrix"] Product["产品/范围判断
gstack-plan-ceo-review / gstack-office-hours"] Plan["工程/设计规划
gstack-plan-eng-review / gstack-plan-design-review"] Dev["开发实现
tdd-guide / atdd-guide / scoped workers"] Team{"是否并行 agents?"} TeamVal["harness_agent_team.py validate PLAN.json"] Val["验证与证据
verification-loop / harness_report.py / test_runner.py"] QA["QA / 安全 / 评审
gstack-qa / gstack-cso / gstack-review / code-reviewer"] Ship["发布/部署
gstack-ship / gstack-land-and-deploy / gstack-canary"] Docs["文档发布
gstack-document-release / doc-updater"] Handoff["交接
harness_checkpoint.py append"] Done(["输出
skill 路由、验证证据、next safe task"]) Start --> AGENTS --> Recover --> Env --> NeedsReq NeedsReq -- 否 --> Req --> ReqVal --> Classify NeedsReq -- 是 --> Classify Classify --> Repo Repo -- 是 --> RepoSkill --> Dev Repo -- 否且偏产品 --> Product --> Plan Repo -- 否且偏工程/设计 --> Plan Repo -- 否且可直接开发 --> Dev Plan --> Team Dev --> Team Team -- 是 --> TeamVal --> Val Team -- 否 --> Val Classify -- 验证 --> Val Classify -- QA/安全/评审 --> QA --> Val Classify -- 发布/部署 --> Ship --> Val Val --> Docs --> Handoff --> Done classDef runtime fill:#dff7ef,stroke:#0d9488,color:#11382f; classDef decision fill:#eee7ff,stroke:#7c3aed,color:#241247; classDef build fill:#fff3d5,stroke:#d97706,color:#4a2c04; classDef verify fill:#dff7f4,stroke:#0f766e,color:#0f3d38; classDef ship fill:#ffe4eb,stroke:#be123c,color:#5b1025; class AGENTS,Recover,Env,ReqVal,TeamVal,Handoff runtime; class NeedsReq,Classify,Team decision; class Req,Plan,Dev,RepoSkill,Product build; class Val,QA,Docs verify; class Ship ship;

Skill 与 Helper 映射

Helper 负责客观运行时事实;skill 负责认知工作流
流程步骤 主要 Skill Helper 命令 何时路由到这里
启动 / 恢复 delivery-harness-framework scripts/harness_recover.py --json
scripts/harness_env_probe.py --json
任何复杂任务、恢复会话、dirty 工作树、跨阶段交接或含糊请求。
需求 plannerreq-to-devtask-flow-orchestrator docs/templates/harness-requirements.md
scripts/harness_requirements.py validate PATH
CONTEXT.md / CONTEXT-MAP.md / ADR
目标、范围、受众、约束、领域词汇、成功标准或验收测试尚未锁定。
产品 / 业务判断 gstack-plan-ceo-reviewgstack-office-hours scripts/harness_requirements.py validate PATH when a requirement artifact exists 需要明确用户价值、范围、demo 边界、优先级或业务取舍。
工程 / 设计规划 gstack-plan-eng-reviewgstack-plan-design-reviewplanner scripts/harness_agent_team.py validate PLAN.json when parallel work is proposed
docs/templates/harness-agent-brief.md when a worker needs a durable contract
需要决策架构、API、数据流、迁移、视觉结构、vertical slices、AFK/HITL 或多 agent 归属。
开发 tdd-guideatdd-guidescoped worker agents scripts/harness_agent_team.py validate PLAN.json
git status --short --branch
已有清晰验收标准,且生命周期策略允许有范围的 repo 写入;worker brief 可校验 current/desired behavior、key interfaces 和 acceptance criteria。
验证 / 证据 verification-loopharness_report.py python3 test_runner.py
git diff --check
scripts/verify_codex_env.sh ...
声明完成前、代码/配置/文档变更后,或 debug 任务需要先建立 runnable feedback loop 时。
QA / 评审 / 安全 gstack-qagstack-qa-onlygstack-reviewcode-reviewergstack-csosecurity-reviewer git diff, scripts/harness_env_probe.py --json for runtime-sensitive work 存在 diff、用户可见行为、安全/隐私边界,或工作接近交接/发布时。
发布 / 部署 / Canary gstack-shipgstack-land-and-deploygstack-canary scripts/verify_codex_env.sh ...
scripts/harness_checkpoint.py append
用户明确要求 commit、PR、merge、release、deploy 或生产验证时。
文档 / 交接 gstack-document-releasedoc-updaterdelivery-harness-framework scripts/harness_checkpoint.py append
scripts/harness_report.py --json
文档需要反映已交付行为,或会话需要持久化 next safe task 状态时。

路由规则

1. 运行时事实优先于记忆 先运行 recovery 与 env probe。聊天历史和 subconscious 输出只是提示,不能作为唯一事实来源。
2. 需求 gate before planning 如果范围、验收标准或领域词汇不稳定,先创建或验证 requirements artifact,并读取 CONTEXT.md / ADR。
3. 没有 validator 就不并行写入 任何 worker team 都必须通过 harness_agent_team.py validate 证明 write set 不重叠;长期交接任务要补 durable brief。
4. 完成声明需要 fresh evidence 声明完成前必须记录 commandexit_codekey_outputtimestamp;debug 修复前先证明 feedback loop。
5. 交接是运行时事件 有意义的工作切片结束时,用 harness_checkpoint.py append 记录 command、exit code、key output、timestamp 和 next safe task。
6. Repo 不能强制全局 sandbox env probe 只能报告可观测的 sandbox/approval 配置,不能假装知道隐藏的 Desktop thread 状态。

相关链接