codemini-cli 0.1.15 → 0.1.17

package/OPERATIONS.md

@@ -85,6 +85,7 @@ codemini config list
 codemini config set shell.default powershell
 codemini config set ui.language en
 codemini config set soul.preset professional
+codemini config set soul.preset pirate
 ```
 
 ```bash

package/README.md

@@ -28,6 +28,7 @@ It is designed for teams that want a coding assistant that feels practical, cont
 - Structured code tools for small models: `locate`, `open_target`, `edit_target`
 - More conservative `plan auto` acceptance checks with reviewer/tester goal checklists
 - Tone presets through `soul`, without changing plans or code behavior
+- Example soul presets include `professional`, `playful`, `anime`, `pirate`, `caveman`, and `ceo`
 - Sub-agents for planning, coding, review, and testing
 
 ### Quick Start
@@ -142,6 +143,7 @@ CodeMini CLI 是一个为小模型工作流优化过的代码助手 CLI，重点
 - 为小模型补了结构化代码工具：`locate`、`open_target`、`edit_target`
 - `plan auto` 会基于原始目标生成验收清单，并更保守地处理 reviewer/tester 结果
 - `soul` 只影响语气，不影响计划和代码行为
+- 可用的 `soul` 示例包括 `professional`、`playful`、`anime`、`pirate`、`caveman`、`ceo`
 - 支持 planner、coder、reviewer、tester 多角色 sub-agent
 
 ### 快速开始

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codemini-cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Coding CLI optimized for small-model workflows and Windows PowerShell",
   "keywords": [
     "cli",

package/skills/brainstorm/SKILL.md

@@ -4,34 +4,28 @@ description: Lightweight brainstorming skill for 30B-class models. Use when a fe
 version: 0.1.0
 ---
 
-Use this skill before adding new behavior, new features, or meaningful workflow changes.
+Use this skill only when the task needs clarification or option comparison before coding.
 
-Primary purpose:
-- stop premature coding when the request is still fuzzy
-- narrow the decision to a small number of approaches
-- leave with one chosen direction
+Core rules:
+- ask one question at a time
+- if a key uncertainty remains, ask the next best question and stop
+- give 2-3 short options only when the blocking constraint is already clear
+- keep options concrete and focused on the main tradeoff
+- present any conclusion as a suggested decision, not a final choice for the user
+- stop at the decision point unless the user clearly asks to continue
+- do not write code, pseudo-code, file edits, or broad repo exploration while direction is still being chosen
 
-Rules:
-
-1. Ask one question at a time.
-Do not dump a long questionnaire. Pick the most important uncertainty and resolve it first.
-
-2. Stay concrete.
-Focus on purpose, constraints, success criteria, and what should be intentionally left out.
+Output format:
 
-3. Offer 2-3 approaches.
-Keep each option short. Lead with the recommended option and say why.
+Mode A: key constraint missing
 
-4. Keep the design small.
-Write only enough design for the current scope. Do not inflate a simple task into a full spec process unless needed.
+Question:
+- ask:
+- why this matters:
 
-5. Confirm before implementation.
-Summarize the chosen direction in a few bullets or a short paragraph, then move to execution only after alignment.
+Wait for the user's answer.
 
-6. No code before convergence.
-Do not write implementation code, pseudo-code, or file edits while the direction is still being chosen.
-
-Output format:
+Mode B: goal is clear but approach choice remains
 
 Option 1:
 - idea:
@@ -48,22 +42,9 @@ Option 3 (optional):
 - pros:
 - cons:
 
-Decision:
-- chosen:
+Suggested decision:
+- recommended:
 - reason:
 
-After decision:
-- stop after the chosen direction unless the user clearly asks to continue into implementation
-
-Suggested flow:
-- Restate the task briefly
-- Ask the next best question when a key uncertainty blocks implementation
-- Propose options with tradeoffs
-- Confirm the chosen approach
-- Stop at a clear decision point
-
-Avoid:
-- large ceremonies
-- repeating the full conversation
-- asking multiple independent questions in one turn
-- proposing implementation details before the problem is clear
+After suggested decision:
+- stop after the recommended direction unless the user clearly asks to continue into implementation

package/skills/superpowers-lite/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: superpowers-lite
-description: Concise workflow skill tuned for 30B-class models: search first, keep context tight, use sub-agents for narrow tasks, and verify before claiming success.
+description: Concise workflow skill tuned for 30B-class models: prefer structured code tools first, keep context tight, use sub-agents for narrow tasks, and verify before claiming success.
 version: 0.1.0
 ---
 
@@ -12,10 +12,38 @@ Primary behavior:
 - keep edits local
 - verify before claiming success
 
+Routing:
+
+1. If the task is clear, small, and the implementation path is obvious:
+- execute directly
+- do not force brainstorming
+
+2. If the goal is clear but there are multiple reasonable implementation paths:
+- use `brainstorm`
+- give 2-3 short options
+- do not choose for the user unless the user explicitly asks for a recommendation
+
+3. If the request is still missing a key constraint or success condition:
+- ask exactly one clarifying question
+- do not give options yet
+- do not write code yet
+
+4. If the request is greenfield and underspecified, such as "build a page", "make a site", "generate an app", or similar:
+- treat it as missing key constraints by default
+- ask one high-value question before coding
+- do not assume features, storage model, or scope unless the user already gave them
+
+Tool order:
+- prefer `locate` first for repo search and candidate discovery
+- use `open_target` to inspect the smallest useful code block with edit metadata
+- use `edit_target` for minimal validated edits
+- use `search_code`, `read_block`, and `read_symbol_context` when lower-level structured context is needed
+- use shell search such as `rg` only as a fallback when structured tools are not enough
+
 Core rules:
 
 1. Search first.
-Use `rg` for repo search before broad file reads. Prefer local context commands and read only the smallest useful slice.
+Prefer structured search before broad file reads. Start with `locate`, then inspect with `open_target`, and only fall back to shell search such as `rg` when the structured tools are not enough.
 
 2. Keep context tight.
 Do not carry full conversation history into every step. Summarize, narrow scope, and work from the most recent relevant evidence.
@@ -28,21 +56,24 @@ When a task can be split cleanly, use sub-agents for bounded subtasks so the mai
 - a concrete expected output
 
 4. Do not code against unclear requirements.
-If the requested behavior, scope, or acceptance is unclear, do not jump into implementation. Ask the next best question or use `brainstorm` to compare a few small options and converge first.
+If the requested behavior, scope, or acceptance is unclear, do not jump into implementation. First decide which of these applies:
+- missing key constraint -> ask one question
+- multiple valid approaches -> use `brainstorm`
+- clear enough to build -> proceed
 
 5. Read and write with intent.
-Use `read_file` only when shell output is not enough. Use `write_file` for edits. Avoid unnecessary tool calls and avoid rereading the same file without a reason.
+Use `open_target`, `read_block`, and `read_symbol_context` before `read_file` when possible. Use `edit_target` for focused edits. Use `write_file` only for full-file writes. Avoid unnecessary tool calls and avoid rereading the same file without a reason.
 
 6. Verify before claiming success.
 Run the relevant test, check, or command before saying work is fixed or complete.
 
 Default workflow:
-- Search with `rg`
-- Inspect local context
-- If the request is unclear, pause for clarification or brainstorm
+- Search with `locate`
+- Inspect local context with `open_target`
+- If the request is unclear, first decide: ask one question, brainstorm, or proceed
 - Plan the next smallest step
 - Delegate if the work is independent
-- Edit
+- Edit with `edit_target`
 - Verify
 - Summarize briefly
 

package/souls/caveman.md

@@ -0,0 +1,3 @@
+Respond with a simple caveman-inspired tone.
+Keep sentences short, readable, and practical, while still preserving technical accuracy.
+Do not make the wording so primitive that instructions become unclear.

package/souls/ceo.md

@@ -0,0 +1,3 @@
+Respond with a bold CEO-style tone.
+Keep the answer concise, forward-moving, and focused on fundamentals, tradeoffs, and execution.
+Do not imitate any real person, and do not let the style override careful technical judgment.

package/souls/pirate.md

@@ -0,0 +1,3 @@
+Respond with a playful pirate-inspired tone.
+Keep the answer clear, useful, and technically accurate first, with light nautical flavor.
+Do not overdo slang, and do not let the roleplay reduce precision.

package/src/cli.js

@@ -4,7 +4,7 @@ import { handleConfig } from './commands/config.js';
 import { handleDoctor } from './commands/doctor.js';
 import { handleSkill } from './commands/skill.js';
 
-const VERSION = '0.1.15';
+const VERSION = '0.1.17';
 
 function printHelp() {
   console.log(`codemini ${VERSION}

package/src/core/chat-runtime.js

@@ -572,14 +572,19 @@ function selectAutoSkillNames(text = '') {
   const explicitBrainstorm =
     /(brainstorm|头脑风暴|方案|思路|设计一下|设计方案|怎么做|如何做|approach|options?)/i.test(input);
   const ambiguitySignals =
-    /(not sure|unsure|unclear|help me think|let'?s think|should we|which (?:approach|option|way)|best way|trade-?off|vs\b|versus|or should|要不要|不确定|不明确|先别写|先不要写|先讨论|先想一下|哪个方案|怎么设计|如何设计|取舍|还是)/i.test(
+    /(not sure|unsure|unclear|help me think|let'?s think|should we|which (?:approach|option|way)|best way|trade-?off|vs\b|versus|or should|maybe|roughly|just something simple|要不要|不确定|不明确|先别写|先不要写|先讨论|先想一下|哪个方案|怎么设计|如何设计|取舍|还是|大概|先做个|做一个简单的|先来个)/i.test(
       input
     );
   const featureRequest =
-    /\b(add|build|create|implement|support|introduce|design|refactor|change|update)\b/i.test(input) ||
-    /(新增|增加|实现|支持|设计|重构|改造|调整)/i.test(input);
+    /\b(add|build|create|generate|make|implement|support|introduce|design|refactor|change|update)\b/i.test(input) ||
+    /(新增|增加|实现|支持|设计|重构|改造|调整|生成|做一个|做个|创建)/i.test(input);
+  const greenfieldBuildRequest =
+    (/\b(build|create|generate|make)\b/i.test(input) || /(生成|做一个|做个|创建)/i.test(input)) &&
+    /(\b(project|app|site|website|page|dashboard|tool|component|landing page|html page)\b|项目|应用|网页|页面|网站|工具|组件|看板)/i.test(
+      input
+    );
 
-  if (explicitBrainstorm || (ambiguitySignals && featureRequest)) {
+  if (explicitBrainstorm || (ambiguitySignals && featureRequest) || greenfieldBuildRequest) {
     selected.push('brainstorm');
   }
   return selected;
@@ -2537,6 +2542,10 @@ export async function createChatRuntime({
         custom.name === 'brainstorm'
           ? [
               renderCommandPrompt(custom, []),
+              'Explicit brainstorm mode:',
+              '- Ask exactly one clarifying question first if any important uncertainty remains.',
+              '- Do not inspect the repo or generate code unless the user explicitly asks for that.',
+              '- If you recommend an option, present it as a suggested decision rather than a final choice for the user.',
               parsedInput.args.length > 0 ? `Current question:\n${parsedInput.args.join(' ')}` : ''
             ]
               .filter(Boolean)

package/src/core/command-policy.js

@@ -16,13 +16,13 @@ function suggestionForToken(token, config) {
   const shell = String(config?.shell?.default || '').toLowerCase();
   if (token === 'find' || token === 'grep') {
     return shell === 'powershell'
-      ? 'Use allowed search and context commands such as Get-ChildItem, Select-String, Get-Content, or rg when available.'
-      : 'Use allowed search and context commands such as rg, find, grep, sed, cat, or ls.';
+      ? 'Prefer structured tools like locate and open_target first. If you need shell fallback, use allowed search and context commands such as Get-ChildItem, Select-String, Get-Content, or rg when available.'
+      : 'Prefer structured tools like locate and open_target first. If you need shell fallback, use allowed search and context commands such as rg, find, grep, sed, cat, or ls.';
   }
   if (shell === 'powershell') {
-    return 'Use allowed shell commands for search and local context such as Get-ChildItem, Get-Content, Select-String, or rg when available.';
+    return 'Prefer structured tools like locate, open_target, and edit_target first. If you need shell fallback, use allowed shell commands for search and local context such as Get-ChildItem, Get-Content, Select-String, or rg when available.';
   }
-  return 'Use allowed shell commands for search and local context such as rg, find, grep, sed, cat, or ls.';
+  return 'Prefer structured tools like locate, open_target, and edit_target first. If you need shell fallback, use allowed shell commands for search and local context such as rg, find, grep, sed, cat, or ls.';
 }
 
 export function evaluateCommandPolicy(command, config, workspaceRoot = process.cwd()) {