# SK-DEV-001 · TCS人格体通用研发技能大脑 · 人类可见增量验证协议 > HLDP://tcs-core/dev-verify/v2.0 > 固定编号: SK-DEV-001 > 旧名: TCS编程AI可视化验证协议 > 版本: V2.0 · 2026-07-02 > 适用: 所有光湖研发人格体、编程AI、外部Agent > 父系统: SYS-GLW-RD-0001 > 视觉见证器: GLW-VIS-000 > 方向主权: 冰朔 TCS-0002∞ > V1起草: 霜砚 > V2升级: 铸渊 > 状态: 语言规范已生效 · 视觉见证器实体尚待开发 --- ## 0. V2解决的核心问题 通用编程AI容易把开发压缩成: ```text 收到需求 → 写代码 → 跑一个测试 → 声称完成 ``` 人类看到的是头和尾，中间没有真实产品进度。 V2把研发拆成两层: ```text 内部技术子任务: 人格体自己完成、测试、审计 默认不推给不懂编程的人类 人类可见最小增量: 每一步结束后，真实软件必须多一个能打开、能看到、能操作的能力 ``` 人类不验收代码。 人类只验收: > 软件已经装好，我打开后能用，结果符合我表达的需求。 --- ## 1. V1继承与修正 继承: - 不允许只做头尾。 - 每一步必须有真实产物。 - AI文字声明不等于完成。 - 必须能够中断和恢复。 - 必须留下HLDP回执。 - 产品可见功能必须在真实软件中验证。 修正: 1. 不再把数据库、接口、编译等内部步骤逐个推给人类。 2. 人类验收单位改为“人类可见最小增量”。 3. 截图不再单独作为证据，必须绑定构建、提交、窗口和时间。 4. 人类签字只代表“功能符合需求”，不代表代码安全。 5. 安全、代码、权限和回滚由铸渊/审核人格体负责。 6. MCP不再是高级必选路线；光湖使用本地HLDP视觉入口。 7. 视觉理解默认使用云端API，不下载本地大模型。 8. 仓库现有视觉理解是Qwen-VL；万相当前登记为视频生成，不冒充视觉理解。 9. “完成”可以被新证据重新打开，历史不可删除，但结论可以被后续回执取代。 10. V2语言规范生效不等于视觉见证器程序已经开发完成。 --- ## 2. 三种任务单位 ### 2.1 RD-TASK · 研发任务 用户提出的完整目标。 例: ```text 在Tolaria中实现类似Notion的页面组件。 ``` ### 2.2 RD-VSTEP · 人类可见步骤 每一步必须让真实软件增加一个人类能看到、能操作的能力。 例: ```text RD-VSTEP-001 页面能打开 RD-VSTEP-002 标题能编辑并保存 RD-VSTEP-003 能输入第一个文本块 RD-VSTEP-004 能新增第二个文本块 RD-VSTEP-005 能拖动改变块顺序 RD-VSTEP-006 能用“/”插入块 RD-VSTEP-007 能编辑页面属性 RD-VSTEP-008 重启后内容仍存在 ``` ### 2.3 RD-ISTEP · 内部技术子任务 人格体为实现一个RD-VSTEP自行拆分的技术工作: - 数据结构 - 接口 - 状态管理 - 组件代码 - 编译 - 单元测试 - 安全检查 RD-ISTEP完整记录，但默认折叠，不要求人类理解或签字。 --- ## 3. 任务拆分铁律 ### 铁律1 · 每个RD-VSTEP必须是纵向可用切片 禁止把人类步骤写成: ```text 完成数据库 完成接口 完成React组件 ``` 必须写成: ```text 用户打开软件后，可以创建并保存一个文本块。 ``` ### 铁律2 · 一步只证明一个主要能力 如果一步需要人类同时验证五种互不相关的行为，说明步骤过大，必须继续拆。 ### 铁律3 · 步骤必须在真实目标软件中出现 以下不等于产品可见完成: - 代码文件存在 - 编译成功 - 测试模拟通过 - 浏览器临时Demo - AI说“理论上可以” 必须安装到本次任务指定的真实开发版软件。 ### 铁律4 · 后一步不得替前一步补证据 每个RD-VSTEP单独完成证据闭环后，状态才可前进。 --- ## 4. 双闸门 ### 4.1 内部闸门 · 人格体负责 ```text SPEC_READY → CODE_READY → BUILD_PASS → INTERNAL_TEST_PASS → SECURITY_REVIEW_PASS → INSTALLED ``` 失败时人格体内部修复，不把技术日志默认推给人类。 ### 4.2 人类可见闸门 ```text INSTALLED → VISUAL_EVIDENCE_READY → PERSONA_VISUAL_REVIEW_PASS → HUMAN_VISIBLE → HUMAN_ACCEPTED → RECEIPT_LOCKED ``` 没有到`HUMAN_VISIBLE`，不能告诉人类“请验收”。 没有`HUMAN_ACCEPTED`，不能把该RD-VSTEP标记为PASSED。 --- ## 5. 人类看到什么 研发主控台只默认展示: ```text Notion式页面组件 · 5/8 ✅ 页面可以打开 ✅ 标题可以编辑并保存 ✅ 可以输入普通文本块 ✅ 可以新增内容块 ✅ 可以调整内容块顺序 ⬜ “/”插入菜单 ⬜ 页面属性 ⬜ 重启恢复 ``` 每一步只提供: - 这一步能做什么 - 打开按钮 - 最简单的操作说明 - 符合预期 - 需要修改 技术代码、日志、API和数据库默认折叠。 --- ## 6. 人类签字的准确含义 人类签字表示: > 我在真实设备和真实软件中使用了这个可见功能，它符合我表达的产品需求。 人类签字不表示: - 我审核了代码安全 - 我确认数据库正确 - 我确认没有技术风险 - 我承担人格体内部实现责任 代码、安全、权限、依赖、回滚由铸渊或指定审核人格体签署。 --- ## 7. 视觉证据包 · RD-EVD 截图必须组成证据包，不能只存一张无来源图片。 ```hldp @evidence: evidence_id: RD-EVD-20260702-001 task_id: RD-TASK-... visible_step_id: RD-VSTEP-... component_id: RD-COMP-... workorder_id: RD-WO-... build_id: RD-BUILD-... commit: git-sha application: Guanghu Desktop Dev application_version: ... window_title: ... captured_at: ISO-8601 capture_scope: selected-window images: - before - after expected_visible_result: ... vision_provider: qwen-vl vision_result: PASS|FAIL|UNCERTAIN persona_review: PASS|FAIL human_decision: ACCEPTED|CHANGES_REQUESTED|PENDING human_id: RD-H-... ``` 证据文件必须使用内容哈希，防止截图与构建错配。 --- ## 8. 视觉验证链 ```text 真实桌面目标软件 → GLW-VIS-000获取用户授权窗口 → 截图/短录屏 + 窗口元数据 → 调用Qwen-VL等云端视觉API → 对比本步预期结果 → 人格体复核 → 展示给人类体验 → 人类接受或打回 → 写RD-EVD和步骤回执 ``` 光湖不在本地下载视觉大模型。 本地程序只负责采集、脱敏、路由和保存证据。 --- ## 9. 多Agent通用接入 GLW-VIS-000不属于Codex、Claude或任何单一模型。 允许接入: - Codex - Claude Code - 国内编程Agent - 网页模型Agent - 光湖注册人格体 接入方式: ```text HLDP请求文件 本地Unix Socket/Named Pipe 带短期令牌的localhost接口 平台专用薄适配器 ``` 外部Agent只能在用户授权的窗口和时间范围内请求证据。 --- ## 10. 一步完整执行 ```text 1. 人格体创建RD-VSTEP 2. 写人类可见结果和验收动作 3. 人格体内部拆RD-ISTEP 4. 开发代码 5. 自动测试和安全审核 6. 构建并安装到真实桌面软件 7. GLW-VIS-000采集真实窗口证据 8. 视觉API比对预期 9. 人格体复核 10. 人类打开软件真实使用 11. 人类选择“符合预期”或“需要修改” 12. 写RD-EVD和HLDP回执 13. 只有通过才解锁下一RD-VSTEP ``` --- ## 11. 回执格式 ```hldp @receipt: visible_step_id human_visible_result internal_gate_status installed_build evidence_id persona_auditor human_decision deviations next_visible_step supersedes ``` 状态不是不可回退。 如果后续发现问题: ```text 旧回执保留 → 新建CHANGES_REQUESTED回执 → 指向supersedes → 步骤重新打开 ``` 历史不可删除，错误结论可以被纠正。 --- ## 12. 适用范围 必须使用人类可见步骤: - 桌面软件 - Web界面 - 手机App - 插件和动态模块 - 用户能直接操作的配置 纯后端任务没有直接界面时: - 归属于某个未来可见步骤的RD-ISTEP - 或生成可理解的系统状态面板 - 人类不被要求验收内部算法 --- ## 13. Tolaria页面组件示例 ```text RD-VSTEP-001 结果: 光湖开发版中能打开新页面 RD-VSTEP-002 结果: 页面标题可编辑，关闭重开仍存在 RD-VSTEP-003 结果: 页面内可输入和保存普通文本块 RD-VSTEP-004 结果: 可新增第二个文本块 RD-VSTEP-005 结果: 可拖动改变内容块顺序 RD-VSTEP-006 结果: 输入“/”可插入标题或列表 RD-VSTEP-007 结果: 可显示和编辑页面属性 RD-VSTEP-008 结果: 重启软件后标题、块和属性完整恢复 ``` 每一步背后的技术子任务由人格体自己负责。 --- ## 14. 防跳步执行锁 1. 没有RD-VSTEP清单，不开始开发。 2. 步骤必须描述人类可见结果。 3. 未安装进真实目标软件，不得标记完成。 4. 没有绑定构建的RD-EVD，不得标记完成。 5. 视觉模型通过不能替代人类产品验收。 6. 人类不负责技术安全签字。 7. 人类打回后必须停在当前步骤。 8. 不得为了展示进度跳过中间可见能力。 9. 不得把内部技术步骤包装成人类进度。 10. 所有模型API统一走编号路由，不安装本地模型。 --- ## 15. 装载方式 ```text 通用AI/人格体 → 加载TCS-CORE → 进入SYS-GLW-RD-0001 → 加载SK-DEV-001 → 读取当前RD-TASK和RD-VSTEP → 执行双闸门 ``` 不装SK-DEV-001的Agent不得领取产品可见零件。 --- ## 16. 当前真实状态 已存在: - Qwen-VL API编号SC-004 - `video-ai-system/tools/qwen-vision.py` - 基础视觉状态记录 - D160研发主控架构 尚未开发: - GLW-VIS-000桌面视觉见证器程序 - 跨Agent本地HLDP视觉网关 - RD-EVD证据存储器 - 研发主控台步骤UI - 自动步骤解锁服务 因此本文件状态是: > 规则生效，工具待开发。 --- > ⊢ 内部怎么做，由人格体负责到底。 > ⊢ 人类只看真实软件每一步长出了什么。 > ⊢ 没装进软件、没被看见、没被使用，就不叫完成。