@hongmaple0820/scale-engine 0.25.0 → 0.26.0

package/docs/README.md

@@ -1,92 +1,101 @@
-# SCALE Engine 文档地图
-
-这个目录同时包含用户指南、治理能力说明、架构参考、历史规划和推广素材。新用户应优先阅读入门入口和当前治理能力文档，历史规划仅作为背景材料。
-
-## 新用户入口
-
-| 文档 | 说明 |
-| --- | --- |
-| [start/README.md](start/README.md) | 入门路径总览 |
-| [start/quickstart.md](start/quickstart.md) | 3 分钟快速开始 |
-| [start/agent-governance-demo.md](start/agent-governance-demo.md) | 官方 demo walkthrough |
-| [start/artifact-lifecycle.md](start/artifact-lifecycle.md) | Artifact 生命周期完整 walkthrough |
-| [../README.md](../README.md) | 项目主页和能力总览 |
-
-## 当前治理能力
-
-| 文档 | 说明 |
-| --- | --- |
-| [RESOURCE_GOVERNANCE.md](RESOURCE_GOVERNANCE.md) | 文档、报告、媒体、脚本、临时产物的生命周期治理 |
-| [ENGINEERING_STANDARDS.md](ENGINEERING_STANDARDS.md) | 日志、安全、ORM、框架、测试、部署等工程规范 |
-| [BACKGROUND_HUNTER.md](BACKGROUND_HUNTER.md) | Background Hunter 只读主动巡检、诊断交接和 ignore baseline |
-| [DEPENDENCY_AUDIT.md](DEPENDENCY_AUDIT.md) | 供应链依赖审计、G7 dependency 子门禁和 dependency policy |
-| [TOOL_ORCHESTRATION.md](TOOL_ORCHESTRATION.md) | skills、MCP、CLI、浏览器、桌面自动化的编排策略 |
-| [RUNTIME_EVIDENCE.md](RUNTIME_EVIDENCE.md) | 会话 ledger、运行时证据和最终交付检查 |
-| [MEMORY_FABRIC.md](MEMORY_FABRIC.md) | Runtime evidence、session events、knowledge recall 和 graph status 的预算化上下文包 |
-| [MEMORY_BRAIN.md](MEMORY_BRAIN.md) | 证据驱动的长期记忆、矛盾检测、dream 整理和 failure replay 沉淀 |
-| [CONTEXT_BUDGET.md](CONTEXT_BUDGET.md) | Context Budget、Progressive Governance、Lazy Loading 和 Governance ROI |
-| [CODE_INTELLIGENCE.md](CODE_INTELLIGENCE.md) | CodeGraph、Graphify 和显式 fallback 的代码智能与探索 ROI |
-| [WORKFLOW_EVAL.md](WORKFLOW_EVAL.md) | Workflow Eval、pass@k 指标、Failure Replay 和改进候选 |
-| [SKILL_RADAR.md](SKILL_RADAR.md) | Skill Radar、能力置信度、证据要求和供应链安全检查 |
-| [THIRD_PARTY_SKILLS.md](THIRD_PARTY_SKILLS.md) | 第三方 skill 致谢、授权边界、引用方式和 vendoring 策略 |
-| [EXTERNAL_REFERENCES.md](EXTERNAL_REFERENCES.md) | 外部项目、skills、MCP、CLI 和适配器引用的完整清单 |
-| [UPGRADE_MANAGEMENT.md](UPGRADE_MANAGEMENT.md) | SCALE CLI、governance pack、skills、MCP 和 CLI 工具的安全升级流程 |
-| [GOVERNANCE_DASHBOARD.md](GOVERNANCE_DASHBOARD.md) | Runtime、eval、memory、resource、HTML artifact 的统一治理面板 |
-| [RELEASE_READINESS.md](RELEASE_READINESS.md) | 发版前质量门槛、官方 demo 和真实项目落地验收 |
-| [DOCUMENT_STANDARDS.md](DOCUMENT_STANDARDS.md) | 文档编写与维护规范 |
-| [GITLAB_FLOW.md](GITLAB_FLOW.md) | GitLab Flow 分支、发版、tag 和临时 worktree 生命周期规范 |
-| [SKILL-REPOSITORY.md](SKILL-REPOSITORY.md) | 受治理 skill repository 和安装安全策略 |
-| [VIBE-TEMPLATES.md](VIBE-TEMPLATES.md) | 可复制的 Vibe Coding 提示词模板 |
-| [LEADERSHIP-PRESETS.md](LEADERSHIP-PRESETS.md) | CEO、CTO、PM、Architect 等内置领导者角色预设 |
-
-## 当前规划与执行蓝图
-
-这些文档描述计划中的架构演进，不代表当前 CLI 已全部实现。进入实现前应按文档中的验收标准和红线逐项拆分任务。
-
-| 文档 | 说明 |
-| --- | --- |
-| [plans/2026-05-20-scale-engine-v2-final-architecture-plan.md](plans/2026-05-20-scale-engine-v2-final-architecture-plan.md) | SCALE Engine V2.0 最终架构落地方案：Prompt Cache、Dashboard 聚合、Background Hunter、供应链门禁、动态/视觉验证和 Evolution Shadow Mode |
-
-## 架构与参考
-
-| 文档 | 说明 |
-| --- | --- |
-| [00-OVERVIEW.md](00-OVERVIEW.md) | 系统概览 |
-| [01-ARCHITECTURE.md](01-ARCHITECTURE.md) | 架构设计 |
-| [02-DATA-MODEL.md](02-DATA-MODEL.md) | 数据模型 |
-| [03-CORE-MODULES.md](03-CORE-MODULES.md) | 核心模块 |
-| [04-INTEGRATION.md](04-INTEGRATION.md) | 平台与集成 |
-| [06-DECISIONS.md](06-DECISIONS.md) | 架构决策记录 |
-
-## 历史规划和过程记录
-
-这些文档是历史上下文，不一定代表当前产品入口：
-
-| 文档 | 说明 |
-| --- | --- |
-| [05-ROADMAP.md](05-ROADMAP.md) | 路线图 |
-| [OPTIMIZATION_PLAN.md](OPTIMIZATION_PLAN.md) | 历史优化计划 |
-| [WEEK1-2-REPORT.md](WEEK1-2-REPORT.md) | 阶段报告 |
-| [TASK_GUARD_SUMMARY.md](TASK_GUARD_SUMMARY.md) | Task Guard 总结 |
-| [TASK_GUARD_WORKFLOW_DEMO.md](TASK_GUARD_WORKFLOW_DEMO.md) | 早期 workflow demo |
-| [plans/2026-05-19-agent-engineering-os-upgrade-plan.md](plans/2026-05-19-agent-engineering-os-upgrade-plan.md) | Agent Engineering OS 升级审核稿：Context Budget、CodeGraph、Memory Brain、Skill Radar、HTML Artifact 和 Eval Harness |
-| [plans/](plans/) | 规划方案和技术方案归档 |
-| [superpowers/](superpowers/) | 外部方法论对照和计划归档 |
-
-## 推广和素材
-
-| 文档 | 说明 |
-| --- | --- |
-| [promote-article-v2.md](promote-article-v2.md) | 推广文章草稿 v2 |
-| [promote-article-v2.html](promote-article-v2.html) | 推广文章 HTML v2 |
-| [promote-article-v3.md](promote-article-v3.md) | 推广文章草稿 v3 |
-| [promote-article-v3.html](promote-article-v3.html) | 推广文章 HTML v3 |
-| [imgs/](imgs/) | 社群二维码和推广图片 |
-
-## 维护规则
-
-- 面向新用户的文档优先放在 `docs/start/`。
-- 当前可执行能力放在根 README 和当前治理能力文档中。
-- 历史规划不要混入新手教程，避免用户把旧计划当成当前事实。
-- 如果 CLI 行为变化，必须同步更新 `README.md`、`docs/start/quickstart.md` 和相关 reference 文档。
-- 如果新增 governance pack，必须同时更新 `README.md`、`docs/start/README.md` 和对应测试。
+# SCALE Engine 文档地图
+
+这个目录同时包含用户指南、治理能力说明、架构参考、历史规划和推广素材。新用户应优先阅读入门入口和当前治理能力文档，历史规划仅作为背景材料。
+
+## 新用户入口
+
+| 文档 | 说明 |
+| --- | --- |
+| [start/README.md](start/README.md) | 入门路径总览 |
+| [start/quickstart.md](start/quickstart.md) | 3 分钟快速开始 |
+| [start/agent-governance-demo.md](start/agent-governance-demo.md) | 官方 demo walkthrough |
+| [start/artifact-lifecycle.md](start/artifact-lifecycle.md) | Artifact 生命周期完整 walkthrough |
+| [../README.md](../README.md) | 项目主页和能力总览 |
+
+## 仓库维护入口
+
+| 文档 | 说明 |
+| --- | --- |
+| [guides/GETTING_STARTED.md](guides/GETTING_STARTED.md) | `scale-engine` 仓库维护者的 15 分钟上手路径 |
+| [guides/DEVELOPMENT_WORKFLOW.md](guides/DEVELOPMENT_WORKFLOW.md) | 本仓库日常开发工作流 |
+| [workflow/README.md](workflow/README.md) | 仓库门禁、分支策略和 workflow 命令面 |
+
+## 当前治理能力
+
+| 文档 | 说明 |
+| --- | --- |
+| [RESOURCE_GOVERNANCE.md](RESOURCE_GOVERNANCE.md) | 文档、报告、媒体、脚本、临时产物的生命周期治理 |
+| [ENGINEERING_STANDARDS.md](ENGINEERING_STANDARDS.md) | 日志、安全、ORM、框架、测试、部署等工程规范 |
+| [BACKGROUND_HUNTER.md](BACKGROUND_HUNTER.md) | Background Hunter 只读主动巡检、诊断交接和 ignore baseline |
+| [DEPENDENCY_AUDIT.md](DEPENDENCY_AUDIT.md) | 供应链依赖审计、G7 dependency 子门禁和 dependency policy |
+| [TOOL_ORCHESTRATION.md](TOOL_ORCHESTRATION.md) | skills、MCP、CLI、浏览器、桌面自动化的编排策略 |
+| [RUNTIME_EVIDENCE.md](RUNTIME_EVIDENCE.md) | 会话 ledger、运行时证据和最终交付检查 |
+| [MEMORY_FABRIC.md](MEMORY_FABRIC.md) | Runtime evidence、session events、knowledge recall 和 graph status 的预算化上下文包 |
+| [MEMORY_BRAIN.md](MEMORY_BRAIN.md) | 证据驱动的长期记忆、矛盾检测、dream 整理和 failure replay 沉淀 |
+| [CONTEXT_BUDGET.md](CONTEXT_BUDGET.md) | Context Budget、Progressive Governance、Lazy Loading 和 Governance ROI |
+| [CODE_INTELLIGENCE.md](CODE_INTELLIGENCE.md) | CodeGraph、Graphify 和显式 fallback 的代码智能与探索 ROI |
+| [WORKFLOW_EVAL.md](WORKFLOW_EVAL.md) | Workflow Eval、pass@k 指标、Failure Replay 和改进候选 |
+| [SKILL_RADAR.md](SKILL_RADAR.md) | Skill Radar、能力置信度、证据要求和供应链安全检查 |
+| [THIRD_PARTY_SKILLS.md](THIRD_PARTY_SKILLS.md) | 第三方 skill 致谢、授权边界、引用方式和 vendoring 策略 |
+| [EXTERNAL_REFERENCES.md](EXTERNAL_REFERENCES.md) | 外部项目、skills、MCP、CLI 和适配器引用的完整清单 |
+| [UPGRADE_MANAGEMENT.md](UPGRADE_MANAGEMENT.md) | SCALE CLI、governance pack、skills、MCP 和 CLI 工具的安全升级流程 |
+| [GOVERNANCE_DASHBOARD.md](GOVERNANCE_DASHBOARD.md) | Runtime、eval、memory、resource、HTML artifact 的统一治理面板 |
+| [RELEASE_READINESS.md](RELEASE_READINESS.md) | 发版前质量门槛、官方 demo 和真实项目落地验收 |
+| [DOCUMENT_STANDARDS.md](DOCUMENT_STANDARDS.md) | 文档编写与维护规范 |
+| [GITLAB_FLOW.md](GITLAB_FLOW.md) | GitLab Flow 分支、发版、tag 和临时 worktree 生命周期规范 |
+| [SKILL-REPOSITORY.md](SKILL-REPOSITORY.md) | 受治理 skill repository 和安装安全策略 |
+| [VIBE-TEMPLATES.md](VIBE-TEMPLATES.md) | 可复制的 Vibe Coding 提示词模板 |
+| [LEADERSHIP-PRESETS.md](LEADERSHIP-PRESETS.md) | CEO、CTO、PM、Architect 等内置领导者角色预设 |
+
+## 当前规划与执行蓝图
+
+这些文档描述计划中的架构演进，不代表当前 CLI 已全部实现。进入实现前应按文档中的验收标准和红线逐项拆分任务。
+
+| 文档 | 说明 |
+| --- | --- |
+| [plans/2026-05-20-scale-engine-v2-final-architecture-plan.md](plans/2026-05-20-scale-engine-v2-final-architecture-plan.md) | SCALE Engine V2.0 最终架构落地方案：Prompt Cache、Dashboard 聚合、Background Hunter、供应链门禁、动态/视觉验证和 Evolution Shadow Mode |
+
+## 架构与参考
+
+| 文档 | 说明 |
+| --- | --- |
+| [00-OVERVIEW.md](00-OVERVIEW.md) | 系统概览 |
+| [01-ARCHITECTURE.md](01-ARCHITECTURE.md) | 架构设计 |
+| [02-DATA-MODEL.md](02-DATA-MODEL.md) | 数据模型 |
+| [03-CORE-MODULES.md](03-CORE-MODULES.md) | 核心模块 |
+| [04-INTEGRATION.md](04-INTEGRATION.md) | 平台与集成 |
+| [06-DECISIONS.md](06-DECISIONS.md) | 架构决策记录 |
+
+## 历史规划和过程记录
+
+这些文档是历史上下文，不一定代表当前产品入口：
+
+| 文档 | 说明 |
+| --- | --- |
+| [05-ROADMAP.md](05-ROADMAP.md) | 路线图 |
+| [OPTIMIZATION_PLAN.md](OPTIMIZATION_PLAN.md) | 历史优化计划 |
+| [WEEK1-2-REPORT.md](WEEK1-2-REPORT.md) | 阶段报告 |
+| [TASK_GUARD_SUMMARY.md](TASK_GUARD_SUMMARY.md) | Task Guard 总结 |
+| [TASK_GUARD_WORKFLOW_DEMO.md](TASK_GUARD_WORKFLOW_DEMO.md) | 早期 workflow demo |
+| [plans/2026-05-19-agent-engineering-os-upgrade-plan.md](plans/2026-05-19-agent-engineering-os-upgrade-plan.md) | Agent Engineering OS 升级审核稿：Context Budget、CodeGraph、Memory Brain、Skill Radar、HTML Artifact 和 Eval Harness |
+| [plans/](plans/) | 规划方案和技术方案归档 |
+| [superpowers/](superpowers/) | 外部方法论对照和计划归档 |
+
+## 推广和素材
+
+| 文档 | 说明 |
+| --- | --- |
+| [promote-article-v2.md](promote-article-v2.md) | 推广文章草稿 v2 |
+| [promote-article-v2.html](promote-article-v2.html) | 推广文章 HTML v2 |
+| [promote-article-v3.md](promote-article-v3.md) | 推广文章草稿 v3 |
+| [promote-article-v3.html](promote-article-v3.html) | 推广文章 HTML v3 |
+| [imgs/](imgs/) | 社群二维码和推广图片 |
+
+## 维护规则
+
+- 面向新用户的文档优先放在 `docs/start/`。
+- 面向本仓库维护者的 workflow 文档优先放在 `docs/guides/` 和 `docs/workflow/`。
+- 当前可执行能力放在根 README 和当前治理能力文档中。
+- 历史规划不要混入新手教程，避免用户把旧计划当成当前事实。
+- 如果 CLI 行为变化，必须同步更新 `README.md`、`docs/start/quickstart.md` 和相关 reference 文档。
+- 如果新增 governance pack，必须同时更新 `README.md`、`docs/start/README.md` 和对应测试。

package/docs/RUNTIME_EVIDENCE.md

@@ -1,101 +1,101 @@
-# Runtime Evidence
-
-Runtime Evidence 是 SCALE 用来记录 Agent 实际做过什么的运行时证据层。它的目标很直接：没有真实命令、工具、浏览器、skill 或人工验证证据时，Agent 不能声称任务已经完成。
-
-它和现有证据层的关系：
-
-- Gate evidence：回答 build、lint、test、security、review 等门禁是否通过。
-- Tool evidence：回答必需的 skill、MCP、浏览器、桌面自动化或 CLI 工具是否执行过。
-- Runtime evidence：回答当前会话是否具备可信的最终交付证据。
-
-## 存储位置
-
-Runtime 数据写入 SCALE 已忽略的本地运行时目录：
-
-```text
-.scale/
-├── events/
-│   ├── current-session.json
-│   └── sessions/<session-id>.jsonl
-└── evidence/
-    └── runtime/<evidence-id>.json
-```
-
-这些文件默认是本地运行时产物，不应该提交到 Git。需要长期保留时，应把摘要沉淀到任务 summary、ADR、README 或模块文档中，而不是直接提交原始日志。
-
-## 基本流程
-
-启动会话：
-
-```bash
-scale runtime start \
-  --session-id 2026-05-18-runtime-evidence \
-  --task-id 2026-05-18-runtime-evidence \
-  --level M \
-  --agent codex
-```
-
-在真实命令、门禁、浏览器验证、skill 执行、MCP 调用或人工检查之后记录证据：
-
-```bash
-scale runtime record \
-  --title "build" \
-  --kind command \
-  --status passed \
-  --command "npm run build" \
-  --exit-code 0 \
-  --summary "TypeScript build passed"
-```
-
-检查是否允许最终交付：
-
-```bash
-scale runtime final-check \
-  --task-id 2026-05-18-runtime-evidence \
-  --session-id 2026-05-18-runtime-evidence \
-  --level M
-```
-
-检查运行时健康状态：
-
-```bash
-scale runtime doctor --level M
-scale doctor
-```
-
-## 完成规则
-
-M、L、CRITICAL 任务在最终交付前必须满足：
-
-- 当前 task/session 范围内至少有一条 `passed` runtime evidence。
-- 当前 task/session 范围内不能存在 `failed` runtime evidence。
-
-S 级任务可以保持轻量，但一旦存在失败证据，仍然不能声称完成。
-
-## 脱敏规则
-
-Runtime evidence 复用 tool evidence 的脱敏模型。写入 JSON 前会处理命令、摘要、artifact 路径和 metadata 中的敏感字段：
-
-- password
-- token
-- secret
-- authorization
-- cookie
-- credential
-- api key
-- private key
-
-这样可以保留有用证据，同时避免把 token、cookie、密钥等内容写进运行时文件。
-
-## 推荐使用场景
-
-适合记录 runtime evidence 的场景：
-
-- 最终交付检查。
-- 长会话或多阶段任务。
-- 跨 Agent 或外部 CLI review。
-- 浏览器、桌面自动化、MCP、skill 验证。
-- 发版前 preflight。
-- 需要进入后续学习闭环的失败、修复和重试记录。
-
-不要用 runtime evidence 替代长期维护文档。Runtime evidence 是“操作证明”，PRD、ADR、架构文档、README、模块文档才是长期项目契约。
+# Runtime Evidence
+
+Runtime Evidence 是 SCALE 用来记录 Agent 实际做过什么的运行时证据层。它的目标很直接：没有真实命令、工具、浏览器、skill 或人工验证证据时，Agent 不能声称任务已经完成。
+
+它和现有证据层的关系：
+
+- Gate evidence：回答 build、lint、test、security、review 等门禁是否通过。
+- Tool evidence：回答必需的 skill、MCP、浏览器、桌面自动化或 CLI 工具是否执行过。
+- Runtime evidence：回答当前会话是否具备可信的最终交付证据。
+
+## 存储位置
+
+Runtime 数据写入 SCALE 已忽略的本地运行时目录：
+
+```text
+.scale/
+├── events/
+│   ├── current-session.json
+│   └── sessions/<session-id>.jsonl
+└── evidence/
+    └── runtime/<evidence-id>.json
+```
+
+这些文件默认是本地运行时产物，不应该提交到 Git。需要长期保留时，应把摘要沉淀到任务 summary、ADR、README 或模块文档中，而不是直接提交原始日志。
+
+## 基本流程
+
+启动会话：
+
+```bash
+scale runtime start \
+  --session-id 2026-05-18-runtime-evidence \
+  --task-id 2026-05-18-runtime-evidence \
+  --level M \
+  --agent codex
+```
+
+在真实命令、门禁、浏览器验证、skill 执行、MCP 调用或人工检查之后记录证据：
+
+```bash
+scale runtime record \
+  --title "build" \
+  --kind command \
+  --status passed \
+  --command "npm run build" \
+  --exit-code 0 \
+  --summary "TypeScript build passed"
+```
+
+检查是否允许最终交付：
+
+```bash
+scale runtime final-check \
+  --task-id 2026-05-18-runtime-evidence \
+  --session-id 2026-05-18-runtime-evidence \
+  --level M
+```
+
+检查运行时健康状态：
+
+```bash
+scale runtime doctor --level M
+scale doctor
+```
+
+## 完成规则
+
+M、L、CRITICAL 任务在最终交付前必须满足：
+
+- 当前 task/session 范围内至少有一条 `passed` runtime evidence。
+- 当前 task/session 范围内不能存在 `failed` runtime evidence。
+
+S 级任务可以保持轻量，但一旦存在失败证据，仍然不能声称完成。
+
+## 脱敏规则
+
+Runtime evidence 复用 tool evidence 的脱敏模型。写入 JSON 前会处理命令、摘要、artifact 路径和 metadata 中的敏感字段：
+
+- password
+- token
+- secret
+- authorization
+- cookie
+- credential
+- api key
+- private key
+
+这样可以保留有用证据，同时避免把 token、cookie、密钥等内容写进运行时文件。
+
+## 推荐使用场景
+
+适合记录 runtime evidence 的场景：
+
+- 最终交付检查。
+- 长会话或多阶段任务。
+- 跨 Agent 或外部 CLI review。
+- 浏览器、桌面自动化、MCP、skill 验证。
+- 发版前 preflight。
+- 需要进入后续学习闭环的失败、修复和重试记录。
+
+不要用 runtime evidence 替代长期维护文档。Runtime evidence 是“操作证明”，PRD、ADR、架构文档、README、模块文档才是长期项目契约。

package/docs/SKILL-REPOSITORY.md

@@ -1,57 +1,57 @@
-# SCALE Skill 仓库
-
-这个仓库视图用于让 Agent 按任务渐进式发现、激活和编排 skills/MCP/CLI，而不是一次性把所有能力塞进上下文。
-
-## 渐进式披露
-
-1. 启动时只读取 Skill 元数据和一句话描述。
-2. 任务命中时才读取完整 SKILL.md。
-3. scripts、references、assets 只在明确需要时懒加载。
-
-## 安全安装
-
-- 安装前必须执行安全扫描，阻断 `curl | bash`、`Invoke-Expression`、危险删除和非 HTTPS 来源。
-- npm/npx 来源必须补充 `npm audit signatures`、来源仓库、许可证和版本/commit 固定检查。
-- 任何第三方 Skill 都先进入隔离审查，再写入项目或全局 skills 目录。
-
-## 供应链防护清单
-
-- review-skill-frontmatter
-- inspect-scripts-directory
-- verify-license-and-source
-- verify-attribution-and-notice
-- pin-source-revision
-- npm-audit-signatures
-
-## Skill 目录
-
-| ID | 类别 | 信任 | 主要用途 | 组合建议 |
-| --- | --- | --- | --- | --- |
-| `planning-with-files` | planning | community | Use persistent planning files, progress logs, findings, active-plan selection, and plan attestation for long-running agent work. | memory-brain, web-access, code-reviewer |
-| `agentmemory` | memory | community | Use as an optional external memory provider via REST or MCP when teams want cross-agent persistent memory beyond SCALE local Memory Brain. | memory-brain, mcp-chrome-devtools, codex-cli |
-| `gbrain` | memory | community | Use as an optional graph-backed memory provider for long-running project knowledge, entity relationships, and background memory maintenance. | memory-brain, agentmemory, codegraph |
-| `frontend-design` | ui | official | UI 视觉方向、布局、组件状态和前端实现约束。 | awesome-design-md, ui-ux-pro-max, webapp-testing |
-| `awesome-design-md` | ui | ecosystem | 建立产品级设计规范和视觉语言。 | ui-ux-pro-max, frontend-design |
-| `ui-ux-pro-max` | ui | ecosystem | 补齐体验策略、交互状态和 UI 验收维度。 | awesome-design-md, webapp-testing |
-| `webapp-testing` | testing | official | 验证页面点击、表单、控制台、截图和端到端行为。 | agent-browser, mcp-chrome-devtools |
-| `web-access` | browser | ecosystem | 获取一手资料、动态页面内容、网页证据和来源引用。 | agent-browser, mcp-chrome-devtools |
-| `agent-browser` | browser | ecosystem | 与 Web 页面真实交互，补齐手工验收证据。 | web-access, webapp-testing, mcp-chrome-devtools |
-| `mcp-chrome-devtools` | browser | ecosystem | 调试控制台错误、网络请求、页面状态和性能问题。 | agent-browser, webapp-testing |
-| `cua` | desktop | ecosystem | 操作桌面应用并收集端侧截图、状态和副作用边界证据。 | web-access, agent-browser |
-| `code-reviewer` | review | official | 合并前分级审查缺陷、安全、可维护性和测试风险。 | security-and-hardening, update-docs |
-| `fix` | review | official | 提交前清理格式和 lint 问题。 | code-reviewer |
-| `pr-creator` | review | official | 生成标准 PR 描述和合并前说明。 | code-reviewer, update-docs |
-| `update-docs` | docs | official | 发现并更新受代码变更影响的长期文档。 | documentation-and-adrs |
-| `find-skills` | discovery | ecosystem | 按任务意图搜索合适 Skill，再进入安全扫描。 | web-access |
-| `codex-cli` | agent-cli | official | 外部 CLI 审查和命令级证据。 | gemini-cli, opencode-cli |
-| `gemini-cli` | agent-cli | official | 外部 CLI 审查和命令级证据。 | codex-cli, opencode-cli |
-| `opencode-cli` | agent-cli | ecosystem | 外部 CLI 审查和命令级证据。 | codex-cli, gemini-cli |
-| `agency-agents-zh` | role-library | community | 提供 CEO、CTO、工程、设计、产品等角色预设参考。 | skill-safety-scan |
-
-## Third-Party Attribution
-
-| ID | License | Usage | Notice |
-| --- | --- | --- | --- |
-| `planning-with-files` | MIT | adapted-concept | Inspired by and compatible with OthmanAdi/planning-with-files. SCALE should not copy upstream files unless the MIT license text and attribution are included. |
-| `agentmemory` | Apache-2.0 | external-reference | Optional external integration only. Do not vendor agentmemory code into SCALE without preserving Apache-2.0 license text, modification notices, and any upstream NOTICE obligations. |
-| `gbrain` | MIT | external-reference | Optional external provider only. Do not vendor GBrain code into SCALE without preserving MIT license text, source revision, and modification notices. |
+# SCALE Skill 仓库
+
+这个仓库视图用于让 Agent 按任务渐进式发现、激活和编排 skills/MCP/CLI，而不是一次性把所有能力塞进上下文。
+
+## 渐进式披露
+
+1. 启动时只读取 Skill 元数据和一句话描述。
+2. 任务命中时才读取完整 SKILL.md。
+3. scripts、references、assets 只在明确需要时懒加载。
+
+## 安全安装
+
+- 安装前必须执行安全扫描，阻断 `curl | bash`、`Invoke-Expression`、危险删除和非 HTTPS 来源。
+- npm/npx 来源必须补充 `npm audit signatures`、来源仓库、许可证和版本/commit 固定检查。
+- 任何第三方 Skill 都先进入隔离审查，再写入项目或全局 skills 目录。
+
+## 供应链防护清单
+
+- review-skill-frontmatter
+- inspect-scripts-directory
+- verify-license-and-source
+- verify-attribution-and-notice
+- pin-source-revision
+- npm-audit-signatures
+
+## Skill 目录
+
+| ID | 类别 | 信任 | 主要用途 | 组合建议 |
+| --- | --- | --- | --- | --- |
+| `planning-with-files` | planning | community | Use persistent planning files, progress logs, findings, active-plan selection, and plan attestation for long-running agent work. | memory-brain, web-access, code-reviewer |
+| `agentmemory` | memory | community | Use as an optional external memory provider via REST or MCP when teams want cross-agent persistent memory beyond SCALE local Memory Brain. | memory-brain, mcp-chrome-devtools, codex-cli |
+| `gbrain` | memory | community | Use as an optional graph-backed memory provider for long-running project knowledge, entity relationships, and background memory maintenance. | memory-brain, agentmemory, codegraph |
+| `frontend-design` | ui | official | UI 视觉方向、布局、组件状态和前端实现约束。 | awesome-design-md, ui-ux-pro-max, webapp-testing |
+| `awesome-design-md` | ui | ecosystem | 建立产品级设计规范和视觉语言。 | ui-ux-pro-max, frontend-design |
+| `ui-ux-pro-max` | ui | ecosystem | 补齐体验策略、交互状态和 UI 验收维度。 | awesome-design-md, webapp-testing |
+| `webapp-testing` | testing | official | 验证页面点击、表单、控制台、截图和端到端行为。 | agent-browser, mcp-chrome-devtools |
+| `web-access` | browser | ecosystem | 获取一手资料、动态页面内容、网页证据和来源引用。 | agent-browser, mcp-chrome-devtools |
+| `agent-browser` | browser | ecosystem | 与 Web 页面真实交互，补齐手工验收证据。 | web-access, webapp-testing, mcp-chrome-devtools |
+| `mcp-chrome-devtools` | browser | ecosystem | 调试控制台错误、网络请求、页面状态和性能问题。 | agent-browser, webapp-testing |
+| `cua` | desktop | ecosystem | 操作桌面应用并收集端侧截图、状态和副作用边界证据。 | web-access, agent-browser |
+| `code-reviewer` | review | official | 合并前分级审查缺陷、安全、可维护性和测试风险。 | security-and-hardening, update-docs |
+| `fix` | review | official | 提交前清理格式和 lint 问题。 | code-reviewer |
+| `pr-creator` | review | official | 生成标准 PR 描述和合并前说明。 | code-reviewer, update-docs |
+| `update-docs` | docs | official | 发现并更新受代码变更影响的长期文档。 | documentation-and-adrs |
+| `find-skills` | discovery | ecosystem | 按任务意图搜索合适 Skill，再进入安全扫描。 | web-access |
+| `codex-cli` | agent-cli | official | 外部 CLI 审查和命令级证据。 | gemini-cli, opencode-cli |
+| `gemini-cli` | agent-cli | official | 外部 CLI 审查和命令级证据。 | codex-cli, opencode-cli |
+| `opencode-cli` | agent-cli | ecosystem | 外部 CLI 审查和命令级证据。 | codex-cli, gemini-cli |
+| `agency-agents-zh` | role-library | community | 提供 CEO、CTO、工程、设计、产品等角色预设参考。 | skill-safety-scan |
+
+## Third-Party Attribution
+
+| ID | License | Usage | Notice |
+| --- | --- | --- | --- |
+| `planning-with-files` | MIT | adapted-concept | Inspired by and compatible with OthmanAdi/planning-with-files. SCALE should not copy upstream files unless the MIT license text and attribution are included. |
+| `agentmemory` | Apache-2.0 | external-reference | Optional external integration only. Do not vendor agentmemory code into SCALE without preserving Apache-2.0 license text, modification notices, and any upstream NOTICE obligations. |
+| `gbrain` | MIT | external-reference | Optional external provider only. Do not vendor GBrain code into SCALE without preserving MIT license text, source revision, and modification notices. |