Skip to content

feat: 简化 Polaris 工作流治理流程 - #3

Merged
FaithZL merged 19 commits into
mainfrom
dev
Aug 18, 2026
Merged

FaithZL merged 19 commits into
mainfrom
dev

Conversation

@FaithZL

@FaithZL FaithZL commented Aug 18, 2026

Copy link
Copy Markdown
Collaborator

变更内容

  • 发布 Polaris 0.1.20 与 workflow 0.1.3,只保留具有独立治理意义的持久状态,删除多余的 IMPLEMENTED、DOCS_SYNCED、REVIEWED 中间节点。
  • 将 Implementation、Knowledge Delta、Review handoff 与最终 subject 通过原子门禁绑定,并补齐从 workflow 0.1.2 升级的显式迁移。
  • 同步更新恢复协议、校验器、Schemas、Skills、模板、中英文文档和使用示例。
  • 保留此前跨平台 CI fixture 修复,运行时仍仅依赖 Python 标准库。

原因与影响

原流程把执行进度拆成了多个没有独立决策权的持久状态,增加了状态同步、恢复和迁移成本。本次调整把执行细节收回到工件和门禁中,状态图只表达真正的治理边界;Agent 仍不能直接写入 VERIFIED 或 CLOSED。

复审过程中一并修复了以下语义边界:

  • Review/Validation 返工后保持可验证、可恢复的状态投影。
  • Validation 工件完整绑定 task、revision、attempt、base/head/diff。
  • 高风险 R2 的第二位 Reviewer 可以独立拒绝并成为返工 Authority。
  • 同一 revision 第三次 Review 拒绝后进入 Human-owned review_dispute,禁止第 4 次 attempt,只允许 NEW_REVISION 或 CANCEL。
  • NEW_REVISION 清除旧 revision 的 blocker、subject 与下游 artifacts,避免过期 Authority 泄漏。

验证

  • python3 -m compileall -q polaris_cli.py scripts tests
  • git diff --check origin/main...HEAD
  • 严格空 Git identity/config 环境运行 python3 tests/run_tests.py:167/167 通过,0 失败、0 错误、0 跳过。
  • 独立代码复审:Critical / Important / Minor 均为 0。

@FaithZL
FaithZL marked this pull request as ready for review August 18, 2026 17:03
@FaithZL
FaithZL merged commit f5084e9 into main Aug 18, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants