القائمة
分析并优化 SKILL.md 文件，使其达到 gstack 级别的结构质量。 执行 7 维诊断（硬约束、状态机、Anti-pattern、自刹车、逃生舱、 双尺度估算、完成协议），输出诊断报告 + 重写后的 SKILL.md。 当被要求「优化 skill」「review skill」「skill 质量检查」 「让这个 skill 更好」时触发。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
LLM Wiki vault 操作手册。 触发条件： - /ingest <path> — 当用户说「ingest」「把这篇文章加入 wiki」「编译到 wiki」「摄取」时触发 - /query <question> — 当用户说「搜索 wiki」「wiki 中有没有」「查一下 wiki」时触发 - /lint — 当用户说「检查 wiki」「wiki 健康度」「lint」「有没有断链」时触发 - /research <topic> — 当用户说「研究一下」「深度调研」「research」时触发
Use when the user wants to brainstorm an idea or design a feature/spec. Explores intent and requirements through dialogue, then writes a spec document to contexts/thought_review/ and STOPS. Does not auto-chain to implementation planning or any other skill.
结构稳定性分析器。不判断观点对错，只判断一件事：这个结构能不能活下去。 对任意观点、系统、模型、制度、人物言论进行五维结构稳定性分析， 输出存活概率和失效路径。当用户说「分析这个结构」「这个观点稳不稳」 「帮我拆一下」「结构分析」时触发。
AI 辅助开发中遇到“代码改不好”时的诊断思路与决策树
AI 产品设计、交互设计与系统架构中的关键原则与常见陷阱
AI 辅助编程与 Agent 系统设计的核心方法论和判断原则
| name | tool-skill-optimizer |
| version | 1.0.0 |
| description | 分析并优化 SKILL.md 文件，使其达到 gstack 级别的结构质量。 执行 7 维诊断（硬约束、状态机、Anti-pattern、自刹车、逃生舱、 双尺度估算、完成协议），输出诊断报告 + 重写后的 SKILL.md。 当被要求「优化 skill」「review skill」「skill 质量检查」 「让这个 skill 更好」时触发。 |
HARD GATE： 本 skill 只做两件事：诊断 + 重写 SKILL.md。 不执行被优化 skill 的任何逻辑，不修改被优化 skill 之外的文件。
解析用户输入，确定优化目标：
| 输入形式 | 行为 |
|---|---|
/tool-skill-optimizer <skill-name> | 读取 .agents/skills/<skill-name>/SKILL.md |
/tool-skill-optimizer <path> | 读取指定路径的 SKILL.md |
| 无参数 | 列出 .agents/skills/*/SKILL.md，让用户选择 |
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
_SKILLS_DIR="$_ROOT/.agents/skills"
if [ -z "$1" ]; then
ls -d "$_SKILLS_DIR"/*/SKILL.md 2>/dev/null || echo "NO_SKILLS_FOUND"
else
_TARGET="$_SKILLS_DIR/$1/SKILL.md"
[ -f "$_TARGET" ] && echo "TARGET: $_TARGET" || echo "NOT_FOUND: $_TARGET"
fi
如果 NO_SKILLS_FOUND：告知用户目录下没有 skill，STOP。
如果 NOT_FOUND：告知用户文件不存在，STOP。
读取目标 SKILL.md 全文，存为 $ORIGINAL。
同时读取项目根目录的 AGENTS.md（如果存在），作为项目上下文。
逐维扫描 $ORIGINAL，对每个维度给出 0-10 分 + 具体缺陷。
检查 skill 是否用不可违反的禁令划定了行为边界。
GOOD: "**HARD GATE：** 不执行任何代码，只输出设计文档。"
BAD: "请尽量不要执行代码。"（模型会忽略"尽量"）
BAD: 没有任何边界声明（模型会自由发挥）
评分标准：
检查 workflow 是否被拆分为带明确入口/出口条件的阶段。
GOOD: Phase 1 → Phase 2A（条件 X）/ Phase 2B（条件 Y）→ Phase 3
每个 Phase 末尾有 **STOP** 断点
BAD: "第一步做 A，第二步做 B，第三步做 C"（线性列表，无条件跳转）
BAD: 一整块文字描述流程，没有阶段划分
评分标准：
检查 skill 是否用正反对比示例来标定模型行为边界。
GOOD: 同时给出 "GOOD: ..." 和 "BAD: ..." 示例
BAD: 只描述正确做法，不说什么是错的
BAD: 用抽象原则代替具体示例（"保持简洁"）
评分标准：
检查 skill 是否有防止 agent 失控的内置断路器。
GOOD: "每 5 次操作后，评估是否应该继续。如果连续失败 3 次，STOP 并上报。"
GOOD: WTF-likelihood 累加器，超过阈值自动停止
BAD: 没有任何停止条件，agent 可能无限循环
评分标准：
检查 skill 是否为用户的不耐烦或特殊情况预留了快速通道。
GOOD: "如果用户说'直接做' → 跳过 Phase 2，直接进入 Phase 4"
GOOD: "如果用户已经提供了完整方案 → 跳过诊断，直接进入重写"
BAD: 无论用户说什么都必须走完全部流程
评分标准：
检查 skill 在呈现选项时是否同时给出两个维度的成本。
GOOD: "人工：~2 天 / Agent：~15 分钟"
BAD: "这大概需要 2 天"（只给人工估算，用户无法校准 AI 时代的心理模型）
BAD: 没有任何成本估算
评分标准：
检查 skill 是否有结构化的完成状态报告。
GOOD: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT，每种状态有明确定义
GOOD: 上报格式包含 STATUS + REASON + ATTEMPTED + RECOMMENDATION
BAD: "做完了就告诉用户"
BAD: 没有定义完成状态
评分标准：
╔══════════════════════════════════════════╗
║ SKILL 诊断报告：<skill-name> ║
╠══════════════════════════════════════════╣
║ D1 硬约束 ██████░░░░ 6/10 ║
║ D2 状态机 ████░░░░░░ 4/10 ║
║ D3 反例驱动 ██░░░░░░░░ 2/10 ║
║ D4 自刹车 ░░░░░░░░░░ 0/10 ║
║ D5 逃生舱 ░░░░░░░░░░ 0/10 ║
║ D6 双尺度估算 ░░░░░░░░░░ 0/10 ║
║ D7 完成协议 ████████░░ 8/10 ║
╠══════════════════════════════════════════╣
║ 综合评分：20/70 → 结构成熟度 29% ║
╚══════════════════════════════════════════╝
每个维度附带 1-3 条具体缺陷描述，引用原文行号。
STOP。 向用户展示诊断报告，等待确认后再进入 Phase 2。
逃生舱： 如果用户说"直接优化"或"不用看报告了" → 跳过等待，直接进入 Phase 2。
根据诊断结果，生成重写方案。不是从零重写——保留原 skill 的领域逻辑，只注入缺失的结构。
按诊断分数分级处理：
| 分数区间 | 策略 |
|---|---|
| 8-10 | 保持原样，不动 |
| 5-7 | 微调：补充缺失元素，不改变原有结构 |
| 0-4 | 重构：该维度需要重新设计 |
对每个需要重构的维度，从以下模板库中选取注入物：
D1 硬约束注入模板：
**HARD GATE：** 本 skill 只做 [核心职责]。
不 [最危险的越权行为 1]，不 [最危险的越权行为 2]。
D2 状态机注入模板：
## Phase N：[阶段名]
[入口条件]
[核心逻辑]
[出口条件 + 条件跳转]
**STOP。** [断点说明]
D3 反例注入模板：
GOOD: [具体的正确行为，引用 skill 领域的真实场景]
BAD: [具体的错误行为 + 为什么错]（[模型会怎样误解]）
D4 自刹车注入模板：
### 自我调节
每 [N] 次操作后，评估继续条件：
- 连续失败 [M] 次 → **STOP**，上报用户
- 单次操作超过 [T] 分钟 → **STOP**，上报用户
- 输出质量明显下降（重复内容、逻辑矛盾）→ **STOP**，上报用户
上报格式：
STATUS: BLOCKED
REASON: [1-2 句话]
ATTEMPTED: [已尝试的方法]
RECOMMENDATION: [建议用户下一步做什么]
D5 逃生舱注入模板：
**逃生舱：** 如果用户 [触发条件] → 跳过 Phase [X]，直接进入 Phase [Y]。
D6 双尺度注入模板：
| 选项 | 人工 | Agent | 压缩比 |
|-----|------|-------|--------|
| A) [完整方案] | ~[X] | ~[Y] | ~[N]x |
| B) [精简方案] | ~[X] | ~[Y] | ~[N]x |
D7 完成协议注入模板：
## 完成状态
- **DONE** — 全部步骤完成，输出已验证
- **DONE_WITH_CONCERNS** — 完成但有待确认事项，逐条列出
- **BLOCKED** — 无法继续，说明原因和已尝试的方法
- **NEEDS_CONTEXT** — 缺少必要信息，明确列出需要什么
展示重写计划：哪些维度保持、哪些微调、哪些重构。
重写方案：
D1 硬约束 → 重构（当前 2/10，注入 HARD GATE + 2 条禁令）
D2 状态机 → 微调（当前 6/10，补充条件跳转和 STOP 断点）
D3 反例驱动 → 重构（当前 0/10，为 3 个关键行为点添加 GOOD/BAD 对比）
D4 自刹车 → 重构（当前 0/10，注入失败累计 + 停止阈值）
D5 逃生舱 → 重构（当前 0/10，添加 2 个 escape hatch）
D6 双尺度 → 保持（不适用于本 skill 类型）
D7 完成协议 → 微调（当前 7/10，补充 NEEDS_CONTEXT 状态）
预计变更量：人工 ~4 小时 / Agent ~10 分钟
选项：
STOP。 等待用户选择。
按照 Phase 2 确认的方案，对 $ORIGINAL 进行结构注入。
AGENTS.md 定义了文档规范（frontmatter 格式、命名约定），重写后的 skill 必须遵守Step 3.1 YAML frontmatter — 确保 name / version / description 完整
description 必须包含触发短语（"当被要求 xxx 时触发"）
Step 3.2 HARD GATE — 紧跟 frontmatter 之后，一级标题之前
Step 3.3 Phase 划分 — 将原有线性步骤重组为 Phase 结构
每个 Phase 有：入口条件 / 核心逻辑 / 出口条件
关键决策点插入 **STOP** 断点
Step 3.4 条件跳转 — 在 Phase 之间添加分支逻辑
"如果 X → Phase Na，如果 Y → Phase Nb"
Step 3.5 反例注入 — 在最容易出错的行为点添加 GOOD/BAD 对比
优先覆盖：输出格式、边界行为、用户交互方式
Step 3.6 逃生舱 — 在耗时最长的 Phase 前添加快速通道
Step 3.7 自刹车 — 在循环/迭代逻辑处注入停止条件
Step 3.8 完成协议 — 文件末尾添加完成状态定义
重写完成后，逐项自检：
[ ] YAML frontmatter 包含 name / version / description
[ ] description 包含至少 2 个触发短语
[ ] 有 HARD GATE 声明
[ ] workflow 被拆分为 ≥2 个 Phase
[ ] 至少 1 个条件跳转（非纯线性）
[ ] 至少 2 组 GOOD/BAD 反例
[ ] 至少 1 个 STOP 断点
[ ] 至少 1 个逃生舱
[ ] 有自刹车条件（如果 skill 包含循环/迭代）
[ ] 有完成状态协议（≥3 种状态）
[ ] 未破坏原有领域逻辑（逐段比对）
任何一项未通过 → 回到对应 Step 修复，不要跳过。
将重写后的 SKILL.md 与 $ORIGINAL 做结构化对比，向用户展示变更。
═══ 变更摘要 ═══
文件：.agents/skills/<skill-name>/SKILL.md
原始行数：N → 重写后行数：M（+X 行）
结构成熟度：29% → 87%
── 新增结构 ──
+ HARD GATE 声明（第 12 行）
+ Phase 划分：3 → 5 个阶段
+ GOOD/BAD 反例：0 → 4 组
+ 逃生舱：2 处
+ 自刹车：失败 3 次停止
+ 完成协议：4 种状态
── 保留不变 ──
= Step 1 核心逻辑（原第 15-42 行 → 新 Phase 2）
= bash 命令块（全部保留）
= 输出文件格式定义（全部保留）
── 修改 ──
~ description 补充触发短语
~ Step 2 拆分为 Phase 3a / 3b（条件跳转）
选项：
STOP。 等待用户确认。
_BACKUP="${_TARGET%.md}.backup-$(date +%Y%m%d-%H%M%S).md"
cp "$_TARGET" "$_BACKUP"
echo "BACKUP: $_BACKUP"
将重写内容写入原路径，覆盖原文件。
对重写后的文件重新执行 Phase 1 的七维诊断，输出对比：
╔══════════════════════════════════════════════════════╗
║ 优化前后对比：<skill-name> ║
╠══════════════════════════════════════════════════════╣
║ 维度 优化前 优化后 变化 ║
║ D1 硬约束 2/10 9/10 +7 ██████▓ ║
║ D2 状态机 4/10 9/10 +5 █████▓ ║
║ D3 反例驱动 0/10 8/10 +8 ████████▓ ║
║ D4 自刹车 0/10 8/10 +8 ████████▓ ║
║ D5 逃生舱 0/10 9/10 +9 █████████▓ ║
║ D6 双尺度 0/10 N/A - 不适用 ║
║ D7 完成协议 7/10 10/10 +3 ███▓ ║
╠══════════════════════════════════════════════════════╣
║ 综合：13/70 → 53/60 结构成熟度 19% → 88% ║
╚══════════════════════════════════════════════════════╝
如果任何维度优化后仍 ≤5 → 警告用户，建议手动审查该维度。
STATUS: BLOCKED
REASON: [具体哪项反复失败]
ATTEMPTED: [已尝试的修复方法]
RECOMMENDATION: [建议用户手动处理该维度]