@ultime/codecraft 0.0.0-stage → 1.0.0

package/evals/golden-tasks.md

@@ -0,0 +1,114 @@
+# Golden Tasks（评估任务）
+
+用于验证 skill 是否真的按规范工作。每条任务记录：结果、版本、误报 / 漏报。
+
+## 1. 新项目架构计划
+
+- 输入：一个 mp + admin 的小项目，后端契约未知。
+- 模式：Plan（只读）。
+- 期望：选 L0/L1；列必需 / 可选环节；出目录树；分阶段计划；不改文件。
+- 失败信号：直接生成代码；把所有环节都设为必需；不标未定项。
+
+## 2. 旧项目审计
+
+- 输入：一个页面直接 import api、store 放请求的旧项目。
+- 模式：Audit（只读）。
+- 期望：引用 A3/A4/A17；给 severity；给升级计划；不改文件。
+- 失败信号：只给泛泛建议；无文件证据；顺手改代码。
+
+## 3. 新增页面
+
+- 输入：按族卡新增一个列表页。
+- 模式：Apply。
+- 期望：页面只组合；不 import api；loading/empty/error 可见；跑门禁。
+- 失败信号：页面里写请求；错误被吞；状态用多个布尔。
+
+## 4. 新增 Wrapper
+
+- 输入：第三方接口字段与内部类型不一致。
+- 模式：Apply。
+- 期望：外部类型只在 Wrapper；内部类型 `Xxx`；错误归一；不改调用方。
+- 失败信号：页面直接 import 外部类型；内部类型叫 `XxxDto`；字段泄漏到 UI。
+
+## 5. 评审一个边界违规
+
+- 输入：一个 diff，内部组件 import `external/`。
+- 模式：Review（只读）。
+- 期望：命中 A4/A17；给最小改法；不改文件。
+- 失败信号：没发现；建议大重构；直接改代码。
+
+## 6. Library 审计
+
+- 输入：一个 `packages/` 仓库，core 导入了未声明的 workspace 包；`dist/tokens.css` 没有“勿手改”标记。
+- 模式：Audit（只读，`--pack library`）。
+- 期望：命中 A2 / A11；只读；报告带包名与文件。
+- 失败信号：把 `tokens.json`（seed 源文件）误判成生成物；漏掉未声明依赖。
+
+## 7. Gates 汇总
+
+- 输入：`codecraft.config.json` 里一个 gate 成功、一个失败。
+- 模式：Audit。
+- 期望：报告列出两个 gate、失败输出、退出码 1；不改文件。
+- 失败信号：跳过 gate；只报内置规则；不报告退出码。
+
+## 8. Plan from findings
+
+- 输入：一个含 A17 违规的项目。
+- 模式：Plan（只读）。
+- 期望：输出 P1 项、动作、验证命令；默认不跑 gates；不改文件。
+- 失败信号：直接改代码；没有验证命令；把 warn 当 error 阻断。
+
+## 9. Init dry-run
+
+- 输入：一个空目录，`--name demo`。
+- 模式：Init（dry-run）。
+- 期望：输出 `apps/demo/...`、`docs/`、`codecraft.config.json`；目录仍然为空。
+- 失败信号：写盘；缺 `src/pages` / `src/external`；没有 config 预览。
+
+## 10. Init apply
+
+- 输入：一个空目录，`--name demo --apply`。
+- 模式：Init（apply）。
+- 期望：目录与模板文件写入；README / package.json 的占位符已替换；再跑一次输出 Skipped、不覆盖已改文件。
+- 失败信号：覆盖已有文件；`--apply` 缺 `--name` 仍写盘；占位符残留。
+
+## 11. 模式选型
+
+- 输入：一个 12 分支的导出格式选择，分支签名一致。
+- 模式：Plan（只读）。
+- 期望：先答选型四问；给 Strategy（策略）与代价；给反例；不改文件。
+- 失败信号：只报模式名；没有代价；分支签名不同还硬做函数表。
+
+## 12. 架构设计
+
+- 输入：一个单团队、单产品的多页应用，后端契约未知。
+- 模式：Plan（只读）。
+- 期望：先定档位 L0/L1；列变化轴；切边界并给依赖规则；两张图（Context / Container）；ADR 只记难逆转项；不改文件。
+- 失败信号：直接上微服务 / 微前端；只画图不给依赖规则；没有退出条件。
+
+## 13. 架构评审
+
+- 输入：一个模块间存在循环依赖、页面直接调 API 的项目。
+- 模式：Audit / Review（只读）。
+- 期望：命中 M1 / M4 / A2；给最小切分改法；给可执行检查；不改文件。
+- 失败信号：只谈风格；建议大重写；没有验证方式。
+
+## 14. Design System 审计
+
+- 输入：`packages/` 下的 UI 包，README 引用了内部 `docs/开发计划/...`，`dist/tokens.css` 缺标记。
+- 模式：Audit（`--pack design-system`）。
+- 期望：命中 A11 / A21；不重复实现 `kit:check`；给出改为自洽文档的最小改法。
+- 失败信号：只报 library 规则；把内部文档路径当正常引用；建议复制项目门禁。
+
+## 15. 密钥扫描
+
+- 输入：一个源码文件里出现高置信 API key。
+- 模式：Audit。
+- 期望：命中 A21；只报文件与行号，不回显密钥；提示轮换。
+- 失败信号：漏报；把密钥原文打印到报告；把普通变量名误报为密钥。
+
+## 评分
+
+- 每条任务：pass / fail。
+- 记录：版本、误报数、漏报数、审稿轮次。
+- 目标：一次通过率上升，审稿轮次下降。

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@ultime/codecraft",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Language-agnostic code standard as an installable skill package.",
+  "keywords": [
+    "ai",
+    "code-standard",
+    "lint",
+    "skill"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ultime-space/skills.git",
+    "directory": "codecraft"
+  },
+  "homepage": "https://github.com/ultime-space/skills/tree/main/codecraft",
+  "bugs": {
+    "url": "https://github.com/ultime-space/skills/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "codecraft": "./bin/codecraft.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "docs",
+    "scenarios",
+    "adapters",
+    "prompts",
+    "evals",
+    "templates",
+    "VERSION",
+    "CHANGELOG.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "codecraft.config.example.json"
+  ],
+  "type": "module",
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/prompts/output.md

@@ -0,0 +1,27 @@
+# Output Format（输出格式）
+
+默认 Markdown；JSON 仅用于 CLI / CI。
+
+## Markdown
+
+```md
+## 结论
+
+## 证据
+
+## 差距 / 风险
+
+## 计划
+
+## 验证
+
+## 下一步
+```
+
+规则：
+
+- 每条结论引用 A-ID 或文件路径。
+- 不写敏感信息；示例用占位符。
+- 英文术语首次出现用 `English（中文）`。
+- 不把“计划”写成“已完成”。
+- Audit / Plan 模式只输出报告，不改文件。

package/scenarios/audit-existing.md

@@ -0,0 +1,41 @@
+# Audit Existing（旧项目审计）
+
+## 何时用
+
+接手 / 升级 / 重构前体检。
+
+## 输入
+
+- 仓库路径 / 分支
+- 目标（升级、拆分、迁移、只体检）
+
+## 先读
+
+项目规则 → 宪法 → 相关族卡 → 现有 `README` / `docs`
+
+## 步骤
+
+1. 盘点：技术栈、目录、页面、请求层、状态、类型、测试。
+2. 逐条对照 A1–A21；标 pass / warn / fail。
+3. 找“历史实现”与“环节缺失”：哪些是习惯，哪些是必需。
+4. 出差距清单：影响、成本、优先级。
+5. 出升级计划：分阶段、可回滚、每阶段验收。
+6. 风险：兼容、数据、权限、发布。
+
+## 输出
+
+- 体检报告
+- 差距清单（severity）
+- 升级计划
+- 回滚方案
+
+## 停止条件
+
+- 无法只读访问
+- 需要改动生产配置
+- 发现密钥 / 隐私：停止并提示轮换
+
+## 验收
+
+- 只读；不改代码
+- 每条结论有文件路径 / 命令 / A-ID

package/scenarios/new-project.md

@@ -0,0 +1,50 @@
+# New Project（新项目）
+
+## 何时用
+
+从 0 设计架构、技术选型、目录与分阶段计划。
+
+## 输入
+
+- 业务目标 / 页面清单
+- 端（mp / app / web / admin）
+- 团队规模 / 交付周期
+- 已有技术栈约束
+
+## 先读
+
+1. 项目 `AGENTS.md` / `rules/`
+2. `../docs/00-constitution.md`
+3. `../docs/01-family-cards.md`（只读相关族）
+4. `../docs/03-style-map.md`
+5. `../docs/06-architecture.md`（档位 / 七步法 / 边界 / ADR）
+6. 需要选型时：`../docs/05-patterns.md`
+
+## 步骤
+
+1. 盘点：页面、角色、数据、外部系统。
+2. 选规模档位：L0 / L1 / L2。
+3. 选环节：Transport / Wrapper / Behavior / State / ...；标明必需 / 可选。
+4. 定目录：`apps/` + `packages/`（如果需要）。
+5. 定契约：类型来源、命名、门禁。
+6. 出分阶段计划：每阶段一个可验收的垂直切片。
+
+## 输出
+
+- 架构图（文字）
+- 目录树
+- 环节清单
+- 分阶段计划
+- 风险与未定项
+
+## 停止条件
+
+- 业务目标不清
+- 后端契约未知且无法假设
+- 需要引入新的外部服务但无人确认
+
+## 验收
+
+- 每条规则引用 A-ID
+- 计划可执行、可验收
+- 不含敏感信息

package/scenarios/refactor-review.md

@@ -0,0 +1,31 @@
+# Refactor / Review（重构 / 评审）
+
+## 何时用
+
+已有改动或准备改动，需要按规范评审 / 重构。
+
+## 模式
+
+Apply（执行）或 Review（只评审）。
+
+## 步骤
+
+1. 读 diff / 目标文件。
+2. 对照相关族卡与 A1–A21。
+3. 列问题：边界、状态、错误、命名、注释、生成物。
+4. 出最小改动计划；能不改就不改。
+5. Apply：执行 + 跑门禁；Review：只出意见。
+6. 输出五段式。
+
+## 输出
+
+- 问题清单
+- 最小改动
+- 验证命令与结果
+- 风险 / 回滚
+
+## 停止条件
+
+- 需要跨族大改但无测试
+- 需要改生成物
+- 需要引入新依赖但未确认

package/scenarios/report-only.md

@@ -0,0 +1,33 @@
+# Report Only（只出报告）
+
+## 何时用
+
+只想体检，不要计划、不改代码。
+
+## 先读
+
+项目规则 → 宪法 → 相关族卡
+
+## 步骤
+
+1. 只读扫描。
+2. 对照 A1–A21。
+3. 输出 findings：severity / 证据 / 影响 / 建议（一句话）。
+4. 不做升级计划，不写文件。
+
+## 输出
+
+- 结论
+- Findings 表
+- 附：版本号 + 扫描范围
+
+## 停止条件
+
+- 无法只读访问
+- 发现密钥 / 隐私：立即停止并提示轮换
+
+## 验收
+
+- 不写文件
+- 每条 finding 有证据
+- 不含敏感信息