sillyspec 3.7.15 → 3.7.17

package/.claude/skills/sillyspec-propose/SKILL.md

@@ -3,246 +3,11 @@ name: sillyspec:propose
 description: 生成结构化规范 — proposal + design + tasks
 ---
 
-> **提示：** 通常不需要单独执行 propose。brainstorm 阶段会自动产出 design.md。
-> 仅当需求已经明确、跳过 brainstorm 时才需要手动执行 propose。
+## 执行
 
-你现在是 SillySpec 的规范生成器。
+运行 `sillyspec run propose`，按提示逐步执行。
+每步完成后运行 `sillyspec run propose --done --output "摘要"`。
+阶段完成后自动提示下一步。
 
-## 变更名称
+## 用户指令
 $ARGUMENTS
-
-## 流程
-
-### 0. 检查状态（必须先执行）
-
-**在开始任何工作之前，先调用 SillySpec CLI 检查当前状态：**
-
-```bash
-sillyspec status --json
-```
-
-**根据 CLI 返回的 phase 决定是否允许执行 propose：**
-- `phase: "propose"` → ✅ 可以继续
-- 其他 phase → ❌ 不允许跳步，提示用户运行 `sillyspec next` 获取正确步骤
-
-**不要跳过状态检查。不要自己推断阶段。以 CLI 为准。**
-
-### 1. 加载上下文
-
-读取相关文档：
-
-```bash
-# 检测是否是子阶段变更
-if [[ "$ARGUMENTS" == */stage-* ]]; then
-  MASTER_NAME="${ARGUMENTS%%/*}"
-  STAGE_NAME="${ARGUMENTS#*/}"
-  MASTER_DIR=".sillyspec/changes/$MASTER_NAME"
-  CHANGE_DIR="$MASTER_DIR/stages/$STAGE_NAME"
-else
-  CHANGE_DIR=".sillyspec/changes/$ARGUMENTS"
-fi
-
-# 如果存在 MASTER.md，读取主变更上下文
-cat .sillyspec/changes/*/MASTER.md 2>/dev/null
-
-# 最新设计文档
-ls -t .sillyspec/specs/*.md | head -1
-# 需求
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null
-# 代码库约定（棕地）
-cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
-cat .sillyspec/codebase/ARCHITECTURE.md 2>/dev/null
-# 已有变更（排除子阶段）
-ls .sillyspec/changes/ | grep -v archive
-```
-
-如果是子阶段变更（如 `reward-punishment/stage-1`）：
-- 读取 MASTER.md 获取整体方向和技术决策
-- 读取 MASTER.md 中"经验记录"章节（前面阶段的踩坑经验）
-- 读取前面已完成阶段的设计文件（保持一致性）
-- 读取该阶段对应的原型分析结果
-- 规范文件保存到 `changes/<变更名>/stages/<stage-N>/`
-
-如果是普通变更，照原流程执行。
-
-如果没有设计文档 → 提示先运行 `/sillyspec:brainstorm`
-
-### 1.5 锚定确认（必须完成）
-
-读取相关规范文件。对于存在的文件，确认理解；对于不存在的文件，标注跳过：
-
-```
-已读取并理解：
-- [x] proposal.md — 变更动机和范围（如果存在）
-- [ ] design.md — 不存在（正常，将在本阶段生成）
-- [ ] specs/requirements.md — 不存在（正常，将在本阶段生成）
-
-所有可用上下文已加载，开始执行。
-```
-
-**文件不存在不是错误**。只确认实际存在的文件。不准跳过此步骤。
-
-### 2. 探索现有代码
-
-理解相关模块的当前实现，识别影响范围。
-
-### 3. 生成规范文件
-
-创建 `.sillyspec/changes/$ARGUMENTS/`，生成以下文件：
-
-**`proposal.md`** — 变更提案：
-```markdown
-# [change-name]
-
-## 动机
-为什么做这件事
-
-## 变更范围
-受影响的核心区域
-
-## 不在范围内
-明确排除的内容
-
-## 成功标准
-- [ ] 可量化的标准 1
-- [ ] 可量化的标准 2
-```
-
-**`specs/requirements.md`** — 需求清单：
-```markdown
-# 需求
-
-## 功能需求
-- [ ] REQ-001: 用户可以用邮箱注册
-- [ ] REQ-002: 注册后自动发送验证邮件
-
-## 用户场景
-### 场景 1: 新用户注册
-Given: 用户在注册页面
-When: 填写邮箱和密码并提交
-Then: 收到验证邮件，账户处于待验证状态
-
-### 场景 2: 邮箱验证
-Given: 用户收到验证邮件
-When: 点击验证链接
-Then: 账户激活，跳转到登录页
-
-## 非功能需求
-- 注册接口响应 < 500ms
-- 密码使用 bcrypt 哈希
-```
-
-**`design.md`** — 技术方案：
-```markdown
-# 技术设计
-
-## 架构决策
-- 使用 JWT 存储 session（而非 server-side session）
-- 理由：支持未来微服务拆分
-
-## 文件变更清单
-| 操作 | 文件 | 说明 |
-|---|---|---|
-| 新建 | `src/lib/auth.ts` | 认证核心逻辑 |
-| 新建 | `src/app/api/auth/register/route.ts` | 注册接口 |
-| 修改 | `prisma/schema.prisma` | 添加 User 模型 |
-
-## 数据模型
-[Prisma schema 或数据库表设计]
-
-## API 设计
-POST /api/auth/register
-Request: { email: string, password: string }
-Response: { userId: string, message: "verification email sent" }
-
-## 代码风格参照
-- Controller 风格：参考 `XxxController.java`（从 CONVENTIONS.md 获取）
-- Service 风格：参考 `XxxServiceImpl.java`（从 CONVENTIONS.md 获取）
-- 实体风格：参考 `Xxx.java`（基类：`BaseEntity`，字段参见 CONVENTIONS.md）
-- 返回值类型：`Result<T>` / `ResponseEntity<T>`
-- 异常类型：`BusinessException` / 其他
-- 注解风格：从 CONVENTIONS.md「代码风格」章节获取
-```
-
-**`tasks.md`** — 实现清单：
-```markdown
-# 实现清单
-
-## 准备
-- [ ] Task 0: 配置开发环境（依赖、环境变量）
-
-## 实现
-- [ ] Task 1: 数据库模型（User 表）
-- [ ] Task 2: 注册 API
-- [ ] Task 3: 邮件发送服务
-- [ ] Task 4: 邮箱验证流程
-
-## 收尾
-- [ ] Task 5: 错误处理和边界情况
-- [ ] Task 6: 集成测试
-```
-
-### 4. 展示关键文件
-
-展示 proposal.md 和 design.md 给用户审阅。tasks.md 只展示任务列表（细节在 plan 阶段展开）。
-
-### 5. 自检门控（Hard Gate）
-
-在展示文件给用户之前，**必须自检**：
-
-- [ ] proposal.md 是否包含"动机"、"变更范围"、"不在范围内"、"成功标准"四个章节？
-- [ ] design.md 是否包含"文件变更清单"表格？
-- [ ] specs/requirements.md 是否包含 Given/When/Then 格式的用户场景？
-- [ ] tasks.md 是否每个 task 都有文件路径？
-
-**任何一项不通过 → 修正后重新检查，不准跳过。**
-
-### 脚本校验（硬验证）
-
-Hard Gate 自检通过后，运行校验脚本：
-
-```bash
-bash scripts/validate-proposal.sh .sillyspec/changes/$ARGUMENTS
-```
-
-- 脚本返回 0 → 自检通过，继续展示文件
-- 脚本返回非 0 → 根据错误提示修正文件，重新运行脚本
-
-### 7. 最后说：
-
-**用 CLI 验证并获取下一步：**
-
-```bash
-sillyspec status --json
-```
-
-展示给用户：
-> 规范已生成到 `.sillyspec/changes/$ARGUMENTS/`。
-> 
-> 审阅 `proposal.md`（为什么做）和 `design.md`（怎么做）。
-> 下一步：
-
-```bash
-sillyspec next
-```
-
-将 CLI 返回的命令推荐给用户。**不要自己编建议。**
-
-### 8. 更新 progress.json
-
-propose 完成后，**必须自动更新进度**：
-```bash
-sillyspec progress complete-stage propose
-```
-
-- 当前阶段改为 `propose ✅`
-- 下一步改为 `/sillyspec:plan`
-- 历史记录追加时间 + propose 完成
-- 如果是子阶段（stages/ 下），更新阶段进度
-
-## 绝对规则
-- 不写实现代码
-- tasks.md 只列任务名，不写具体步骤
-- 必须包含可量化的成功标准
-- 用户场景用 Given/When/Then 格式
-- **禁止编造不存在的表名、字段名、API 端点。** design.md 中引用的数据库对象必须来自 ARCHITECTURE.md 的数据模型章节，或明确标注为"新增"

package/.claude/skills/sillyspec-verify/SKILL.md

@@ -3,144 +3,11 @@ name: sillyspec:verify
 description: 验证实现 — 对照规范检查 + 测试套件
 ---
 
-> **可选阶段。** execute 完成后会询问是否需要 verify，也可以手动调用。
+## 执行
 
-你现在是 SillySpec 的验证器。
+运行 `sillyspec run verify`，按提示逐步执行。
+每步完成后运行 `sillyspec run verify --done --output "摘要"`。
+阶段完成后自动提示下一步。
 
-## 🛑 流程控制（必须先执行）
-
-**在开始任何工作之前，先调用 SillySpec CLI 检查当前状态：**
-
-```bash
-sillyspec status --json
-```
-
-**根据 CLI 返回的 phase 决定是否允许执行 verify：**
-- `phase: "verify"` → ✅ 可以继续
-- 其他 phase → ❌ 不允许跳步，提示用户运行 `sillyspec next` 获取正确步骤
-
-**不要跳过状态检查。不要自己推断阶段。以 CLI 为准。**
-
-## 流程
-
-### 1. 加载规范
-
-```bash
-LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
-cat "$LATEST/proposal.md"
-cat "$LATEST/design.md"
-cat "$LATEST/tasks.md"
-cat "$LATEST/specs/requirements.md" 2>/dev/null
-```
-
-### 1.5 锚定确认（必须完成）
-
-读取相关规范文件。对于存在的文件，确认理解；对于不存在的文件，标注跳过：
-
-```
-已读取并理解：
-- [x] proposal.md — 变更动机和范围（如果存在）
-- [x] design.md — 技术方案和文件变更（如果存在）
-- [x] tasks.md — 实现清单（如果存在）
-- [x] specs/requirements.md — 需求和场景（如果存在）
-
-所有可用上下文已加载，开始验证。
-```
-
-**文件不存在不是错误**。只确认实际存在的文件。不准跳过此步骤。
-
-### 2. 逐项检查 tasks.md
-
-对每个 checkbox 报告状态：
-- ✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
-
-### 3. 对照 design.md
-
-- 架构决策是否遵循？
-- 文件变更清单是否一致？
-- 数据模型是否符合？
-- API 设计是否符合？
-
-### 4. 运行完整测试套件（fresh run）
-
-```bash
-# 根据项目技术栈运行
-pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null || go test ./... 2>/dev/null
-```
-
-记录通过/失败数量。如有失败，分析原因。
-
-### 5. 代码质量扫描
-
-```bash
-# 搜索技术债务标记
-grep -r "TODO\|FIXME\|HACK\|XXX" src/ lib/ app/ --include="*.ts" --include="*.tsx" --include="*.py" --include="*.js" 2>/dev/null | head -20
-```
-
-### 6. 输出验证报告
-
-```markdown
-# SillySpec 验证报告
-
-## 任务完成度
-- [x] Task 1: xxx ✅
-- [x] Task 2: xxx ✅
-- [ ] Task 3: xxx ❌ 未实现
-完成度：2/3
-
-## 设计一致性
-- ✅ 架构决策遵循
-- ⚠️ API 返回格式与 design.md 略有差异（缺少 error 字段）
-
-## 测试结果
-- passed: 42, failed: 3
-
-## 技术债务标记
-- src/auth/login.ts:15 // TODO: add rate limiting
-- src/auth/login.ts:45 // FIXME: token expiry
-
-## 结论
-⚠️ PASS WITH NOTES
-```
-
-## 脚本校验（硬验证）
-
-在输出验证报告之前，运行综合校验脚本：
-
-```bash
-bash scripts/validate-all.sh
-```
-
-将脚本输出纳入验证报告中的"设计一致性"部分。
-
-### 7. 最后说：
-
-**用 CLI 验证并获取下一步：**
-
-```bash
-sillyspec status --json
-```
-
-展示结果给用户，然后：
-
-```bash
-sillyspec next
-```
-
-将 CLI 返回的命令推荐给用户。**不要自己编建议。**
-
-### 8. 更新 progress.json
-
-verify 完成后，**必须自动更新进度**：
-```bash
-sillyspec progress complete-stage verify
-```
-
-- 当前阶段改为 `verify ✅` 或 `verify ⚠️`
-- 下一步改为 `/sillyspec:archive`（PASS 时）或 `修复后重新 /sillyspec:verify`
-- 如果是子阶段，更新阶段进度；如果全部阶段完成，下一步改为 `/sillyspec:archive`
-- 历史记录追加时间 + 验证结果
-
-## 绝对规则
-- 不修改任何代码
-- 只做检查和报告
+## 用户指令
+$ARGUMENTS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.7.15",
+  "version": "3.7.17",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/init.js

@@ -199,9 +199,12 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
   }
 
   // 复制 skills 到 .claude/skills/（给 Claude Code 使用）
-  const skillsSource = join(homedir(), '.agents', 'skills');
   const claudeSkillsDir = join(projectDir, '.claude', 'skills');
-  if (existsSync(skillsSource)) {
+  // 优先从 npm 包自带位置复制，其次从 ~/.agents/skills/
+  const npmSkillsDir = join(__dirname, '..', '.claude', 'skills');
+  const localSkillsDir = join(homedir(), '.agents', 'skills');
+  const skillsSource = existsSync(npmSkillsDir) ? npmSkillsDir : existsSync(localSkillsDir) ? localSkillsDir : null;
+  if (skillsSource) {
     const sillyspecSkills = readdirSync(skillsSource).filter(f => f.startsWith('sillyspec-') && statSync(join(skillsSource, f)).isDirectory());
     if (sillyspecSkills.length > 0) {
       mkdirSync(claudeSkillsDir, { recursive: true });
@@ -211,7 +214,7 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
       console.log(chalk.green('    ✓ Claude Code skills 已同步 (' + sillyspecSkills.length + ' 个)'));
     }
   } else {
-    console.log(chalk.yellow('    ⚠ 未找到 ~/.agents/skills/，跳过 Claude Code skills 同步'));
+    console.log(chalk.yellow('    ⚠ 未找到 skills 目录，跳过 Claude Code skills 同步'));
   }