MyWorkflow

AI 辅助开发全流程技能包 —— 为 Claude Code 提供从需求理解到代码交付的完整工作流。

当前版本：v4.0.0（扁平化 + 阶段感知锚点 + 专项注册表）

设计理念

MyWorkflow 将 AI 辅助开发拆解为 22 个自包含技能，采用 扁平化架构 + 阶段感知锚点：技能直接按 description 自动触发，无分类仪式、无路由 hop、无强制澄清链；SessionStart 注入"存在 5 类任务"的认知 + 开发阶段→skill 链（阶段3 遇 bug→root-cause、阶段4→real-world-verify、提交→github-collab 等），并指引疑似专项任务查询注册表。

v3/v4 系列针对模型更换后的实际使用痛点做了系统性瘦身与重构：

架构

用户请求 ──→ 直接匹配技能 description（分类概念由 hook 提供）
                 │
    ┌────────────┼─────────────┐
    ▼            ▼             ▼
 编程开发      调研/文稿      任务编排
 (7 skills)   (4 skills)     (6 skills)   +  电脑专项(2) + 行为准则/辅助(3)
    │            │             │
    └────────────┴─────────────┘
      疑似专项 → 查 config/special-skills.json → 调用对应 skill
          Skill 互相引用（myworkflow: 前缀）

22 个技能

安装

前提

自制插件通过 installed_plugins.json 注册 + settings.json 的 enabledPlugins 启用（@local scope）。无需 ~/.claude/skills/ 下的 symlink 或 junction。

步骤

1. 确保 ~/.claude/plugins/myworkflow/ 存在（本仓库即插件本体）。
2. 在 installed_plugins.json 中注册：

   "myworkflow@local": [{
     "scope": "user",
     "installPath": "C:\\Users\\Lenovo\\.claude\\plugins\\myworkflow",
     "version": "3.1.0"
   }]
   

3. 在 ~/.claude/settings.json 的 enabledPlugins 中启用：

   "myworkflow@local": true
   

4. Hook 自动生效：插件启用后，hooks/hooks.json 的 SessionStart hook 自动注册，无需手工合并到 settings.json。

验证安装

启动新的 Claude Code 会话，技能列表中应出现全部 22 个 myworkflow:* 技能；SessionStart 时注入分类概念锚点：

直接按用户请求调用匹配的 Skill 完成工作；没有匹配的 skill 就自己完成。最多澄清 1 个关键问题。任务分 5 类：代码编写 / 文稿撰写 / 深度调研 / 专项任务 / 简单问答。疑似专项任务时，查 myworkflow 插件的 config/special-skills.json 找对应 skill。

工作流

会话启动
  │
  ▼
SessionStart Hook（~200 字）── 分类概念锚点 + 注册表自动刷新
  │                              （子智能体上下文 → 一行协议锚点）
  ▼
收到用户请求
  │
  ▼
技能 description 自动匹配 ──→ 命中 → 调用对应 skill
                         └─→ 疑似专项 → 查 config/special-skills.json
  │
  ▼
复杂任务 → task-dispatch 拆解派发 → subagent-protocol → integration-verify
编程任务 → real-world-verify 真实验证（强制门禁，禁止仅跑单测）
发现 bug → root-cause-analysis 定位 → 修复 → 真实验证

核心设计决策

目录结构

myworkflow/
  plugin.json                  # marketplace 发布清单（v4.0.0）
  .claude-plugin/plugin.json   # 运行时发现元数据（v4.0.0）
  README.md
  PROGRESS.md                  # 完整开发进度
  PROGRESS-LITE.md             # 进度速查
  hooks/
    hooks.json                 # 仅 SessionStart（startup + clear|compact，timeout 15s）
    session-init.sh            # 分类概念锚点 + 注册表刷新；子智能体注入协议锚点
    registry-scan.sh           # 专项注册表扫描生成器（幂等，~1s）
  config/
    special-skills.json        # 专项注册表（categories 人工 + inventory 自动）
  skills/                      # 22 个技能，每技能一个 SKILL.md
    task-router/               # 任务分类入口（极简速查）
    agent-dev-loop/            # 智能体闭环开发（含 bug 修复路径）
      references/testing-anti-patterns.md
    registry-maintain/         # 专项注册表维护
    root-cause-analysis/       # 根因定位与全面排查
      references/condition-based-waiting.md
      references/defense-in-depth.md
    real-world-verify/         # 真实验证（强制门禁）
    project-init/              # 大项目初始化
    project-maintain/          # 大项目工作维护
    github-collab/             # Github协作
    deep-research/             # 深度调研
    humanizer-zh/              # 中文 AI 痕迹清除
    pdf-to-markdown/           # 扫描 PDF → Markdown/LaTeX
    self-study-guide/          # STEM 学习讲义
    task-dispatch/             # 任务拆解与派发
    lightweight-dispatch/      # 轻量级派发
    subagent-protocol/         # 子智能体执行协议
    integration-verify/        # 集成验证与修正
    req-clarify/               # 需求澄清
    storage-analyzer/          # 电脑清理（卡兹克适配，含 scripts/ 与 references/）
    file-organize/             # 电脑整理
    anti-sycophancy/           # 反谄媚
    lessismore/                # 少即是多（行为准则）
    skill-authoring/           # 辅助写技能
      references/persuasion-principles.md
  docs/
    my-architecture.md         # 原始设计想法
    refined-architecture.md    # 细化方案 v2
    architecture-topology.md   # 技能连接拓扑（维护用）

架构拓扑

技能之间的连接结构（DAG 分层、编排铁三角、验证门禁、外部插件挂接）见 docs/architecture-topology.md —— 内含可渲染的 Mermaid 图与维护边表。改动任何技能引用后请同步该文件。

技术细节

• Hook：单一 SessionStart 事件，在 startup 和 clear|compact 时触发，timeout 15s。
• 注入机制：session-init.sh 主智能体注入 ~200 字分类概念锚点 + 触发注册表刷新；子智能体环境（CLAUDE_AGENT_TASK_ID/AGENT_MODE/SUBAGENT）注入一行协议锚点。
• 专项注册表：registry-scan.sh 每次 SessionStart 自动刷新 config/special-skills.json 的 inventory（自动扫描，保真）；categories 由 registry-maintain skill 人工维护。
• 技能格式：每个技能为独立目录，含 SKILL.md（YAML frontmatter + Markdown 正文），frontmatter 无 BOM。
• 发现机制：installed_plugins.json + enabledPlugins@local，不依赖 ~/.claude/skills/ symlink/junction。
• 跨 skill 引用：统一 myworkflow: 前缀（如 Skill("myworkflow:task-dispatch")）。
• 平台：Windows（Git Bash / PowerShell 双版本命令）+ macOS / Linux。

开发理念

• 闭环优于速度：宁可多花 30% 时间一次做对，不要花 300% 时间反复修补
• 描述即触发：技能的 description 字段只写触发条件，不写内部流程
• 篇幅服务方法质量：低确定性任务短而精（给方法框架），高确定性操作详细（步骤可复制）
• 审计驱动迭代：每次大改后派子智能体并行审计，清零 P0/P1/P2 方止
• YAGNI：每个方案生成时主动删减不必要功能
• 真实验证 > 单元测试：代码写完必须以真实用户身份使用并观察行为

License

MIT