设计、审查、迭代 AI Skill(技能包)的方法论框架。
当 AI 输出质量不稳时,缺的不是模型智力,而是外置化、可验证、能强制执行的规范。本技能包把这套方法论固化下来,用于指导任何 Skill 的设计与审查。
- 精简为王:上下文窗口是公共资源,只添加 AI 不知道的信息。
- 可验证优于描述:
"140-160 字符,用 wc -c 验证"才叫规范,"写个合适的长度"不是。 - 强制执行:关键项标 BLOCKING,未通过不能进入下一阶段。
- 设计新的 AI Skill(内容生产类优先,方法通用)
- 审查/迭代现有 Skill:检查其规范是否可读、可验证、可强制执行
- 搭建内容生产流水线:研究 → 生成 → 质检 → 审核 → 发布
- 编写规范文档:SEO-GUIDELINES / WRITING-STYLE / QUALITY-CHECKLIST
- 研究规划 — 拆解任务环节,确定 AI/人工分工
- 内容生成 — AI 按规范文档产出,人类只在需判断处介入
- AI 自动质检 — 运行 BLOCKING 检查
- 人工审核 — 事实核实、品牌调性、敏感内容、发布决策
- 保存发布 — 更新内链/知识库索引,闭环收尾
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 # 十条方法论自检清单
将本仓库克隆或复制到用户 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 |
| 自检 | 十条方法论检查清单 |
MIT