@kunlv/atdc 1.0.3 → 1.0.5

package/bin/add-command.py

@@ -42,10 +42,10 @@ description: {desc}。触发词：{triggers}。
 }
 
 PATHS = {
-    "opencode": f"{ATD}/commands/opencode/atd/{{name}}.md",
-    "claude": f"{ATD}/commands/claude/atd/{{name}}.md",
-    "codex": f"{ATD}/commands/codex/atd-{{name}}/SKILL.md",
-    "cursor": f"{ATD}/commands/cursor/atd-{{name}}/SKILL.md",
+    "opencode": f"{ATD}/commands/opencode/atdc/{{name}}.md",
+    "claude": f"{ATD}/commands/claude/atdc/{{name}}.md",
+    "codex": f"{ATD}/commands/codex/atdc-{{name}}/SKILL.md",
+    "cursor": f"{ATD}/commands/cursor/atdc-{{name}}/SKILL.md",
 }
 
 def add_command(name, desc, triggers, prompt=None, short_desc=None, from_learn=False, failure=None, dead_end=None):
@@ -99,13 +99,13 @@ def add_command(name, desc, triggers, prompt=None, short_desc=None, from_learn=F
     with open(install_sh) as f:
         content = f.read()
 
-    skill_name = f"atd-{name}"
-    marker = "for skill in atd "
+    skill_name = f"atdc-{name}"
+    marker = "for skill in atdc "
     if marker in content and skill_name not in content:
         # Find the "for skill in" line and add the new skill
         lines = content.split("\n")
         for i, line in enumerate(lines):
-            if "for skill in atd " in line and skill_name not in line:
+            if "for skill in atdc " in line and skill_name not in line:
                 # Insert before the "do" keyword
                 j = line.rfind("; do")
                 if j < 0:

package/install.sh

@@ -68,26 +68,26 @@ echo "Step 2.6：检查旧 flow-kit symlink 迁移..."
 MIGRATED=0
 
 # Claude Code
-if [ -L "$HOME_DIR/.claude/commands/atd.md" ]; then
-  rm -f "$HOME_DIR/.claude/commands/atd.md"
-  echo "  ✓ 移除旧 symlink ~/.claude/commands/atd.md"
+if [ -L "$HOME_DIR/.claude/commands/atdc.md" ]; then
+  rm -f "$HOME_DIR/.claude/commands/atdc.md"
+  echo "  ✓ 移除旧 symlink ~/.claude/commands/atdc.md"
   MIGRATED=1
 fi
-if [ -L "$HOME_DIR/.claude/commands/atd" ]; then
-  rm -rf "$HOME_DIR/.claude/commands/atd"
-  echo "  ✓ 移除旧 symlink ~/.claude/commands/atd/"
+if [ -L "$HOME_DIR/.claude/commands/atdc" ]; then
+  rm -rf "$HOME_DIR/.claude/commands/atdc"
+  echo "  ✓ 移除旧 symlink ~/.claude/commands/atdc/"
   MIGRATED=1
 fi
 
 # OpenCode
-if [ -L "$HOME_DIR/.config/opencode/commands/atd.md" ]; then
-  rm -f "$HOME_DIR/.config/opencode/commands/atd.md"
-  echo "  ✓ 移除旧 symlink ~/.config/opencode/commands/atd.md"
+if [ -L "$HOME_DIR/.config/opencode/commands/atdc.md" ]; then
+  rm -f "$HOME_DIR/.config/opencode/commands/atdc.md"
+  echo "  ✓ 移除旧 symlink ~/.config/opencode/commands/atdc.md"
   MIGRATED=1
 fi
-if [ -L "$HOME_DIR/.config/opencode/commands/atd" ]; then
-  rm -rf "$HOME_DIR/.config/opencode/commands/atd"
-  echo "  ✓ 移除旧 symlink ~/.config/opencode/commands/atd/"
+if [ -L "$HOME_DIR/.config/opencode/commands/atdc" ]; then
+  rm -rf "$HOME_DIR/.config/opencode/commands/atdc"
+  echo "  ✓ 移除旧 symlink ~/.config/opencode/commands/atdc/"
   MIGRATED=1
 fi
 
@@ -128,16 +128,16 @@ else
   if [ -L "$CLAUDE_CMD/atd.md" ] || [ -f "$CLAUDE_CMD/atd.md" ]; then
     rm -f "$CLAUDE_CMD/atd.md"
   fi
-  ln -s "$ATDC_DIR/commands/claude/atd.md" "$CLAUDE_CMD/atd.md"
+  ln -s "$ATDC_DIR/commands/claude/atdc.md" "$CLAUDE_CMD/atd.md"
 
   # atd/ 子命令目录
   if [ -L "$CLAUDE_CMD/atd" ] || [ -d "$CLAUDE_CMD/atd" ]; then
     rm -rf "$CLAUDE_CMD/atd"
   fi
-  ln -s "$ATDC_DIR/commands/claude/atd" "$CLAUDE_CMD/atd"
+  ln -s "$ATDC_DIR/commands/claude/atdc" "$CLAUDE_CMD/atd"
 
-  echo "  ✓ ~/.claude/commands/atd.md → atdc/commands/claude/atd.md"
-  echo "  ✓ ~/.claude/commands/atd/   → atdc/commands/claude/atd/"
+  echo "  ✓ ~/.claude/commands/atdc.md → atdc/commands/claude/atdc.md"
+  echo "  ✓ ~/.claude/commands/atdc/   → atdc/commands/claude/atdc/"
 fi
 
 echo ""
@@ -155,15 +155,15 @@ else
   if [ -L "$OPENCODE_CMD/atd.md" ] || [ -f "$OPENCODE_CMD/atd.md" ]; then
     rm -f "$OPENCODE_CMD/atd.md"
   fi
-  ln -s "$ATDC_DIR/commands/opencode/atd.md" "$OPENCODE_CMD/atd.md"
+  ln -s "$ATDC_DIR/commands/opencode/atdc.md" "$OPENCODE_CMD/atd.md"
 
   if [ -L "$OPENCODE_CMD/atd" ] || [ -d "$OPENCODE_CMD/atd" ]; then
     rm -rf "$OPENCODE_CMD/atd"
   fi
-  ln -s "$ATDC_DIR/commands/opencode/atd" "$OPENCODE_CMD/atd"
+  ln -s "$ATDC_DIR/commands/opencode/atdc" "$OPENCODE_CMD/atd"
 
-  echo "  ✓ ~/.config/opencode/commands/atd.md → atdc/commands/opencode/atd.md"
-  echo "  ✓ ~/.config/opencode/commands/atd/   → atdc/commands/opencode/atd/"
+  echo "  ✓ ~/.config/opencode/commands/atdc.md → atdc/commands/opencode/atdc.md"
+  echo "  ✓ ~/.config/opencode/commands/atdc/   → atdc/commands/opencode/atdc/"
 fi
 
 echo ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kunlv/atdc",
-  "version": "1.0.3",
+  "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 并行生效）