yaojingang
792 lines
30 KiB
JSON
792 lines
30 KiB
JSON
{
|
|
"skill_summary": {
|
|
"name": "yao-meta-skill",
|
|
"title": "Yao Meta Skill",
|
|
"display_name": "Yao Meta Skill",
|
|
"description": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
|
|
"maturity": "governed",
|
|
"updated_at": "2026-03-31",
|
|
"core_value": "把一次性经验沉淀为可复用、可评估、可迁移的 Skill 包体。",
|
|
"audience": "Skill 作者、复用团队和后续 reviewer。",
|
|
"deliverables": [
|
|
"SKILL.md",
|
|
"agents/interface.yaml",
|
|
"reports/skill-ir.json",
|
|
"reports/output_quality_scorecard.md",
|
|
"reports/conformance_matrix.md",
|
|
"reports/security_trust_report.md",
|
|
"reports/skill_atlas.html",
|
|
"reports/review-studio.html",
|
|
"reports/skill-overview.html"
|
|
],
|
|
"flow": [
|
|
"输入材料",
|
|
"Skill 包体",
|
|
"可复用能力"
|
|
]
|
|
},
|
|
"scorecard": {
|
|
"completeness_score": {
|
|
"label": "完整度",
|
|
"score": 100,
|
|
"reasons": [
|
|
"SKILL.md 已存在，是 Skill 的入口。",
|
|
"README.md 已存在，便于人工阅读。",
|
|
"agents/interface.yaml 已存在，便于跨平台适配。",
|
|
"manifest.json 已存在，生命周期信息可追踪。",
|
|
"reports/ 已存在，生成证据可以随包体迁移。"
|
|
]
|
|
},
|
|
"trigger_score": {
|
|
"label": "触发清晰",
|
|
"score": 100,
|
|
"reasons": [
|
|
"frontmatter description 已存在，具备基础路由面。",
|
|
"description 有足够长度说明任务边界。",
|
|
"description 已包含使用场景或排除边界信号。",
|
|
"evals/ 已存在，可承载触发样例或质量检查。",
|
|
"intent-confidence 报告已生成，可辅助判断触发稳定性。"
|
|
]
|
|
},
|
|
"evidence_score": {
|
|
"label": "证据充分",
|
|
"score": 100,
|
|
"reasons": [
|
|
"已生成 13 / 13 类报告证据。",
|
|
"skill-ir.json 已存在。",
|
|
"intent-dialogue.json 已存在。",
|
|
"intent-confidence.json 已存在。"
|
|
]
|
|
},
|
|
"maintainability_score": {
|
|
"label": "可维护性",
|
|
"score": 100,
|
|
"reasons": [
|
|
"SKILL.md 约 346 个词/字。",
|
|
"入口文件保持克制，可维护性较好。",
|
|
"references/ 已承载扩展指导。",
|
|
"scripts/ 已承载确定性逻辑。",
|
|
"evals/ 已承载可迁移检查。"
|
|
]
|
|
},
|
|
"portability_score": {
|
|
"label": "可迁移性",
|
|
"score": 100,
|
|
"reasons": [
|
|
"agents/interface.yaml 已存在。",
|
|
"manifest.json 已存在。",
|
|
"目标平台或 adapter target 已声明。",
|
|
"入口文件未发现明显私有绝对路径。"
|
|
]
|
|
},
|
|
"context_cost": {
|
|
"label": "上下文成本",
|
|
"score": 42,
|
|
"reasons": [
|
|
"入口约 346 个词/字，references 约 11313 个词/字。",
|
|
"分数越高代表上下文成本越低。",
|
|
"上下文成本偏高，建议压缩入口或拆分 references。"
|
|
]
|
|
}
|
|
},
|
|
"capability_profile": {
|
|
"archetype": "governed",
|
|
"task_family": "Dialogue interaction",
|
|
"maturity": "governed",
|
|
"trigger_strength": "手动触发 + description 路由",
|
|
"reuse_scope": "跨平台",
|
|
"matrix": {
|
|
"execution_certainty": 72,
|
|
"knowledge_density": 80
|
|
}
|
|
},
|
|
"principle_model": {
|
|
"nodes": [
|
|
{
|
|
"title": "意图澄清",
|
|
"body": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse."
|
|
},
|
|
{
|
|
"title": "边界路由",
|
|
"body": "用 frontmatter description 决定是否触发，并写明相邻非目标。"
|
|
},
|
|
{
|
|
"title": "资产分层",
|
|
"body": "把入口、参考、脚本、评估和报告拆到各自目录，避免 SKILL.md 膨胀。"
|
|
},
|
|
{
|
|
"title": "证据回路",
|
|
"body": "Ask only the highest-leverage clarification before adding package weight."
|
|
},
|
|
{
|
|
"title": "漂移观察",
|
|
"body": "Add near-neighbor exclusions and route evals before expanding workflow steps."
|
|
},
|
|
{
|
|
"title": "杠杆升级",
|
|
"body": "Ask one focused question and update intent context before adding assets."
|
|
}
|
|
],
|
|
"layers": [
|
|
"入口层",
|
|
"参考层",
|
|
"脚本层",
|
|
"评估层",
|
|
"报告层"
|
|
]
|
|
},
|
|
"contract_boundary": {
|
|
"trigger": {
|
|
"description": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
|
|
"activation": "manual",
|
|
"execution": "inline",
|
|
"shell": "bash"
|
|
},
|
|
"inputs": [
|
|
"用户提供的工作流、提示词、文档、记录或散乱笔记",
|
|
"期望沉淀的复用场景、排除项、约束和质量标准"
|
|
],
|
|
"outputs": [
|
|
"可路由的 SKILL.md",
|
|
"agents/interface.yaml 元数据",
|
|
"必要的 references、scripts、evals、reports 证据",
|
|
"结构化 Skill 目录，共 8 类关键资产。"
|
|
],
|
|
"should_trigger": [
|
|
"把重复流程沉淀为可复用的 agent skill。",
|
|
"把分散提示词、对话记录或操作规范整理为稳定能力。",
|
|
"团队复用前，需要明确触发边界、质量证据和维护责任。"
|
|
],
|
|
"should_not_trigger": [
|
|
"只需要一次性回答、没有复用价值的临时请求。",
|
|
"要求直接执行相邻任务，而不是沉淀或使用这个 Skill。",
|
|
"缺少必要事实且用户不允许澄清的场景。"
|
|
],
|
|
"boundary_cards": [
|
|
{
|
|
"label": "Owned",
|
|
"body": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse."
|
|
},
|
|
{
|
|
"label": "Adjacent",
|
|
"body": "相邻任务需要先确认是否应转为独立 Skill。"
|
|
},
|
|
{
|
|
"label": "Excluded",
|
|
"body": "不替代人工事实核查，也不静默扩大职责。"
|
|
}
|
|
]
|
|
},
|
|
"quality_review": {
|
|
"strengths": [
|
|
"触发面保持精简，并锚定在 frontmatter description。",
|
|
"已生成 Skill IR，核心语义可先于平台打包被审查和迁移。",
|
|
"已生成 Output Eval Lab scorecard，可比较 with-skill 与 baseline 输出质量。",
|
|
"已生成 Runtime Conformance Matrix，可审查目标端消费能力。",
|
|
"已生成 Security Trust Report，可审查脚本、依赖、secret 和包完整性风险。",
|
|
"已生成 Skill Atlas，可审查多 Skill 组合中的路由冲突、过期资产和 owner 缺口。"
|
|
],
|
|
"gaps": [
|
|
"上下文成本需要补强：入口约 346 个词/字，references 约 11313 个词/字。"
|
|
],
|
|
"recommendations": [
|
|
"先改触发边界，再扩展工作流。",
|
|
"只把重复且稳定的步骤沉淀为脚本。",
|
|
"每次升级后重新生成报告并检查分数原因。"
|
|
],
|
|
"artifact_design": {
|
|
"design_system": "review studio",
|
|
"highlights": [
|
|
"Execution-focused technical artifact with environment assumptions, copyable commands, expected outputs, and side effects made explicit.",
|
|
"Name the working directory and required inputs for commands.",
|
|
"Mark destructive, networked, or external side-effect operations.",
|
|
"Prefer the smallest runnable snippet over broad framework scaffolding."
|
|
]
|
|
},
|
|
"prompt_quality": {
|
|
"overall_quality_score": 82.0,
|
|
"highlights": [
|
|
"Primary prompt task family: Dialogue interaction.",
|
|
"Complexity: complex — multiple inputs, constraints, or task families require tradeoff handling",
|
|
"Completeness: 80/100.",
|
|
"Clarity: 80/100."
|
|
]
|
|
},
|
|
"system_model": {
|
|
"stability": {
|
|
"score": 86,
|
|
"band": "stable-first-pass"
|
|
},
|
|
"highlights": [
|
|
"Stability: stable-first-pass (86/100).",
|
|
"Owned job: Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
|
|
"Leverage: Clarify the real job boundary — Ask one focused question and update intent context before adding assets.",
|
|
"Leverage: Tune the frontmatter description — Name the recurring job, expected input, output, and strongest non-goal in compact language."
|
|
]
|
|
}
|
|
},
|
|
"risk_governance": {
|
|
"risks": [
|
|
{
|
|
"name": "误触发风险",
|
|
"impact": 3,
|
|
"probability": 1,
|
|
"signal": "frontmatter description 已存在，具备基础路由面。",
|
|
"response": "先补证据和边界，再增加包体复杂度。"
|
|
},
|
|
{
|
|
"name": "输出漂移风险",
|
|
"impact": 2,
|
|
"probability": 1,
|
|
"signal": "已生成 13 / 13 类报告证据。",
|
|
"response": "先补证据和边界，再增加包体复杂度。"
|
|
},
|
|
{
|
|
"name": "证据不足风险",
|
|
"impact": 3,
|
|
"probability": 1,
|
|
"signal": "已生成 13 / 13 类报告证据。",
|
|
"response": "先补证据和边界，再增加包体复杂度。"
|
|
},
|
|
{
|
|
"name": "包体膨胀风险",
|
|
"impact": 2,
|
|
"probability": 1,
|
|
"signal": "SKILL.md 约 346 个词/字。",
|
|
"response": "先补证据和边界，再增加包体复杂度。"
|
|
},
|
|
{
|
|
"name": "跨平台迁移风险",
|
|
"impact": 3,
|
|
"probability": 1,
|
|
"signal": "agents/interface.yaml 已存在。",
|
|
"response": "先补证据和边界，再增加包体复杂度。"
|
|
}
|
|
],
|
|
"risk_families": [
|
|
{
|
|
"key": "markdown_readability",
|
|
"label": "Markdown readability",
|
|
"matched_keywords": [
|
|
"md",
|
|
"report",
|
|
"doc"
|
|
],
|
|
"score": 3,
|
|
"risks": [
|
|
"Tables can render as dense grids with weak hierarchy or poor mobile readability.",
|
|
"Long bullets can make the output look complete while hiding the actual decision logic.",
|
|
"Mixed heading levels can reduce scanability."
|
|
],
|
|
"constraints": [
|
|
"Use tables only when comparison is the main job; otherwise prefer compact cards or grouped bullets.",
|
|
"Keep table cells short and move explanations below the table.",
|
|
"Use heading levels consistently and keep each section anchored to a user-facing outcome."
|
|
],
|
|
"self_repair": [
|
|
"Preview whether each table still reads well when columns are narrow.",
|
|
"Convert any table with paragraph-length cells into bullets or cards."
|
|
]
|
|
},
|
|
{
|
|
"key": "citation_clutter",
|
|
"label": "Citation and footnote clutter",
|
|
"matched_keywords": [
|
|
"source",
|
|
"reference"
|
|
],
|
|
"score": 2,
|
|
"risks": [
|
|
"Footnote markers or dense citation notes can interrupt the reading flow.",
|
|
"Evidence can be over-attached to obvious statements and under-attached to risky claims.",
|
|
"Source notes may become more prominent than the tutorial itself."
|
|
],
|
|
"constraints": [
|
|
"Attach citations only to claims that need evidence, not to every sentence.",
|
|
"Group source notes at the end of a section when inline markers would hurt readability.",
|
|
"Keep the main sentence readable without requiring the reader to chase a footnote."
|
|
],
|
|
"self_repair": [
|
|
"Remove decorative citations that do not support a material claim.",
|
|
"Move repeated source explanations into one compact source note."
|
|
]
|
|
},
|
|
{
|
|
"key": "visual_capture",
|
|
"label": "Screenshot and visual capture",
|
|
"matched_keywords": [
|
|
"capture"
|
|
],
|
|
"score": 1,
|
|
"risks": [
|
|
"Screenshots can be captured from the wrong state, wrong viewport, or wrong crop.",
|
|
"Missing screenshots can cause the skill to invent visual references instead of declaring the gap.",
|
|
"Image descriptions can omit the action-relevant region."
|
|
],
|
|
"constraints": [
|
|
"Never invent a screenshot; state when visual evidence is missing.",
|
|
"Record the source, viewport, and crop intent for any screenshot-dependent output.",
|
|
"Describe what the reader should inspect in the image, not just that an image exists."
|
|
],
|
|
"self_repair": [
|
|
"Check that every screenshot reference points to a real provided or generated asset.",
|
|
"Reword any visual instruction that depends on an unseen screen state."
|
|
]
|
|
},
|
|
{
|
|
"key": "code_or_command_safety",
|
|
"label": "Code and command safety",
|
|
"matched_keywords": [
|
|
"script"
|
|
],
|
|
"score": 1,
|
|
"risks": [
|
|
"Commands can omit environment assumptions, working directory, or rollback notes.",
|
|
"Code snippets can look runnable while missing required inputs.",
|
|
"Error handling can be either absent or over-engineered."
|
|
],
|
|
"constraints": [
|
|
"Name the working directory, required inputs, and expected output for each command.",
|
|
"Mark destructive or external side-effect operations explicitly.",
|
|
"Prefer the smallest runnable snippet over broad framework code."
|
|
],
|
|
"self_repair": [
|
|
"Scan each command for cwd, input, output, and side-effect assumptions.",
|
|
"Remove speculative error handling that is not tied to a real failure mode."
|
|
]
|
|
},
|
|
{
|
|
"key": "tone_and_specificity",
|
|
"label": "Tone and specificity",
|
|
"matched_keywords": [
|
|
"summary"
|
|
],
|
|
"score": 1,
|
|
"risks": [
|
|
"Headings and summaries can drift into generic, interchangeable language.",
|
|
"The output can sound polished but lose the user's actual taste, audience, or scenario.",
|
|
"Strong claims can appear without examples or constraints."
|
|
],
|
|
"constraints": [
|
|
"Anchor titles and summaries in the user's audience, object, and concrete outcome.",
|
|
"Avoid placeholder phrases such as comprehensive guide, ultimate solution, or key insights unless the source demands them.",
|
|
"Preserve one distinctive phrase, constraint, or standard from the user's input."
|
|
],
|
|
"self_repair": [
|
|
"Replace generic title candidates with scenario-specific alternatives.",
|
|
"Delete any polished sentence that could fit almost any project unchanged."
|
|
]
|
|
}
|
|
],
|
|
"human_judgment_boundary": [
|
|
"Ask one focused clarification when the real job, output, or exclusion boundary is unclear.",
|
|
"Escalate visible tradeoffs when benchmark patterns conflict with local privacy, naming, or governance constraints.",
|
|
"Do not silently broaden the skill into adjacent jobs just because the examples are nearby."
|
|
]
|
|
},
|
|
"package_assets": {
|
|
"entries": [
|
|
{
|
|
"path": "SKILL.md",
|
|
"label": "Skill entrypoint",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "README.md",
|
|
"label": "Human-readable usage guide",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "agents/interface.yaml",
|
|
"label": "Neutral interface metadata",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "manifest.json",
|
|
"label": "Lifecycle and portability metadata",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "references",
|
|
"label": "Extended guidance and reusable notes",
|
|
"kind": "folder",
|
|
"file_count": 29
|
|
},
|
|
{
|
|
"path": "scripts",
|
|
"label": "Deterministic helpers or local tooling",
|
|
"kind": "folder",
|
|
"file_count": 50
|
|
},
|
|
{
|
|
"path": "evals",
|
|
"label": "Trigger and quality checks",
|
|
"kind": "folder",
|
|
"file_count": 28
|
|
},
|
|
{
|
|
"path": "reports",
|
|
"label": "Generated evidence and overview artifacts",
|
|
"kind": "folder",
|
|
"file_count": 144
|
|
}
|
|
],
|
|
"file_count": 255,
|
|
"folder_count": 4,
|
|
"distribution": [
|
|
{
|
|
"label": "SKILL.md",
|
|
"value": 1
|
|
},
|
|
{
|
|
"label": "README.md",
|
|
"value": 1
|
|
},
|
|
{
|
|
"label": "agents/interface.yaml",
|
|
"value": 1
|
|
},
|
|
{
|
|
"label": "manifest.json",
|
|
"value": 1
|
|
},
|
|
{
|
|
"label": "references",
|
|
"value": 29
|
|
},
|
|
{
|
|
"label": "scripts",
|
|
"value": 50
|
|
},
|
|
{
|
|
"label": "evals",
|
|
"value": 28
|
|
},
|
|
{
|
|
"label": "reports",
|
|
"value": 144
|
|
}
|
|
]
|
|
},
|
|
"iteration_roadmap": {
|
|
"items": [
|
|
{
|
|
"title": "Borrow one proven pattern on purpose",
|
|
"why": "You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.",
|
|
"actions": [
|
|
"Read the strongest pattern from obra/superpowers.",
|
|
"Decide whether to borrow method, structure, execution, or portability, but only one of them first.",
|
|
"Record what you will not borrow so the package stays light."
|
|
],
|
|
"unlocks": "A cleaner package shape with less accidental over-design."
|
|
},
|
|
{
|
|
"title": "Harden portability semantics",
|
|
"why": "The skill already signals reuse across environments, so contract clarity matters early.",
|
|
"actions": [
|
|
"Confirm activation mode, execution context, and trust assumptions.",
|
|
"Add or review degradation strategy for non-native targets.",
|
|
"Package the skill once to verify adapter expectations."
|
|
],
|
|
"unlocks": "Safer cross-environment reuse with less target drift."
|
|
},
|
|
{
|
|
"title": "Create an iteration evidence loop",
|
|
"why": "The package should show what changed and why after the first draft.",
|
|
"actions": [
|
|
"Generate the HTML skill report and keep it aligned with the package.",
|
|
"Record reference scan choices and non-goals.",
|
|
"Capture the next iteration choice explicitly before adding more files."
|
|
],
|
|
"unlocks": "A clearer path for the next author or reviewer."
|
|
}
|
|
]
|
|
},
|
|
"report_contract": {
|
|
"schema_version": "2.0",
|
|
"html_report": "reports/skill-overview.html",
|
|
"language": "zh-CN",
|
|
"default_language": "zh-CN",
|
|
"languages": [
|
|
"zh-CN",
|
|
"en"
|
|
],
|
|
"layout": "kami-white-audit-v2",
|
|
"nav_labels": [
|
|
"技能概述",
|
|
"总览指标",
|
|
"能力画像",
|
|
"原理结构",
|
|
"契约边界",
|
|
"质量评估",
|
|
"风险治理",
|
|
"包体资产",
|
|
"迭代路线"
|
|
],
|
|
"nav_labels_en": [
|
|
"Overview",
|
|
"Metrics",
|
|
"Profile",
|
|
"Principle",
|
|
"Contract",
|
|
"Quality",
|
|
"Risk",
|
|
"Assets",
|
|
"Roadmap"
|
|
]
|
|
},
|
|
"name": "yao-meta-skill",
|
|
"title": "Yao Meta Skill",
|
|
"display_name": "Yao Meta Skill",
|
|
"description": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
|
|
"logic_steps": [
|
|
"Decide whether the request should become a skill and choose the lightest fit.",
|
|
"Capture job, output, exclusions, constraints, and standards.",
|
|
"Run reference scan: external benchmarks first, user references second, local fit third; surface only uncertainty or conflict.",
|
|
"Write the `description` early and test route quality before expanding the package.",
|
|
"Add output-risk, artifact-design, prompt-quality, and system-model reports only when they matter."
|
|
],
|
|
"usage_steps": [
|
|
"Use $yao-meta-skill to turn my workflow or notes into a reusable skill with lean structure, clear triggering, and the right evals.",
|
|
"Use this skill when the request matches: Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse."
|
|
],
|
|
"package_map": [
|
|
{
|
|
"path": "SKILL.md",
|
|
"label": "Skill entrypoint",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "README.md",
|
|
"label": "Human-readable usage guide",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "agents/interface.yaml",
|
|
"label": "Neutral interface metadata",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "manifest.json",
|
|
"label": "Lifecycle and portability metadata",
|
|
"kind": "file",
|
|
"file_count": 1
|
|
},
|
|
{
|
|
"path": "references",
|
|
"label": "Extended guidance and reusable notes",
|
|
"kind": "folder",
|
|
"file_count": 29
|
|
},
|
|
{
|
|
"path": "scripts",
|
|
"label": "Deterministic helpers or local tooling",
|
|
"kind": "folder",
|
|
"file_count": 50
|
|
},
|
|
{
|
|
"path": "evals",
|
|
"label": "Trigger and quality checks",
|
|
"kind": "folder",
|
|
"file_count": 28
|
|
},
|
|
{
|
|
"path": "reports",
|
|
"label": "Generated evidence and overview artifacts",
|
|
"kind": "folder",
|
|
"file_count": 144
|
|
}
|
|
],
|
|
"strengths": [
|
|
"触发面保持精简，并锚定在 frontmatter description。",
|
|
"已生成 Skill IR，核心语义可先于平台打包被审查和迁移。",
|
|
"已生成 Output Eval Lab scorecard，可比较 with-skill 与 baseline 输出质量。",
|
|
"已生成 Runtime Conformance Matrix，可审查目标端消费能力。",
|
|
"已生成 Security Trust Report，可审查脚本、依赖、secret 和包完整性风险。",
|
|
"已生成 Skill Atlas，可审查多 Skill 组合中的路由冲突、过期资产和 owner 缺口。"
|
|
],
|
|
"scenarios": [
|
|
"把重复流程沉淀为可复用的 agent skill。",
|
|
"把分散提示词、对话记录或操作规范整理为稳定能力。",
|
|
"团队复用前，需要明确触发边界、质量证据和维护责任。",
|
|
"用户说出类似需求时：Use $yao-meta-skill to turn my workflow or notes into a reusable skill with lean structure, clear triggering, and the right evals."
|
|
],
|
|
"trigger_contract": {
|
|
"description": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
|
|
"activation": "manual",
|
|
"execution": "inline",
|
|
"shell": "bash"
|
|
},
|
|
"io_contract": {
|
|
"inputs": [
|
|
"用户提供的工作流、提示词、文档、记录或散乱笔记",
|
|
"期望沉淀的复用场景、排除项、约束和质量标准"
|
|
],
|
|
"outputs": [
|
|
"可路由的 SKILL.md",
|
|
"agents/interface.yaml 元数据",
|
|
"必要的 references、scripts、evals、reports 证据",
|
|
"结构化 Skill 目录，共 8 类关键资产。"
|
|
]
|
|
},
|
|
"principles": [
|
|
{
|
|
"title": "意图澄清",
|
|
"body": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse."
|
|
},
|
|
{
|
|
"title": "边界路由",
|
|
"body": "用 frontmatter description 决定是否触发，并写明相邻非目标。"
|
|
},
|
|
{
|
|
"title": "资产分层",
|
|
"body": "把入口、参考、脚本、评估和报告拆到各自目录，避免 SKILL.md 膨胀。"
|
|
},
|
|
{
|
|
"title": "证据回路",
|
|
"body": "Ask only the highest-leverage clarification before adding package weight."
|
|
},
|
|
{
|
|
"title": "漂移观察",
|
|
"body": "Add near-neighbor exclusions and route evals before expanding workflow steps."
|
|
},
|
|
{
|
|
"title": "杠杆升级",
|
|
"body": "Ask one focused question and update intent context before adding assets."
|
|
}
|
|
],
|
|
"roadmap": [
|
|
{
|
|
"title": "Borrow one proven pattern on purpose",
|
|
"why": "You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.",
|
|
"actions": [
|
|
"Read the strongest pattern from obra/superpowers.",
|
|
"Decide whether to borrow method, structure, execution, or portability, but only one of them first.",
|
|
"Record what you will not borrow so the package stays light."
|
|
],
|
|
"unlocks": "A cleaner package shape with less accidental over-design."
|
|
},
|
|
{
|
|
"title": "Harden portability semantics",
|
|
"why": "The skill already signals reuse across environments, so contract clarity matters early.",
|
|
"actions": [
|
|
"Confirm activation mode, execution context, and trust assumptions.",
|
|
"Add or review degradation strategy for non-native targets.",
|
|
"Package the skill once to verify adapter expectations."
|
|
],
|
|
"unlocks": "Safer cross-environment reuse with less target drift."
|
|
},
|
|
{
|
|
"title": "Create an iteration evidence loop",
|
|
"why": "The package should show what changed and why after the first draft.",
|
|
"actions": [
|
|
"Generate the HTML skill report and keep it aligned with the package.",
|
|
"Record reference scan choices and non-goals.",
|
|
"Capture the next iteration choice explicitly before adding more files."
|
|
],
|
|
"unlocks": "A clearer path for the next author or reviewer."
|
|
}
|
|
],
|
|
"cards": [],
|
|
"introduction": [
|
|
"这份报告用于快速理解新生成 Skill 的定位、原理、触发边界和交付内容。",
|
|
"先确认重复任务、真实输入形态和可交付输出，再决定是否继续加 references、scripts 或 evals。",
|
|
"如果需求仍然模糊，优先回到 intent dialogue 收紧边界，再扩展包体结构。"
|
|
],
|
|
"benchmark_highlights": [],
|
|
"skill_ir": {
|
|
"schema_version": "2.0.0",
|
|
"target_count": 4,
|
|
"trigger_samples": 8,
|
|
"output_eval_cases": 3
|
|
},
|
|
"output_quality": {
|
|
"case_count": 5,
|
|
"file_backed_case_count": 1,
|
|
"near_neighbor_case_count": 1,
|
|
"boundary_case_count": 1,
|
|
"baseline_pass_rate": 0.0,
|
|
"with_skill_pass_rate": 100.0,
|
|
"delta": 100.0,
|
|
"regression_count": 0,
|
|
"gate_pass": true,
|
|
"failure_taxonomy": []
|
|
},
|
|
"runtime_conformance": {
|
|
"target_count": 5,
|
|
"pass_count": 5,
|
|
"fail_count": 0
|
|
},
|
|
"trust_security": {
|
|
"scanned_files": 127,
|
|
"script_count": 50,
|
|
"secret_findings": 0,
|
|
"dependency_files": [
|
|
"requirements-ci.txt"
|
|
],
|
|
"network_script_count": 2,
|
|
"interactive_script_count": 0,
|
|
"package_sha256": "18618ecee3683f7488ae4a65a9800c428ee15c6539bbcd367910c57d84ac77ad"
|
|
},
|
|
"skill_atlas": {
|
|
"skill_count": 12,
|
|
"route_collision_count": 5,
|
|
"owner_gap_count": 9,
|
|
"stale_count": 10,
|
|
"shared_resource_count": 0,
|
|
"no_route_opportunity_count": 0
|
|
},
|
|
"synthesis_highlights": [
|
|
"Borrow a first-time operator flow that explains itself before it asks for more structure.",
|
|
"Borrow a small hypothesis-test-learn loop so the first revision is evidence-backed.",
|
|
"Borrow the discipline of defining what the skill should not own before growing the package."
|
|
],
|
|
"artifact_design": {
|
|
"design_system": "review studio",
|
|
"highlights": [
|
|
"Execution-focused technical artifact with environment assumptions, copyable commands, expected outputs, and side effects made explicit.",
|
|
"Name the working directory and required inputs for commands.",
|
|
"Mark destructive, networked, or external side-effect operations.",
|
|
"Prefer the smallest runnable snippet over broad framework scaffolding."
|
|
]
|
|
},
|
|
"prompt_quality": {
|
|
"overall_quality_score": 82.0,
|
|
"highlights": [
|
|
"Primary prompt task family: Dialogue interaction.",
|
|
"Complexity: complex — multiple inputs, constraints, or task families require tradeoff handling",
|
|
"Completeness: 80/100.",
|
|
"Clarity: 80/100."
|
|
]
|
|
},
|
|
"system_model": {
|
|
"stability": {
|
|
"score": 86,
|
|
"band": "stable-first-pass"
|
|
},
|
|
"highlights": [
|
|
"Stability: stable-first-pass (86/100).",
|
|
"Owned job: Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
|
|
"Leverage: Clarify the real job boundary — Ask one focused question and update intent context before adding assets.",
|
|
"Leverage: Tune the frontmatter description — Name the recurring job, expected input, output, and strongest non-goal in compact language."
|
|
]
|
|
},
|
|
"metadata": {
|
|
"canonical_format": "agent-skills",
|
|
"targets": [
|
|
"openai",
|
|
"claude",
|
|
"generic"
|
|
],
|
|
"maturity_tier": "governed",
|
|
"skill_archetype": "governed",
|
|
"updated_at": "2026-03-31"
|
|
}
|
|
} |