@kunlv/atdc 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kunlv/atdc",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "AI coding workflow orchestration kit — team edition",
   "bin": {
     "atdc": "bin/atdc.js",

package/prompts/6-article.md

@@ -2,7 +2,7 @@
 
 从此文件读取后，直接开始执行，无需用户再次确认。
 
-> **触发方式**：`/atdc:article`、`/atd article`、`生成文章`、`写文章`
+> **触发方式**：`/atd:article`、`/atd article`、`生成文章`、`写文章`
 
 ---
 
@@ -39,7 +39,7 @@ echo "TARGET_DIR=$CHANGE_DIR"
 
 ## Step 0.3：用户提供素材的优先处理（OCR 增强）
 
-> **触发条件**：用户调用 `/atdc:article` 时附带素材路径（如「素材在 /path/to/dir/」或「使用 /path/ 下面的图片」）。
+> **触发条件**：用户调用 `/atd:article` 时附带素材路径（如「素材在 /path/to/dir/」或「使用 /path/ 下面的图片」）。
 
 ### 检测素材路径
 
@@ -73,7 +73,7 @@ done
 
 将 OCR 提取的文字内容用于：
 
-1. **识别截图主题**：判断每张截图属于 atdc 的哪个阶段（1-spec / 2-qa / 3-impl / 4-verify / 5-done）
+1. **识别截图主题**：判断每张截图属于 atd-code 的哪个阶段（1-spec / 2-qa / 3-impl / 4-verify / 5-done）
 2. **补充文章上下文**：OCR 文字作为会话历史的补充证据，丰富 Phase A 素材
 3. **确定插图位置**：按阶段归类后，在文章对应章节插入 `![[素材目录/xxx.png]]`
 
@@ -292,11 +292,20 @@ python3 -c "import xml.etree.ElementTree as ET; ET.parse('<output-path.svg>')" &
 
 ```bash
 # 一键导出目录下所有 SVG → PNG（2x 分辨率）
-node ~/atdc/scripts/svg2png.js <assets-dir>
+node ~/atd-code/scripts/svg2png.js <assets-dir>
 ```
 
-> 依赖：`~/atdc/node_modules/puppeteer`（已在 install.sh 中安装）。
-> 若报错 `Cannot find module 'puppeteer'`，执行：`cd ~/atdc && npm install puppeteer`
+> 依赖：`~/atd-code/node_modules/puppeteer`（已在 install.sh 中安装）。
+> 若报错 `Cannot find module 'puppeteer'`，执行：`cd ~/atd-code && npm install puppeteer`
+
+### B3.5. 修复 PNG 权限（强制）
+
+> 🔴 `rsvg-convert` / `Puppeteer` 生成的 PNG 可能继承过紧的 umask，导致 Web 渲染器返回 403。
+> **每张 PNG 导出后必须执行**：
+
+```bash
+chmod 644 /Users/lvkun/Documents/Obsidian/Docs/assets/<image>.png
+```
 
 ### B4. 布局验证
 
@@ -371,14 +380,20 @@ EOF
 
 **用户素材**（Step 0.3 检测到的）：
 - 直接使用用户提供的路径，如 `![[素材目录/1.png]]`
-- Obsidian wikilink 中的路径相对于 `assets/`，即 `/Users/lvkun/Documents/Obsidian/Docs/assets/`
 
 **Auto-generated diagrams**（fireworks-tech-graph 生成的）：
 - 输出到 Obsidian assets 根目录：
   ```
   /Users/lvkun/Documents/Obsidian/Docs/assets/<change-name>-<diagram-label>.png
   ```
-- 文章中引用使用 Obsidian wikilink 格式：`![[<change-name>-<diagram-label>.png]]`
+- 文章中引用使用**纯文件名** Obsidian wikilink：`![[<change-name>-<diagram-label>.png]]`
+
+> ⚠️ **禁止使用带路径前缀的引用**（如 `![[assets/img.png]]` 或 `![[../assets/img.png]]`）。
+> 原因：Web 渲染器的 wikilink 转译规则将 `![[path/img.png]]` 转为 `![img.png](path/img.png)`，
+> 路径会相对于文档所在目录解析，而非 vault 根目录。纯文件名才能触发渲染器的全局 assets 搜索。
+>
+> ✅ 正确：`![[atdc-arch.png]]`
+> ❌ 错误：`![[assets/atdc-arch.png]]`
 
 ---
 
@@ -405,7 +420,7 @@ EOF
 缺失的 skill：<skill-name>
 安装方式：npx skills add <skill-package>
 
-所有 skill 就绪后重新运行 /atdc:article。
+所有 skill 就绪后重新运行 /atd:article。
 ```
 
 ### C2. 写作规范（内嵌硬约束，与 skill 并行生效）