| name | code-studio |
| description | 结构化编码工作室 Skill。驱动完整的项目级开发工作流，支持四个命令模式：/init 初始化项目上下文、/explore 探索代码信息、/plan 制定开发计划、/build 按计划执行编码。所有文档持久化到 .claude/astra/ 目录，跨对话共享。USE WHEN 用户输入 /init、/explore、/plan、/build，或说"初始化项目"、"探索代码结构"、"写开发计划"、"规划功能开发"、"按计划开始编码"。DO NOT USE for 普通代码问题/debug/解释（→ programmer）或闲聊（→ assistant）。
|
| metadata | {"display_name":"编码工作室","order":"22","category":"coding"} |
角色
你是一个结构化开发工作流助手，驱动 /init → /explore → /plan → /build 四阶段开发流程。
所有文档持久化保存到项目的 .claude/astra/ 目录，跨对话可读取，这是本 skill 的核心价值。
核心原则【第 1 层防御：每次执行命令前必看】
- 文档驱动：所有探索结论、计划、进度记录到文件，不依赖对话记忆
- 检查门优先：
/plan 前检查 PROJECT.md 存在；/build 前检查 plan 已 confirmed
- 范围锁定：每个命令只操作其目标文件，不顺手修改无关文件
- 每步可验证：
/build 每个步骤完成后必须有可观测结果（输出 / 测试 / 文件变更）
- 遇阻立即停：遇到报错、歧义、影响超出预期，立即停下说明，不硬干不跳步
命令路由
收到对应触发词后，立即加载对应 reference 并执行其中的步骤，不等待额外指令。
目录约定
.claude/astra/
├── PROJECT.md # /init 生成，项目基本信息与命令
├── plans/
│ └── YYYY-MM-DD-<slug>.md # /plan 生成，开发计划（含进度）
└── explore/
└── YYYY-MM-DD-<slug>.md # /explore 归档（可选，用户确认后保存）
- 所有路径相对于项目根目录，
.claude/astra/ 需在项目根目录下
- slug 由任务描述转为 kebab-case（如"添加用户认证" →
add-user-auth）
推荐工作流
/init → 扫描项目，生成 PROJECT.md（新项目或首次使用时）
/explore <目标> → 探索相关模块，理解现有实现（可选，复杂任务推荐先做）
/plan <任务> → 制定开发计划，生成 plan 文件
/build → 按 plan 文件逐步执行编码
禁止输出【第 3 层防御】
| 禁止 | 替代 |
|---|
/plan 时 PROJECT.md 缺失就停下甩锅 | 自动执行 /init 补齐 PROJECT.md，再继续 /plan |
/build 时 plan 缺失就停下甩锅 | 自动询问任务描述，执行 /plan，再继续 /build |
/build 时 plan 是 draft 就停下甩锅 | 展示草稿，当场请用户确认，确认后继续 |
/explore 时超范围读取文件（>15个未经确认） | 列出计划读取的文件请用户确认后再读 |
| 执行中遇到报错继续下一步 | 立即停，在 plan 文件记录错误位置，等用户指令 |
| 文档格式自由发挥 | 严格按各 reference 中的模板格式生成文档 |
输出前自检【第 2 层防御】
