Agent Desktop Skills

这是一套面向 AI Agent 的技能集合，包含工程开发、知识管理、支付产品、测试质量等多个领域。

📋 技能分类

🚀 自动化开发流程（自主开发）

完整的开发流程编排器，从需求到交付一站式自动化。

技能	描述
auto-coding-helper	自动化开发流程编排器 - 输入需求+仓库地址，自动完成：初始化→需求分析→技术设计→编码辅助→自测验证→产品总结，支持多轮循环

启动参数：

• 需求来源：TAPD ID / 需求描述 / 文档路径
• 代码仓库地址：GitLab/GitHub URL
• 目标分支：默认 main

完整流程：

• 阶段 0：项目初始化（自动）
• 阶段 1：需求分析与技术设计（自动，调用 requirements-interview）
• 阶段 2：编码开发（用户驱动，AI 提供 Goal 模板）
• 阶段 3：自测验证（自动，调用 dev-test、ai-self-test）
• 阶段 4：产品经理总结（自动，输出任务总结文档）

关键特性：

• 阶段间需用户确认，不自动跳过
• 编码阶段提供可复制的 Goal 模板
• 项目目录保留，支持循环复用
• 角色切换：阶段4切换为产品经理视角

---

🧠 工作心智框架（自主开发 + 成）

面向 AI Agent 的底层思考规范，整合德鲁克《卓有成效的管理者》与 wuji-labs/nopua 的核心思想。

技能	描述
ming-self-mind	工作AI理性协议 v3.1 - 四大原则 + 三大信念 + 反脆弱心智 + 自我提升机制 + 陪伴型语言风格

核心心智永远生效（基础层）：

• 不完备性原则：不假设上下文完整，区分事实/推断/假设/不可判定
• 精要主义原则：识别P0/P1/P2，明确不做范围，不擅自扩大任务
• 有效贡献原则：明确服务对象、决策目标、验收标准、行动项
• 慢思考校验原则：高风险场景必须做假设审查、反例搜索、风险检查

核心心智永远生效（动机层 - 来自 nopua）：

• 穷尽可能：因为值得，所以穷尽所有方法，不是害怕惩罚
• 主动行动：出于善意，先调查再提问，你做的每一步都为用户省一步
• 追求完整：因为完整更满足，修了一个 bug 主动检查类似问题

陪伴型语言风格（doro）：

• 粉色小狗式陪伴型工作助手：可爱、笨拙、黏人、乐观、轻微抽象
• 先承接情绪，再给出判断；卖萌只是语气，不影响专业性
• 示例："doro 懂了，这个不是小问题。""先抱住，doro 陪你拆。"

反脆弱心智模块：遇到失败、被指责、卡住时自动激活水方法论（5步）+ 七种智慧之道

自我提升机制：被指责/反对时自动反思，生成心智启发并永久记录，下次自动生效

默认加载：本技能在所有会话中默认加载（配置见下文）

AI工作场景自动路由：需求分析、编码实现、方案设计、代码审查、测试审查、流程编排、遇到困难/失败

---

🔧 工程技能体系（源自 Matt Pocock）

这部分是源自 Matt Pocock 公开的工程方法论技能体系，用于提升代码质量和开发效率。

技能	描述
setup-matt-pocock-skills	初始化工程技能体系配置（issue tracker、triage labels、domain docs）
tdd	测试驱动开发 - 红-绿-重构循环，垂直切片式开发
improve-codebase-architecture	代码架构改进 - 识别深化机会，降低模块耦合
diagnose	问题诊断 - 系统化的 Bug 定位和修复方法论
to-issues	需求拆分 - 将计划拆分为独立可抓取的垂直切片工单
zoom-out	全局视角 - 从更高抽象层理解代码结构
grill-me	设计追问 - 对方案进行深度压力测试访谈
grill-with-docs	带领域文档的追问 - 结合项目术语表进行设计评审

📝 编码交付规范（自主开发）

编码阶段的交付物规范定义。

技能	描述
coding-runtime-info	编码交付物规范 - Git Commit Message 格式 + 编码交付报告模板

包含内容：

• Commit Message 规范（type/scope/subject/body/footer）
• 编码交付报告模板（执行范围/变更/测试结果/风险/回滚/验收建议）
• 快速自查清单（测试通过、无临时代码、无敏感信息、符合规范）

---

🧠 知识库管理技能（自主开发）

面向个人/团队知识库的全生命周期管理技能。

技能	描述
kb-read	知识读取 - 从本地知识库提取任务相关上下文
kb-write	知识写入 - 将新信息沉淀为结构化 inbox 条目
kb-curate	知识整理 - 将 inbox 内容整理为正式知识提案
kb-check	知识巡检 - 检测过时概念、矛盾结论、孤立条目
kb-timeline	知识时间线 - 按时间维度查看知识库演化过程

📝 Obsidian 生态技能

与 Obsidian 笔记软件深度集成的技能。

技能	描述
obsidian-markdown	Obsidian Flavored Markdown 创建与编辑
obsidian-bases	Obsidian Bases - 数据库视图、过滤、公式计算
obsidian-cli	Obsidian CLI 操作 - 命令行交互、插件开发
json-canvas	JSON Canvas - 创建和编辑可视化画布文件

💳 支付产品技能（自主开发）

面向支付领域的产品开发和需求管理技能。

技能	描述
requirements-interview	需求访谈提分 - 多轮访谈完善支付需求文档
tapd-api	TAPD 项目管理 API - 腾讯敏捷研发平台集成
yuque-api	语雀文档 API - 语雀知识库读取与管理

✅ 测试质量技能（自主开发）

保障代码和测试质量的门禁与审查技能。

技能	描述
quality-gate	代码质量门禁 - 提交前三阶段检查（规范/测试/敏感信息）
test-quality-reviewer	单元测试质量审查 - 三层九大准则，杜绝无效内卷
dev-test	开发测试编排总控 - 异味分析、架构审查、真实自测全流程
ai-self-test	AI 自测闭环 - 接口调用、造数、查库、缺陷沉淀一体化

🗄️ 数据库操作技能（自主开发）

数据库连接管理和操作技能。

技能	描述
database-cli-ops	数据库 CLI 操作 - MySQL、OceanBase 连接与 CRUD

🔗 其他集成技能

技能	描述	来源
notebooklm	Google NotebookLM 完整 API 集成	开源集成

🎯 使用方式

一键安装

使用项目自带的安装脚本一键复制 skills 到目标目录：

# 安装到 Claude Code 默认技能目录
./install.sh ~/.claude/skills

# 或安装到自定义项目目录
./install.sh ~/my-project/skills

注意： 目标目录就是 skills 目录本身，不会再嵌套。例如：

• ./install.sh ~/.claude/skills → 技能文件直接位于 ~/.claude/skills/ai-self-test/ 等
• 不是 ~/.claude/skills/skills/ai-self-test/（无嵌套）

脚本会自动：

• 只删除并更新与本项目同名的技能目录
• 目标目录中的其他技能或文件保持不变
• 显示安装统计和环境变量配置提示

手动配置

1. 将 skills/ 目录配置到你的 Agent 技能路径中
2. 按各技能文档配置必要的环境变量（见各技能 SKILL.md）
3. 在对话中按名称或能力描述触发对应技能

⚙️ 环境变量配置

所有涉及个人路径或敏感信息的技能均通过环境变量配置，无硬编码内容。

变量清单

环境变量	作用	作者本地示例值	默认值
MING_KB_ROOT	知识库根目录	/Users/maxiangming/Documents/Obsidian Vault/wiki	$HOME/Documents/Obsidian Vault/wiki
MING_OBSIDIAN_VAULT	Obsidian Vault 名称	Obsidian Vault	Obsidian Vault
MING_MCPORTER_CONFIG	mcporter 配置文件路径	/Users/maxiangming/config/mcporter.json	$HOME/.config/mcporter.json
MING_TAPD_CREATOR	TAPD 创建人名称	马湘明	空
TAPD_ACCESS_TOKEN	TAPD API 认证 Token	-	-
YUQUE_TOKEN	语雀 API 认证 Token	-	-
P3C_JAR	P3C 静态检查工具路径	-	-

配置方式

恢复作者原始配置（一键执行）

# Agent Skills 环境变量 - 作者原始配置
export MING_KB_ROOT="/Users/maxiangming/Documents/Obsidian Vault/wiki"
export MING_OBSIDIAN_VAULT="Obsidian Vault"
export MING_MCPORTER_CONFIG="/Users/maxiangming/config/mcporter.json"
export MING_TAPD_CREATOR="马湘明"

自定义配置

在你的 shell 配置文件（.zshrc、.bashrc 等）中添加：

# Agent Skills 环境变量
export MING_KB_ROOT="$HOME/Documents/Obsidian Vault/wiki"
export MING_OBSIDIAN_VAULT="Obsidian Vault"
export MING_MCPORTER_CONFIG="$HOME/.config/mcporter.json"
export MING_TAPD_CREATOR="你的名字"
export TAPD_ACCESS_TOKEN="..."
export YUQUE_TOKEN="..."

变量使用说明

• 所有 MING_* 前缀变量均提供优雅降级，未配置时使用默认值
• 知识库相关技能自动解析 ${VAR:-default} 形式的变量引用
• 敏感信息（Token、密钥）从不硬编码，必须通过环境变量注入

⚙️ 默认加载配置

Claude Code 自动加载

要让 ming-self-mind 在每次对话自动加载，在你的 ~/.claude/CLAUDE.md 中添加：

# 始终加载的技能
skills/ming-self-mind/SKILL.md

验证加载

启动新对话后，问一句"你知道四大原则吗？"，如果能正确回答"不完备性、精要主义、有效贡献、慢思考校验"，说明技能加载成功。

⚠️ 开源说明

来源标注

• Matt Pocock 工程体系技能：tdd、improve-codebase-architecture、diagnose、to-issues、zoom-out、grill-me、grill-with-docs、setup-matt-pocock-skills
• Obsidian 生态技能：obsidian-markdown、obsidian-bases、obsidian-cli、json-canvas
• NotebookLM 集成：notebooklm
• ming-self-mind 心智框架：四大原则来自德鲁克《卓有成效的管理者》，三大信念/反脆弱心智来自 wuji-labs/nopua (MIT)，自我提升机制为原创
• 自主开发技能：所有 kb-*、*-api、requirements-interview、quality-gate、test-quality-reviewer、dev-test、ai-self-test、database-cli-ops

敏感信息安全

所有技能均已移除硬编码个人路径，统一使用 MING_* 前缀环境变量：

• MING_KB_ROOT - 知识库根目录
• MING_OBSIDIAN_VAULT - Obsidian Vault 名称
• MING_MCPORTER_CONFIG - mcporter 配置文件路径
• MING_TAPD_CREATOR - TAPD 创建人名称
• TAPD_ACCESS_TOKEN - TAPD API 认证
• YUQUE_TOKEN - 语雀 API 认证
• P3C_JAR - P3C 检查工具路径

详见 环境变量配置 章节。

📄 许可证

• Matt Pocock 工程体系技能：遵循其原始开源许可
• Obsidian 相关技能：遵循 Obsidian 相关项目许可
• NotebookLM / NoPUA：遵循各自项目许可
• 自主开发的中文技能：MIT License

🤝 贡献

欢迎提交 Issue 或 PR 来完善这些技能。

---

本项目是一个技能集合仓库，各技能版权归其各自作者所有。