Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .nojekyll
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

2 changes: 1 addition & 1 deletion .sopify/blueprint/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
## 当前焦点

<!-- sopify:auto:focus:start -->
- 当前无活动 plan;EvidentLoop 可选配套安装、Codex 公开版本 dogfood 与正式 receipt 已收口,归档见 `../history/2026-07/20260718_evidentloop_optional_audit_integration/`
- 当前活动 plan`../plan/20260720_plain_language_output/`;Skill、推广页、产品形态和架构图文字边界已最小收口,方案内审计发现的两项问题已修复并通过全量验证;当前交付只执行已授权的本地 commit 与当前分支 push
- MCP tool plane 已完成 Codex-first 持久注册验证和 Claude 会话级只读调用验证,Qoder / Claude / Copilot 的后续持久注册仍按证据推进。
- P8 Protocol Kernel & Runtime Retirement 已归档至 `../history/2026-06/20260605_p8_protocol_kernel_runtime_retirement`。
- history 归档:已可用;最近归档:`../history/2026-07/20260717_sopify_entry_preflight`。
Expand Down
17 changes: 13 additions & 4 deletions .sopify/blueprint/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,20 +123,20 @@ Sopify 不默认提示、安装或执行任何 Verifier。独立审计可不绑

所有线共享一个知识面(blueprint / history)。知识面是跨 session/model/host 的共享工作记忆。

在多模型、多云、多宿主逐步解耦的环境下,Surface-shared 的目标是让项目连续性绑定到共享文件协议,而不是绑定到某个模型、云或聊天上下文。任意 host/model 只要正确消费 blueprint/history 与 handoff 暴露的机器事实,就能基于同一项目记忆继续工作;但推进 pending checkpoint 或产生副作用仍必须回到 Wire-composable 的机器接力与 protocol admission。
在多模型、多云、多宿主逐步解耦的环境下,Surface-shared 的目标是让项目连续性绑定到共享文件协议,而不是绑定到某个模型、云或聊天上下文。受支持的宿主可在用户明确要求后读取 blueprint、plan、history 与 receipts,基于同一项目记录继续工作;本地 handoff 只提供当前环境的恢复提示,推进 pending checkpoint 或产生副作用仍必须经过 protocol admission。

**Sopify 的不可替代性 = 线 + 面的组合。** Protocol 定义证据规范,sopify_writer 做协议准入,Receipts 提供审计证据。

## 三层定位 (ADR-016: Protocol-first)

> **P8 Final**:Protocol-first 是已完成的产品形态。`blueprint/protocol.md` 定义最小可携带协议。Runtime 已在 P8 中退场(W2.10 物理删除 46 文件 / ~15.6K LOC)。Protocol kernel(sopify_writer + sopify_contracts + protocol.md)是唯一的真相源和写路径
> **P8 Final**:Protocol-first 是已完成的产品形态。`blueprint/protocol.md` 定义最小可携带协议。Runtime 已在 P8 中退场(W2.10 物理删除 46 文件 / ~15.6K LOC)。Protocol kernel(sopify_writer + sopify_contracts + protocol.md)是协议真相源和受控写入边界
>
> **Blueprint Truth Cutover 原则**:Blueprint 是产品合法边界和预算的唯一定义源。Protocol kernel 定义 how it currently runs,blueprint 定义 what is valid。

| 层 | 内容 | 体量 | 可替代性 |
|----|------|------|---------|
| **Protocol Kernel** | `.sopify/` 目录约定、schema、sopify_writer、sopify_contracts | ~2K 行 + 纯文档 | 不可替代 |
| **Default Workflow** | analyze / design / develop / finalize skill prompts + host prompt assets | 纯文档/prompt | 可替换(宿主可用自有工作流) |
| **Default Workflow** | analyze / design / develop 三个主阶段 Skill、辅助 Skill 与显式 finalize 动作 + host prompt assets | 纯文档/prompt | 可替换(宿主可用自有工作流) |
| **Host / Skill Adapters** | installer / host adapters / payload / doctor | ~3K 行 | 可按宿主扩展 |

**Convention 模式(当前唯一模式)**:宿主读 prompt 指令 → 自行推进 → sopify_writer 做结构化写入校验 → receipts 提供审计证据。
Expand All @@ -160,7 +160,7 @@ Sopify 不默认提示、安装或执行任何 Verifier。独立审计可不绑
- Host LLM 是执行者,**不是 authorizer**
- Protocol admission 做**结构级校验**(sopify_writer:schema 合法、plan_id 有效、receipt 命名规范);host prompt 做**语义级引导**
- sopify_writer **不是 executor**:不生成或修改方案语义;唯一目录迁移例外是 `finalize_plan` 在版本校验后执行标准归档
- 宿主执行层**按协议文件做事**:读 plan.md / handoff / receipts,写回通过 sopify_writer
- 宿主执行层**按协议文件做事**:读 plan.md / handoff / receipts;协议状态、handoff 与 receipts 通过 sopify_writer 写回

### Subject Identity(主体身份)

Expand Down Expand Up @@ -561,6 +561,15 @@ output.py 渲染层逐字段分类。只做分类,不做改造决策(改造
- prompt asset 属于 payload/install surface
- `skills/{zh,en}` 是 prompt-layer source of truth;宿主安装产物由 installer / host adapter 渲染
- 新宿主不进 legacy 目录树结构;新宿主如需 prompt asset,走 host adapter / payload 机制
- 宿主可按请求直接路由 Analyze、Design、Develop、KB 或 Templates;单个 Skill 只完成自身职责,仍共享正式协议、授权和输出边界,不作为独立产品运行
- Analyze 负责目标、交付物与证据交接;Design 负责方案取舍、readiness 和方案正文模板;Develop 负责批准范围内的实施与验证;KB 负责长期知识和 `knowledge_sync`;Templates 只提供知识库文档形状
- Copilot 单文件产物只展开 header、Skill 入口、references 和 assets。`scripts/` 只属于具备 Skill tree 的宿主;单文件使用 references 中的等价规则,不内联 Python 或暴露不可执行脚本路径

### 公开推广页

- 仓库根目录的 `index.html` 与 `zh-CN.html` 是同一静态产品页的英文和中文入口,共用 `assets/sopify-site.css` 与 `assets/sopify-site.js`
- 页面只陈述当前正式能力与宿主梯度;GitHub Pages 的发布源为 `main / root`,实际启用仍是独立发布动作
- 首页在现有接续区说明产品形态,并以架构图作为唯一技术结构入口;Product Form 中英文 SVG 原路径保留,仅供 README 说明 Host、Skill、Assets、Handoff、Archive 五个组成,不进入首页重复展示

---

Expand Down
Loading
Loading