| name | personal-workspace-bootstrap |
| version | 3.0 |
| status | active |
| summary | 初始化或改造 Markdown-first 个人工作台，按角色适配目录与上下文，建立实例→playbook→skill 的长期资产升级机制。0 依赖，自包含。 |
| description | Initializes or retrofits a markdown-first personal workbench for AI-assisted work management. Adapts to different roles (engineer, manager, creator, general) by selecting relevant directories and context templates. Use when a user wants to set up a repository for daily thinking, design, troubleshooting, decisions, meetings, and long-term knowledge accumulation in Obsidian-compatible markdown. Zero external dependencies — this single skill directory contains everything needed. Trigger phrases include 初始化个人工作台, 搭个人工作系统, 个人工作管理仓库, markdown 工作台, Obsidian 工作流, bootstrap my workspace, create a personal AI-assisted workspace. |
Personal Workspace Bootstrap
Overview
将一个空仓库或已有仓库，初始化为"面向 Obsidian + AI 的个人工作台"。
这不是复制某个固定模板，而是建立一套轻量核心 + 按需模块的适应性架构。核心只有一件事：把日常工作变成可升级的长期资产。
自包含承诺：本 skill 不依赖环境中的任何其他 skill、脚本或外部工具。只要有本目录，就能从零产出完整的工作台。
两种初始化方式
方式 1：AI 辅助初始化（推荐）
在 AI 工具中触发本 skill，按 Workflow 交互式引导完成。适合想要定制化配置的场景。
方式 2：脚本一键初始化
不依赖 AI 工具，直接命令行执行：
python3 scripts/bootstrap.py /path/to/workspace --role engineer --tool claude --tool codebuddy
支持的角色：engineer、manager、creator、general（默认）。
支持的工具：claude、codebuddy、workbuddy、copilot、cursor、windsurf。
脚本是幂等的：已有文件默认不会被覆盖；bootstrap.md、index/dashboard.md 和 skills/README.md 的生成 section 会在增量装配时做最小同步。
说明：
- 不传
--tool 时，脚本只负责补骨架
- 传入一个或多个
--tool 时，脚本会额外创建入口文件与运行时 symlink
- 如果请求接入的入口文件已存在但目标不对，脚本会显式报冲突并以非零状态退出，不会假装接入成功
- 脚本不会自动迁移已有 Markdown；已有仓库改造优先走 AI 辅助模式
- 多次运行是增量叠加，不会自动卸载此前角色带来的目录、starter skill 或运行时链接
三层资产模型
无论你的角色是什么，工作台都由三层组成：
实例层（Working Memory） ← 当前正在处理的具体事务
↓ 提炼
沉淀层（Reusable Assets） ← 从实例中总结出的可复用方法
↓ 自动化
能力层（Automated Skills） ← 把稳定流程封装成 AI 可执行的 Skill
资产升级规则（不变）：
- 第一次出现 → 写成实例（
tech/、issue/、question/ 等）
- 第二次复用 → 提炼为
playbook/ 或 templates/
- 第三次且流程稳定 → 升级为
skills/
角色
初始化时，先判断用户的主要角色，再决定启用哪些模块。
| 角色 | 典型工作 | 推荐重点模块 |
|---|
| Engineer | 写代码、做设计、排查 Bug、学习新技术 | tech/, issue/, projects/, playbook/ |
| Manager | 开会、做决策、跟进客户、带团队 | meeting/, decision/, customers/, review/ |
| Creator | 写作、研究、内容生产 | drafts/, research/, ideas/ |
| General | 混合角色，刚开始搭建 | 只保留最小核心，随使用自然生长 |
重要：角色不是互斥的。角色决定的是初始最小集，后续按需添加模块即可。
补充说明：scratch/ 和 todo/ 作为跨角色运行层，会对所有角色创建，以保证 bundled starter skills 第一天就可用。
Workflow
Step 1: 收集最小必要上下文
如果用户没有明确说明，先确认三件事：
- 你的主要角色是什么？（engineer / manager / creator / general）
- 当前是从零开始，还是在已有笔记/仓库上改造？
- 你最希望 AI 帮你的三件事是什么？
不要追问更多；这三点足以确定初始结构。
Step 2: 判断"从零初始化"还是"就地改造"
先扫描仓库现状：
- 是否已有
README.md 或类似入口？
- 是否已有散落的 Markdown 文件？
- 是否已有某种目录结构？
优先就地改造：把已有内容归位到对应模块，而不是推倒重来。
补充说明：脚本模式只补齐骨架，不自动归位已有 Markdown。需要迁移建议或自动分类时，优先走 AI 辅助模式。
就地改造优先级：
- 保留已有高价值内容
- 归位已有文档到合适的模块目录
- 补齐缺失的核心目录和入口文件
- 慎重建新目录，避免过度设计
- 延迟创建大量模板，先观察真实使用模式
Step 3: 建立模块化骨架
根据角色选择核心目录 + 扩展模块。
核心目录（所有角色都建议保留）
| 目录 | 层级 | 用途 |
|---|
bootstrap.md | 入口 | AI 协作规则、目录路由、上下文加载策略 |
README.md | 入口 | 给人看的仓库说明与使用方式 |
context/ | 长期上下文 | 稳定的个人背景、偏好、决策原则 |
templates/ | 沉淀 | 高频文档模板 |
index/ | 沉淀 | Obsidian 导航入口 |
playbook/ | 沉淀 | 可复用的方法、清单、SOP |
skills/ | 能力 | AI skill 源码 |
扩展模块（按角色选择）
Engineer 模块：
tech/ — 技术方案、设计评审、架构决策issue/ — Bug 排查、根因分析、故障复盘projects/ — 按项目隔离的详细资料scratch/ — 临时速记、灵光一闪todo/ — 短周期任务跟踪
Manager 模块：
meeting/ — 会议纪要、对齐记录decision/ — 关键决策记录customers/ — 客户档案与对接跟踪review/ — 结构化反思（日/周/月）question/ — 深度思考与概念辨析
Creator 模块：
drafts/ — 文章草稿、内容片段research/ — 调研资料、读书笔记ideas/ — 灵感与创意
General 模块：
- 从以上模块中选取你最痛的 2-3 个场景对应的目录，其他以后再说
运行时目录（按需接入）
如果你使用的 AI 工具支持 skill/command 目录，在工具的运行时目录创建 symlink 指向 skills/ 和 commands/。
执行建议：
- 脚本模式：如果用户提供
--tool，直接创建入口文件和运行时 symlink
- AI 辅助模式：优先根据当前工具环境推断；无法判断时，在最后作为可选步骤确认
原则：
- 运行时目录只是链接层，不作为主知识库
- 只配你正在用的工具，不要一次性配齐所有
- 具体工具的运行时目录约定，参见
references/ai-tool-runtime-map.md
- 如果入口文件或运行时链接位已被其他内容占用，应显式报冲突并停止，而不是静默跳过
Step 4: 创建最小可用文件
根据角色，优先创建以下骨架。不要创建大量空文档，只创建最影响启动的骨架。
4.1 通用必建
README.md：给人看的仓库说明——这是什么、怎么用、目录结构概览。
bootstrap.md：给 AI 看的协作入口——目录职责、路由规则、资产升级原则、上下文加载策略。
这是整个工作台最核心的文件。生成时以 references/bootstrap-template.md 为结构基线，根据用户角色、已启用目录和已安装 starter skills 裁剪后生成。
同时创建 AI 工具入口的 symlink（根据用户实际使用的工具）：
AGENTS.md → bootstrap.md（Claude Code）CODEBUDDY.md → bootstrap.md（CodeBuddy）- 等等
context/about-me.md：我是谁、做什么的、负责什么。
推荐章节：
## 角色与职责
（一句话描述当前角色和主要职责范围）
## 技术/专业背景
（主要技能、经验领域、技术栈）
## 团队与协作
（团队结构、汇报关系、主要协作对象）
## 当前重点
（近期 1-3 个最重要的工作方向）
context/ai-collaboration.md：我希望 AI 扮演什么角色、怎么协作。
推荐章节：
## AI 角色定义
（期望 AI 扮演的角色，如：记录员、分析师、流程执行者）
## 沟通偏好
（输出风格、详细程度、语言偏好）
## 自主程度
（哪些事可以直接做、哪些需要确认、哪些绝不能做）
## 协作原则
（增量推进、先学后做、务实优先等核心原则）
4.2 按角色补充 context
Engineer 额外创建：
context/tech-stack.md — 常用技术栈、语言、框架、工具链context/coding-principles.md — 代码风格、工程偏好、review 标准
Manager 额外创建：
context/decision-principles.md — 做判断时的优先级、权衡偏好context/work-style.md — 工作与输出偏好、会议习惯、信息消费方式
Creator 额外创建：
context/content-style.md — 内容风格、受众定位、写作偏好
4.3 按角色创建 1-2 个高频模板
以 references/document-templates.md 为骨架基线，根据角色选择并生成到 templates/ 下。
| 角色 | 模板 |
|---|
| Engineer | templates/tech-note.md（技术方案/设计文档）、templates/issue-report.md（问题排查记录） |
| Manager | templates/meeting.md（会议纪要）、templates/decision.md（决策记录） |
| Creator | templates/article-draft.md（文章草稿）、templates/research-note.md（调研笔记） |
| General | templates/note.md（通用记录模板） |
4.4 创建最小导航
index/dashboard.md：Obsidian 导航入口页，链接到各核心目录和高频文件。
Step 5: 安装 Starter Skills
一个空工作台没有 skill 也能用，但有几个基础 skill 会让工作台第一天就能用起来。
本 skill 内嵌了 4 个通用 starter skill，以及 1 个 manager 角色专用的轻量扩展（都在 starter-skills/ 目录下），初始化时按角色复制到目标工作台的 skills/ 目录。
内嵌的 Starter Skills（所有角色自动安装）：
| Skill | 用途 |
|---|
scratch | 低门槛速记，捕获灵感、问题、线索 |
personal-todo | 短周期待办管理，每日聚焦 |
context-summarizer | 讨论结束后收束为结构化资产 |
deep-questioner | 深度追问，拆透复杂问题 |
Manager 角色额外安装：
| Skill | 用途 |
|---|
review-lite | 轻量周回顾，只依赖 bootstrap 默认产物，不引入 full review 的复杂框架和周报分类依赖 |
安装方式：
- AI 工具执行时：将
starter-skills/<skill-name>/ 整个目录复制到目标 skills/<skill-name>/
- 脚本执行时：
bootstrap.py 自动完成复制
角色扩展推荐（只做文字推荐，不自动安装）：
| 角色 | 推荐 Skill | 用途 |
|---|
| Engineer | tech-research | 技术调研、架构对比 |
| Engineer | project-kb-bootstrap | 为单个项目初始化知识库 |
| Manager | review | 完整管理复盘（日/周/update，依赖额外 playbook 与 context 资产，不纳入 starter） |
| Manager | roadmap | 项目级规划管理 |
| Creator | review-doc-builder | 生成带预览的正式评审文档 |
这些扩展 skill 需要用户从社区获取或自行编写，不在本 skill 的自包含范围内。
Step 6: 解释资产升级规则
明确告诉用户：
- 第一次出现 → 先形成实例（放进某个实例层目录）
- 第二次复用 → 提炼为
playbook/ 或 templates/
- 第三次且流程稳定 → 升级为
skills/
并给出下一步具体建议：
- 先补哪几个
context/ 文件（只需填写内容，骨架已创建）
- 最近一件真实工作，应该用哪个模板记录成第一份标准样例
- 哪个重复性任务最有可能成为第一个 skill
Step 7: 给出启动建议
完成初始化后，给出针对性的下一步：
Engineer：
- 先填写
about-me.md 和 tech-stack.md 的内容
- 把最近一个技术问题或方案写成第一份
tech/ 实例
- 下次遇到同类排查时，对比是否值得提炼为
playbook/
Manager：
- 先填写
about-me.md 和 decision-principles.md 的内容
- 用
templates/meeting.md 记录下一次会议
- 月底回顾时，把高频会议流程提炼成 checklist
Creator：
- 先填写
about-me.md 和 content-style.md 的内容
- 把当前进行中的一个选题写成第一份草稿或调研笔记
- 积累 3-5 篇同类内容后，提炼写作模板
General：
- 先只填写
about-me.md
- 选一件本周最真实的工作，用对应模板写成第一份实例
- 使用两周后，再决定添加哪个新模块
Quality Checklist
初始化/改造完成后的自检：
Design Principles
- 先跑起来，再完美：结构只要够用就行，后续随真实需求自然生长
- 角色决定初始集，不决定最终边界：今天选 engineer，明天也可以加
meeting/
- 入口轻量，细节按需加载：
bootstrap.md 只放路由和原则，详细内容放到目录里
- 实例优先于方法论：没有真实工作支撑时，不要造太多 playbook
- Markdown-first：所有内容优先用 Markdown，保证 Obsidian 可读
- 源码与运行时分离：
skills/ 是源码，运行时目录只是链接层
- 0 依赖：本 skill 不依赖环境中的任何其他 skill 或工具
Resource Usage
scripts/bootstrap.py：一键初始化脚本（纯 Python 标准库，0 外部依赖）starter-skills/：内嵌的 4 个通用 starter skill，以及 1 个 manager 角色专用的 review-lite
scratch/ — 低门槛速记personal-todo/ — 短周期待办管理context-summarizer/ — 讨论收束deep-questioner/ — 深度追问review-lite/ — manager 轻量周回顾
references/bootstrap-template.md：bootstrap.md 的骨架模板（Step 4.1 必读）references/context-templates.md：context/ 下各文件的推荐章节结构references/document-templates.md：templates/ 下各模板的最小骨架（Step 4.3 必读）references/ai-tool-runtime-map.md：已知 AI 工具的运行时目录约定速查表
Relationship to Other Skills
本 skill 不依赖任何其他 skill。如果用户环境中存在以下 skill，初始化完成后可联动使用：
context-summarizer — 需要把讨论收束成长期资产时deep-questioner — 需要做深度问题分析时review-doc-builder — 需要输出正式评审稿时scratch — 低门槛信息捕获personal-todo — 短周期待办管理
