메뉴
框架元资产审查 — 对 .cataforge/ 下的 agents/skills/hooks/rules + workflow 拓扑做内容质量与一致性审查。与 platform-audit 形成内审/外审对偶；与 code-review/doc-review 服务于业务产物不同，本 skill 专审框架自身配置。当用户提到框架腐化、SKILL.md/AGENT.md 质量、agent 引用孤立、SKILL/MANIFEST 漂移、Workflow 完整性、model_tier 合规时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
项目走查 — 在隔离沙盒中以指定执行模式（缺省 standard 全阶段）把一个小型示例项目跑通整条 SDLC 工作流（初始化→核心执行链路→分支→异常→终止清理），逐路径观察各阶段/门禁/降级/恢复的真实行为，产出『框架本身 + 走查流程本身』两类改进建议，并把走查流程自身的改进经自更新协议回灌本 skill 迭代。与 framework-review 形成动静对偶：后者静态审元资产，本 skill 动态端到端自测。当用户想验证一次框架部署是否真能跑通、为非 Claude-Code 平台做行为级冒烟、或自测 workflow-framework-generator 生成的框架时使用。
测试 — 测试策略规划、测试编写与执行、覆盖率分析、缺陷记录。当需要规划测试策略、编写或执行测试套件、分析覆盖率或记录缺陷时使用。本 skill 不改源码（缺陷修复由 debug 负责），单任务 RED/GREEN 单元测试由 tdd-engine 负责，testing 聚焦集成/E2E 与覆盖盲区补充。
代码评审 — 任务粒度评审 (review) 与项目级健康度扫描 (scan) 双入口；代码质量检查、规范合规验证、安全漏洞检测、腐化指标扫描。当任务卡 GREEN 完成 / Sprint 发布前 / 用户要求扫描代码腐化时使用此 skill。审查范围限 src/ 业务代码：文档审查由 doc-review 负责；框架元资产 (.cataforge/) 审查由 framework-review 负责；Sprint 完成度由 sprint-review 负责。
统一上下文 I/O — 按需读取章节/实体、查询追溯关系、生成与写入、门禁校验。文档生命周期的单一入口；后端(知识图谱/文件)由框架按配置方案透明路由,调用方只表达意图。按操作分支见 references/。
功能走查 — 对交付项目的功能实现做验收式动态走查，两层正交判定：①功能是否兑现 spec（missing/drift/bug/pass）；②代码本身是否健康（复用 COMMON-RULES §统一问题分类体系的 code category）。用真实数据路径起真实服务复现，专捞门禁全绿仍漏的跨模块集成缝隙。当项目功能交付后需验收、Sprint 发布前做功能级复核、或用户要求走查某功能域时使用。与 framework-walkthrough 动静对偶：后者在沙盒自测框架 SDLC，本 skill 验收交付项目的功能实现。
CataForge 框架同步 — 把已安装包、.cataforge/ scaffold、IDE 产物、项目初始化四层对齐到当前已验证状态。幂等、升级感知：检测包↔scaffold 版本差异，升级包并刷新 scaffold，部署 IDE 产物，运行 doctor 验证，按版本迁移要点提示升级重点与迁移动作；项目未初始化时进入 Project Bootstrap，已初始化时装配执行环境并交接 start-orchestrator。当用户提到 CataForge 升级、scaffold 过期、框架版本不一致、bootstrap 或刷新项目脚手架、初始化/恢复项目时，使用此 skill。
| name | framework-review |
| description | 框架元资产审查 — 对 .cataforge/ 下的 agents/skills/hooks/rules + workflow 拓扑做内容质量与一致性审查。与 platform-audit 形成内审/外审对偶；与 code-review/doc-review 服务于业务产物不同，本 skill 专审框架自身配置。当用户提到框架腐化、SKILL.md/AGENT.md 质量、agent 引用孤立、SKILL/MANIFEST 漂移、Workflow 完整性、model_tier 合规时使用。 |
| argument-hint | <scope: agents|skills|hooks|rules|workflow|all> [--focus <category[,...]>] [--target <asset_id>] |
| suggested-tools | file_read, file_glob, file_grep, shell_exec |
| depends | ["context"] |
| disable-model-invocation | false |
| user-invocable | true |
.cataforge/ 下的 agents / skills / hooks / rules 元资产；对账 SKILL.md ↔ CHECKS_MANIFEST；交叉引用图完整性；裸常量数值检测；workflow phase × agent × skill 覆盖矩阵；agent model_tier 合规--focus: 限定子检查组（组级 ID B1…B9，逗号分隔；不支持 B1-α 子粒度写法——CLI 只按组匹配，子粒度值会静默匹配不到任何检查）--target <asset_id>: 仅审单个 agent / skill 名（Layer 2 节省 token；Layer 1 仍按 scope 全跑）.cataforge/ 目录（必读）cataforge.runtime.skill.builtins.*.CHECKS_MANIFEST（B3 对账数据源，从已安装的 cataforge 包导入）cataforge.runtime.hook.scripts.* (B6-α/β script 可达性 + ast.parse 数据源)cataforge.core.types.CAPABILITY_IDS / EXTENDED_CAPABILITY_IDS (B6-γ matcher 校验集)framework.json#/constants/AGENT_MODEL_DEFAULTS + AGENT_MODEL_TIER_HEAVY_WHITELIST (B7 数据源)framework.json#/dispatcher_skills (B5-α 区分 skill-as-router vs 未定义 agent)docs/reviews/framework/FRAMEWORK-REVIEW-{scope}-{YYYYMMDD}-r{N}.mdframework-review 是按需触发的元资产审查，不进入业务流程主循环。推荐的合规触发面：
cataforge skill run framework-review -- all（或具体 scope）cataforge skill run framework-review -- all --focus B1,B2,B3,B7，仅 FAIL 时阻塞合并cataforge doctor --deep 可选附带 framework-review 全量cataforge viz framework 渲染编排图，与本 skill 的结构发现对照核验执行: cataforge skill run framework-review -- {scope} [--focus B1,B2,B3,B4,B5,B6,B7,B8,B9]
返回码语义按 §Layer 1 调用协议。各子检查的判定语义与失败级别见 §Layer 1 检查项；scope → 子检查组映射:
| scope | 子检查 |
|---|---|
| agents | B1-α/β, B2-α, B4-α, B7-α/β/γ, B8-α/β/γ |
| skills | B1-α/β, B2-α/β, B3-α/β/γ, B4-α, B8-α/β/γ |
| rules | B1-β, B4-α |
| hooks | B6-α…ε |
| workflow | B5-α…ζ, B9-α/β/γ |
| all | B2, B5, B6, B7, B8, B9 |
--focus 缺省时执行 scope 对应的全部子检查。
通过 context 加载被审资产，按资产类型应用对应维度矩阵。scope=all 时按类型分批送 LLM（先 SKILL 一批、再 AGENT 一批、再 hooks 一批），避免一次性塞入稀释关注度。--target <asset_id> 时仅审单个资产，跳过分批。
| 维度 | category | 检查内容 |
|---|---|---|
| 描述触发性 | ambiguity | description 是否包含触发关键词，足以让 LLM 在正确场景自动调用 |
| 能力边界对称 | completeness | "能做" / "不做" 是否成对、互不重叠 |
| Anti-Patterns 具体性 | convention | 是否使用"做 A 而非 B"格式并附具例（呼应 COMMON-RULES §对比式约束） |
| 同类 skill 重叠 | structure | 是否与已有 skill 职责模糊重叠 |
| 输入/输出契约完整 | completeness | 是否明确输入数据形式与产出路径 |
| 维度 | category | 检查内容 |
|---|---|---|
| Identity ↔ Phase 一致 | structure | Identity 段声明的角色与 orchestrator Phase Routing 中分配给该 agent 的阶段一致 |
| tools / disallowedTools 自洽 | consistency | 不重叠；tools 不含 agent 不该用的能力（如 phase-bound 子代理含 agent_dispatch） |
| allowed_paths 边界合理 | structure | 写入路径限定 agent 职责域（如 reviewer 只允许 docs/reviews/）；无空数组例外不应在非 orchestrator 出现 |
| model_tier 选择合理 | convention | 与任务复杂度匹配；heavy 需在白名单；light 适合机械任务、不适合需要权衡的决策 |
| Anti-Patterns 具体性 | convention | 同 SKILL 维度，但聚焦 agent 行为反模式（不越权、不绕审等） |
| 维度 | category | 检查内容 |
|---|---|---|
| matcher_capability 必要性 | completeness | 每条 hook 都声明 matcher_capability；无 matcher 的全局 hook 仅在 SessionStart/Stop 等无匹配事件下合理 |
| degradation 合理性 | consistency | 每平台 native vs degraded 的判定与该平台的 capability 限制一致（如 codex 无 user_question → detect_correction degraded） |
| script 命名与位置一致 | structure | builtin 在 cataforge.runtime.hook.scripts；custom 在 .cataforge/hooks/custom；命名 snake_case |
维度收敛: --focus <category[,...]> 同上；可与 --target <asset_id> 组合。
报告编号按 .cataforge/references/review-report-spec.md §报告编号规则，前缀 FRAMEWORK-REVIEW-{scope}-{YYYYMMDD}，目录 docs/reviews/framework/。
产出 FRAMEWORK-REVIEW-{scope}-{YYYYMMDD}-r{N}.md，首行必须为 YAML front matter：
---
id: "framework-review-{scope}-{YYYYMMDD}-r{N}"
doc_type: framework-review
author: reviewer
status: draft
deps: []
---
front matter 之后按 .cataforge/references/review-report-spec.md §问题格式 列出问题，可用 category: structure / consistency / convention / completeness / ambiguity / duplication / dead-code（B3 漂移按 consistency；裸数值按 convention；孤立 skill 按 dead-code；model_tier 不当按 convention）。
三态判定按 COMMON-RULES §三态判定逻辑。framework-review 默认不阻塞业务流程（不进 needs_revision 自动重试），仅产出报告供后续元资产维护决策。
权威清单见
cataforge.runtime.skill.builtins.framework_review.CHECKS_MANIFEST。
运行时 cataforge 版本低于 requires 声明时，B3-α 把锚点缺失从 FAIL 降级为 INFO 并提示升级。
agents/<id>/*PROTOCOL*.md 伴生文档 / rules/*.md 四类 prompt-context 文件，与 {INSTRUCTION_FILE} §硬约束 1 对齐skills: + SKILL.md depends: + framework.json features → 引用不存在的 skill/agent FAIL；无任何 AGENT.md 引用的 skill WARN（白名单豁免：基础设施类 skill 如 agent-dispatch / tdd-engine / change-guard / start-orchestrator / context / research / debug / framework-update / workflow-framework-generator / platform-audit / framework-review / framework-issue-resolve / framework-feedback）suggested-tools: → 每个值必须 ∈ CAPABILITY_IDS ∪ EXTENDED_CAPABILITY_IDS（capability_id 规范，由 deploy 翻译为各平台原生工具名；平台原生名如 Read / Bash / Agent 不可移植且绕过注册表）→ FAILCHECKS_MANIFEST 对账。两种识别策略二者必居其一：(1) anchor 模式 — 段内若出现 <!-- check_id: <id> --> HTML 注释锚点，按 ID 双向校验（孤儿锚点 / 缺失锚点 → FAIL）；(2) delegation 模式 — 段内出现 权威清单见 ...CHECKS_MANIFEST 短语，跳过逐条对照（manifest 存在性即契约）。缺该段、或既无锚点又无 delegation 句 → FAIL.cataforge/skills/<skill>/rules/*.yaml plugin 覆写文件按 cataforge.runtime.skill.rules.loader.validate_yaml_text schema 校验（schema_version / rule_type / scope 及其 language/project 字段约束 / 正则可编译 / flags 已知 / e2e backdoor entry 必填 label / 无 extra_validator 的 rule_type 拒绝未知顶层键）→ 不合规 FAIL；comment-only YAML 视为模板跳过（与 loader 语义一致）.cataforge/baselines/*.json 只能由 code-review scan 刷新并与 docs/reviews/code/CODE-SCAN-*.md 报告同变更集提交。两级对账：工作区未提交的基线修改必须伴随未提交的 CODE-SCAN 报告变更；已提交基线的最近一次 touch commit 必须同时变更某个 CODE-SCAN 报告 → 违规 FAIL（封堵改基线绕过复杂度门禁）。非 git 仓库跳过≤3 问 / 300 行 / >200 行），未引用常量名 → WARN（豁免：代码块、版本号、ID 编号）skills: 字段 → 三跳验证（agent 必须 ≥1 skill；引用的 skill 必须存在于 .cataforge/skills/ 或 builtin）docs/EVENT-LOG.jsonl，按 event=agent_return 聚合 → 总 returns ≥ EVENT_LOG_DRIFT_MIN_EVENTS 且 phase-routed agent 0 returns 时 FAIL（强 dead-routing 信号；阈值已替你过滤稀疏数据噪声）；未达阈值时输出一条 INFO（"drift check skipped"）；agent 有 returns 但全部缺 ref 字段 → WARN（output_path 追溯断链）features → 每个非 null phase_guard 必须命中 Phase Routing 已知 phase.cataforge/hooks/hooks.yaml PostToolUse 段，必须有一条 script: validate_agent_result + matcher_capability: agent_dispatch 条目；缺失则 agent_return 事件永远不会写入 EVENT-LOG，B5-γ 会在 0 数据下静默放行 → FAILframework.json#/workflow，每个 interactive: true 的 phase 必须 execution_host: inline，除非当前平台 profile.yaml#/features.subagent_interactive: true（派发子代理可触达用户）；否则 AskUserQuestion 无法触达用户 → FAIL。带 interactive_subagent_ack 显式降级理由时降为 INFOscript 字段须解析到真实 .py（builtin: cataforge.runtime.hook.scripts.<name> 通过 importlib.resources 定位；custom: .cataforge/hooks/custom/<name>.py）→ FAIL on missingast.parse 通过（不依赖 import 副作用）→ FAIL on SyntaxErrormatcher_capability 值必须是 CAPABILITY_IDS ∪ EXTENDED_CAPABILITY_IDS 成员（typo 会让 hook 静默永不触发）→ FAIL on unknown capability.cataforge/platforms/<id>/profile.yaml，hooks.degradation 的 keys 必须严格等于 hooks.yaml 引用的 script name 集合（custom: 前缀脱皮后比较）→ 缺失 WARN（deploy 默认 native 可能掩盖真实降级需求）/ 孤儿 WARN（dead config）custom: 前缀的 script 必须在 cataforge.runtime.hook.manifest.HOOKS_MANIFEST 中注册 → FAIL（manifest 缺失则脚本是 helper 而非 hook target，B6-α 单纯文件存在性查不出来）；HOOKS_MANIFEST 条目未被 hooks.yaml 引用 → WARN（dead inventory）model_tier ∈ {light, standard, heavy, inherit, none}；与 constants.AGENT_MODEL_DEFAULTS 一致（不一致 → WARN）；heavy 需进 constants.AGENT_MODEL_TIER_HEAVY_WHITELIST（不在白名单 → FAIL，控制成本面）model: <id> 字段（无 model_tier:）→ FAIL，必须迁移；deploy 直接丢弃 legacy model: 行（无过渡期）profile.yaml#/model_routing 在 per_agent_model: true 且 user_resolved: false 时，tier_map 必须同时声明 light / standard / heavy 三档；缺哪档则该档 deploy 时静默不写 model: → WARN## Anti-Patterns 段；缺失 WARN（留作 backlog 渐进补齐，不阻塞流程）ANTI_PATTERN_MIN_COUNT_SKILL，agent bullet 数 ≥ ANTI_PATTERN_MIN_COUNT_AGENT；不足 FAIL- 禁止: x）；命中 WARNmigration_checks → 活跃（未废弃）条目: editable 树（src/cataforge/ 存在）下 path 以 src/ 开头却缺失 → WARN（检查对空内容静默放行）；allow_missing 挂在非 file_must_not_contain type 上 → WARN（该 flag 仅此 type 消费）deprecate_after 语义版本 ≤ release_version → WARN（条目发布即废弃，任何已发布版本都不会执行它）deprecate_after）且 path 缺失的条目 → INFO（死条目，建议从 framework.json#/migration_checks 移除；前瞻守卫不自动清理）docs/reviews/doc/ 或 docs/reviews/code/ — 必须写 docs/reviews/framework/，否则会与业务审查报告混淆并污染 reflector 聚合cataforge doctor --deep 可选附带 / CI 守卫显式调用，见 §推荐触发路径）<!-- check_id: ... --> 锚点或 权威清单见 ...CHECKS_MANIFEST delegation 句（B3-α 二者必居其一，否则 FAIL）--target <asset_id> 单文件 Layer 2: 仅审单个 agent / skill 名，节省 token；适合 PR 中只改一个资产时的针对性审查--focus <category[,...]> 进一步收敛: 同 doc-review / code-review 的 Layer 2 收敛策略