# Silas Fu Agent Skills Catalogue (Markdown Twin)

Install all skills in one command:
```bash
npx skills@latest add SilasFu/Author-Skills
```

## Complete Skills Specification List

### /project-guard — Project Guard (工程守护与规则自愈)
- **Stage**: 04 (04 架构治理与体检)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=project-guard`
- **What it does**: 自动扫描全仓文件行数与模块划分，执行编译器 0 报错体检，并在纠偏时自动演进 AGENTS.md 契约与全局禁忌。
- **When to use**:
  - 初始化新项目时建立硬性门禁
  - 重构或代码膨胀接近200行时垂直切片
  - 用户纠正AI行为时自动沉淀经验
- **Deliverables / Paper Trail**:
  - AGENTS.md (更新工程契约与禁忌)
  - docs/DESIGN.md (对齐视觉规范)

### /grill-with-docs — Grill With Docs (架构深度追问与决策落盘)
- **Stage**: 02 (02 规划与决策塑形)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=grill-with-docs`
- **What it does**: 多轮深入访谈需求边界与技术权衡，每当决策达成共识时，自动向 docs/adr/ 写入标准 ADR 架构决策记录。
- **When to use**:
  - 启动全新业务模块或重构核心组件前
  - 技术选型出现多方案摇摆时
  - 多人协作需要锁定决策依据时
- **Deliverables / Paper Trail**:
  - docs/adr/ADR-*.md (架构决策记录)
  - CONTEXT.md (领域词汇表)

### /tdd — TDD (测试驱动开发与红绿循环)
- **Stage**: 03 (03 确定性实现)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=tdd`
- **What it does**: 引导 Agent 先编写失败的单测用例，再以最小代价编写业务代码使测试通过，最后在绿灯保护下执行无损重构。
- **When to use**:
  - 实现复杂业务逻辑或核心算法时
  - 修复已知 Bug 时先写复现单测
  - 重构关键基础库保证向后兼容
- **Deliverables / Paper Trail**:
  - tests/**/*.test.ts (测试用例集)
  - src/** (受测实现代码)

### /brandkit — Brandkit (品牌视觉系统与资产锁定)
- **Stage**: 05 (05 视觉与发布交付)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=brandkit`
- **What it does**: 校验并应用 Canvas/Paper/Ink 色阶、Geist 等宽字体排版与 1px 微发丝线，防止卡片嵌套与野 Hex 颜色。
- **When to use**:
  - 构建新页面或重绘 UI 组件时
  - 排查视觉漂移与卡片嵌套违规
  - 统一全站设计 Token 与导出规范
- **Deliverables / Paper Trail**:
  - docs/DESIGN.md (设计规范文档)
  - app/globals.css (CSS Design Tokens)

### /to-spec — To Spec (需求结构化规格书转换)
- **Stage**: 02 (02 规划与决策塑形)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=to-spec`
- **What it does**: 提炼用户旅程、核心功能规格矩阵、非目标边界与验收门禁，输出出版物级 Markdown 规格书。
- **When to use**:
  - 追问讨论结束后进入开发前
  - 向团队或 Agent 明确交付边界时
- **Deliverables / Paper Trail**:
  - docs/PRD.md (产品需求文档)
  - docs/SPEC.md (技术规格文档)

### /my-memories — My Memories (权威记忆库检索与切片)
- **Stage**: 01 (01 上下文与记忆)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=my-memories`
- **What it does**: 通过脚本切片检索权威记忆库，遵循置信度阶梯裁决，输出脱敏健康的工程上下文。
- **When to use**:
  - 新会话冷启动时注入个人工程偏好
  - 检查跨项目协作边界与命令红线
- **Deliverables / Paper Trail**:
  - 安全与完整性健康卡片 (审计输出)

### /code-review — Code Review (严苛标准代码审查)
- **Stage**: 04 (04 架构治理与体检)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=code-review`
- **What it does**: 逐行检查单文件长度、类型安全、野样式残留与潜在性能隐患，输出带修复建议的 Review 报告。
- **When to use**:
  - 提交 Pull Request 或部署上线前
  - 多 Agent 协同交接代码前
- **Deliverables / Paper Trail**:
  - Review 报告与待办待改项 (Todo List)

### /visual-gov — Visual Publishing Governance (多模态视觉发布治理)
- **Stage**: 05 (05 视觉与发布交付)
- **Install**: `npx skills@latest add SilasFu/Author-Skills --skill=visual-publishing-governance`
- **What it does**: 依据预设版式或参考图，精准生成出版物级多模态宣发图文，并校验文字事实与视觉无漂移。
- **When to use**:
  - 发布技术博客需要生成推文长卡时
  - 产品上线需要生成社交媒体头图时
- **Deliverables / Paper Trail**:
  - public/covers/*.png
  - 发布图文资产包