Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skill Architect

设计、审查、迭代 AI Skill(技能包)的方法论框架。

当 AI 输出质量不稳时,缺的不是模型智力,而是外置化、可验证、能强制执行的规范。本技能包把这套方法论固化下来,用于指导任何 Skill 的设计与审查。

🖥️ 在线展示页: https://lillltachen.github.io/skill-architect/

核心信念

  • 精简为王:上下文窗口是公共资源,只添加 AI 不知道的信息。
  • 可验证优于描述"140-160 字符,用 wc -c 验证" 才叫规范,"写个合适的长度" 不是。
  • 强制执行:关键项标 BLOCKING,未通过不能进入下一阶段。

适用场景

  • 设计新的 AI Skill(内容生产类优先,方法通用)
  • 审查/迭代现有 Skill:检查其规范是否可读、可验证、可强制执行
  • 搭建内容生产流水线:研究 → 生成 → 质检 → 审核 → 发布
  • 编写规范文档:SEO-GUIDELINES / WRITING-STYLE / QUALITY-CHECKLIST

设计工作流(五步)

  1. 研究规划 — 拆解任务环节,确定 AI/人工分工
  2. 内容生成 — AI 按规范文档产出,人类只在需判断处介入
  3. AI 自动质检 — 运行 BLOCKING 检查
  4. 人工审核 — 事实核实、品牌调性、敏感内容、发布决策
  5. 保存发布 — 更新内链/知识库索引,闭环收尾

目录结构

skill-architect/
├── SKILL.md                    # 入口:导航 + 工作流决策
├── index.html                  # 方法论的图文介绍页(GitHub Pages 在线版)
└── references/
    ├── workflow.md             # 五阶段人机协作工作流
    ├── design-principles.md    # 三大设计原则
    ├── architecture.md         # 渐进式披露架构与命名规范
    ├── quality-gates.md        # BLOCKING 强制质检机制
    ├── spec-docs.md            # 三份规范文档
    └── checklist.md            # 十条方法论自检清单

使用方式(作为 NewMax / Claude Code Skill 安装)

将本仓库克隆或复制到用户 Skill 目录:

# NewMax 用户 Skill 目录
~/.newmax/skills/skill-architect/

# Claude Code 工作区 Skill 目录
.claude/skills/skill-architect/

安装后通过 skill-architect 触发。

设计要点速查

关注点 要点
精简 只加 AI 不知道的信息;示例优于解释
自由度 按任务脆弱性分高/中/低三档
可验证 每条要求必须可测量、可自动检查
架构 SKILL.md ≤500 行当目录,细则拆 references(一层深度)
命名 动名词形式(writing-blog-articles);description 第三人称
强制执行 关键项标 BLOCKING,未过不进下阶段
规范文档 三份:SEO-GUIDELINES / WRITING-STYLE / QUALITY-CHECKLIST
自检 十条方法论检查清单

License

MIT

About

一套教 AI 设计 AI 技能包的方法论:把需求拆清楚、规范写明白、质量把住关,让 AI 产出稳定可控。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages