关于 dstack-core
dstack-core 是 dstack 工作流的支持技能,定义评审、功能生命周期和交付检查的共享契约,帮助工作流统一状态管理与变更规则。
主要功能
- 01评审状态与发现项契约
- 02通过 Beads 解析功能
- 03执行独立问题
- 04生命周期版本检查
- 05受保护的 Beads 发布
适用场景
- 01依据持久评审状态恢复评审
- 02选择下一个就绪的功能史诗
- 03执行一个独立问题
- 04对照基分支提交检查交付
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ robertderose/ dstack --skill dstack-core安装后在 Claude Code 中输入/dstack-core确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/pi-reviewers/dstack-clarity-reviewer.mddstack-delivery-integrity-reviewer.mddstack-implementation-reviewer.mddstack-readiness-reviewer.mddstack-task-reviewer.mdreferences/INTERACTION-BOUNDARY.mdPI-REVIEWER-ROSTER.mdREVIEW-FINDINGS.mdREVIEW-STATE.mdSKILL-VERSION.mdTRUST-AND-AUTHORITY.mdscripts/append-review-note.pybeads_hooks.pybeads_workflow_lock.pybeads-workflow-lock.pybuild-beads-review-projection.pycheck-skill-version.pyfinalize-feature-delivery.pyguarded-beads-push.pymigrate-review-topology.pypromote-legacy-feature.pyreconcile-beads-interactions.pyresolve-feature.pyreview-state.pyrun-workflow.pysync-pi-reviewers.pyverify-delivery-state.py详细介绍
dstack 核心契约
此支持技能包含 dstack 工作流使用的共享契约。
评审编排使用 references/REVIEW-STATE.md 管理持久的评审者身份、源边界分配、恢复执行和替换证据;
使用 references/REVIEW-FINDINGS.md 管理当前问题的处置状态;还可使用可选的
references/PI-REVIEWER-ROSTER.md 适配器,将逻辑角色映射到具名 Pi 评审者定义,而不更改与工具无关的契约。仅通过用户明确选择的目标使用
scripts/sync-pi-reviewers.py;常规技能安装不会修改 Pi Agent 目录。
build-beads-review-projection.py 提供经过验证的临时图,用于判断执行是否就绪,而无需直接读取 Beads 存储;append-review-note.py 则会在 Beads 更新期间验证并逐字节保留单行状态/问题 JSON。promote-legacy-feature.py 会将规范的公式生命周期和经过验证的实施计划关联到现有路线图根节点,而不会创建替代 Epic。
生命周期启动会使用 references/SKILL-VERSION.md 记录当前执行的已安装技能版本,并在修改前将其与可信的本地规范证据进行比较。Beads 写入和交付关闭遵循 references/INTERACTION-BOUNDARY.md:原生关联工作树权限为共享权限,修改期间使用仓库范围的租约,外部交互证据保持故障关闭,原生 Dolt 发布使用 scripts/guarded-beads-push.py,而不使用原始推送或强制推送。
执行引用此目录中文件的 dstack 工作流之前,请完整阅读相应的引用文件。调用方技能仍负责其工作流特定的权限和完成规则。
功能解析
<core-dir>/scripts/resolve-feature.py 会通过规范 slug、精确或唯一的人类可读名称,或 ID,在 Beads 中解析功能 Epic。使用 --next 选择下一个已就绪的功能 Epic。工作流命令应公开规范的 <slug> 引用,并仅在修改和审计证据中保留 Beads ID。
独立的可执行问题使用 /implement-task <task-selector>。它只处理一个处于开放状态的 task、bug、chore、spike 或独立的 feature;功能 Epic 及其后代仍归功能生命周期管理。
verify-delivery-state.py 提供 /close-feature 使用的合并后语义检查,用于将交付声明与实际的基分支提交进行核对。