@dtt_siye/atool 1.3.0 → 1.4.0

package/VERSION

@@ -1 +1 @@
-1.3.0
+1.4.0

package/hooks/doc-sync-reminder

@@ -36,8 +36,8 @@ main() {
         FILE_PATH=$(printf '%s' "$INPUT" | grep -oE '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//;s/"$//' || echo "")
     fi
 
-    # Only respond to Write/Edit
-    if [[ "$TOOL_NAME" != "Write" && "$TOOL_NAME" != "Edit" ]]; then
+    # Only respond to Write/Edit/MultiEdit
+    if [[ "$TOOL_NAME" != "Write" && "$TOOL_NAME" != "Edit" && "$TOOL_NAME" != "MultiEdit" ]]; then
         exit 0
     fi
 
@@ -120,9 +120,9 @@ main() {
         fi
     fi
 
-    # If no stale doc detection available, always remind (conservative)
+    # If no stale doc detection available, exit silently (consistent with task-state-tracker fallback)
     if ! $_LIB_FOUND; then
-        STALE=true
+        exit 0
     fi
 
     if ! $STALE; then

package/hooks/hooks-cursor.json

@@ -22,6 +22,17 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.cursor/hooks/atool-pre-commit"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
@@ -31,6 +42,15 @@
             "command": "bash ~/.cursor/hooks/atool-doc-sync-reminder"
           }
         ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.cursor/hooks/atool-task-state-tracker"
+          }
+        ]
       }
     ]
   }

package/hooks/hooks.json

@@ -22,15 +22,35 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.claude/hooks/atool-pre-commit"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
-        "matcher": "Write|Edit",
+        "matcher": "Write|Edit|MultiEdit",
         "hooks": [
           {
             "type": "command",
             "command": "bash ~/.claude/hooks/atool-doc-sync-reminder"
           }
         ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.claude/hooks/atool-task-state-tracker"
+          }
+        ]
       }
     ]
   }

package/hooks/pre-commit

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+# aTool - hooks/pre-commit
+# PreToolUse hook: enforces quality standards before git commit
+# Checks: TODO/FIXME leftovers, sensitive files, conventional commits, large files
+
+set -euo pipefail
+
+# Detect which IDE is running this hook
+HOOK_IDE="claude"
+if [[ -n "${CURSOR_PLUGIN_ROOT:-}" ]]; then
+    HOOK_IDE="cursor"
+fi
+
+# Escape string for JSON embedding
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+# Read JSON from stdin (Claude Code provides tool input on stdin)
+INPUT=""
+if [[ ! -t 0 ]]; then
+    INPUT=$(cat)
+fi
+
+# Extract tool_name and command from tool input
+TOOL_NAME=""
+TOOL_INPUT=""
+if command -v jq &>/dev/null && [[ -n "$INPUT" ]]; then
+    TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null || echo "")
+    TOOL_INPUT=$(printf '%s' "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null || echo "")
+fi
+
+# Only intercept git commit commands
+if [[ "$TOOL_NAME" != "Bash" ]]; then
+    exit 0
+fi
+if [[ -z "$TOOL_INPUT" ]]; then
+    exit 0
+fi
+
+# Check if this is a git commit command
+TOOL_INPUT_LOWER=$(printf '%s' "$TOOL_INPUT" | tr '[:upper:]' '[:lower:]')
+IS_GIT_COMMIT=false
+if printf '%s' "$TOOL_INPUT_LOWER" | grep -qE 'git\s+commit'; then
+    IS_GIT_COMMIT=true
+fi
+
+if ! $IS_GIT_COMMIT; then
+    exit 0
+fi
+
+# ── Pre-commit checks ─────────────────────────────────────────────────────
+
+WARNINGS=""
+CHECKS_FAILED=0
+PROJECT_DIR="${PWD:-}"
+
+# 1. Check for TODO/FIXME in staged files (AI "lazy" patterns)
+TODO_COUNT=0
+if command -v git &>/dev/null && git rev-parse --is-inside-work-tree &>/dev/null; then
+    STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM 2>/dev/null || echo "")
+    if [[ -n "$STAGED_FILES" ]]; then
+        for file in $STAGED_FILES; do
+            if [[ -f "$PROJECT_DIR/$file" ]]; then
+                local_count=$(grep -cE '(TODO|FIXME|HACK|XXX)' "$PROJECT_DIR/$file" 2>/dev/null || echo "0")
+                if [[ "$local_count" -gt 0 ]]; then
+                    TODO_COUNT=$((TODO_COUNT + local_count))
+                fi
+            fi
+        done
+    fi
+fi
+
+if [[ "$TODO_COUNT" -gt 0 ]]; then
+    WARNINGS+="- Found ${TODO_COUNT} TODO/FIXME/HACK/XXX marker(s) in staged files. Consider resolving before commit.\n"
+    CHECKS_FAILED=$((CHECKS_FAILED + 1))
+fi
+
+# 2. Check for sensitive files in staged changes
+SENSITIVE_PATTERNS="(\.env$|\.env\.|credentials|\.pem$|\.key$|secret|\.p12$|\.pfx$|id_rsa|id_ed25519|\.npmrc$|\.pypirc$)"
+SENSITIVE_FOUND=""
+if command -v git &>/dev/null && git rev-parse --is-inside-work-tree &>/dev/null; then
+    if [[ -n "${STAGED_FILES:-}" ]]; then
+        for file in $STAGED_FILES; do
+            if printf '%s' "$file" | grep -qE "$SENSITIVE_PATTERNS" 2>/dev/null; then
+                if [[ -z "$SENSITIVE_FOUND" ]]; then
+                    SENSITIVE_FOUND="$file"
+                else
+                    SENSITIVE_FOUND="$SENSITIVE_FOUND, $file"
+                fi
+            fi
+        done
+    fi
+fi
+
+if [[ -n "$SENSITIVE_FOUND" ]]; then
+    WARNINGS+="- BLOCKED: Sensitive file(s) detected in commit: ${SENSITIVE_FOUND}. Do NOT commit secrets.\n"
+    CHECKS_FAILED=$((CHECKS_FAILED + 10))  # High severity
+fi
+
+# 3. Check conventional commit message format
+# Note: PreToolUse hook runs BEFORE commit happens, so we can only extract from command line.
+# However, commit message extraction from bash command is unreliable for heredoc format.
+# This check is best-effort only. Use PostToolUse hook for reliable validation after commit.
+COMMIT_MSG=""
+if printf '%s' "$TOOL_INPUT" | grep -qE '\-m'; then
+    # Try to extract message after -m flag (only works for simple quoted messages)
+    COMMIT_MSG=$(printf '%s' "$TOOL_INPUT" | sed -n 's/.*-m[[:space:]]*\(['"'"'"][^'"'"'"]*['"'"'"]\|"[^"]*"\|\S\+\).*/\1/p' 2>/dev/null | head -1 || echo "")
+    # Strip surrounding quotes
+    COMMIT_MSG="${COMMIT_MSG#\"}"
+    COMMIT_MSG="${COMMIT_MSG%\"}"
+    COMMIT_MSG="${COMMIT_MSG#\'}"
+    COMMIT_MSG="${COMMIT_MSG%\'}"
+fi
+
+# Only warn if message extraction succeeded AND it doesn't match pattern
+# (If extraction fails, skip validation — will be checked post-commit by PostToolUse hook)
+if [[ -n "$COMMIT_MSG" ]] && [[ ! "$COMMIT_MSG" =~ \$\(cat ]]; then
+    CONVENTIONAL_PATTERN='^(feat|fix|docs|test|refactor|chore|style|perf|build|ci|revert|release)(\(.+\))?:'
+    if ! printf '%s' "$COMMIT_MSG" | grep -qE "$CONVENTIONAL_PATTERN" 2>/dev/null; then
+        WARNINGS+="- Commit message does not follow Conventional Commits: '${COMMIT_MSG}'\n"
+        WARNINGS+="  Expected: feat|fix|docs|test|refactor|chore|style|perf|build|ci|revert|release[(scope)]: description\n"
+        # This is a warning, not a hard block
+    fi
+else
+    # If commit message extraction failed or detected heredoc, add note about post-validation
+    if printf '%s' "$TOOL_INPUT" | grep -qE '\-m.*\$\(cat'; then
+        WARNINGS+="- INFO: Using heredoc commit message format. Conventional Commits validation will be performed post-commit.\n"
+    fi
+fi
+
+# 4. Check for large files (> 1MB) in staged changes
+LARGE_FILES=""
+if command -v git &>/dev/null && git rev-parse --is-inside-work-tree &>/dev/null; then
+    if [[ -n "${STAGED_FILES:-}" ]]; then
+        for file in $STAGED_FILES; do
+            if [[ -f "$PROJECT_DIR/$file" ]]; then
+                file_size=$(wc -c < "$PROJECT_DIR/$file" 2>/dev/null || echo "0")
+                # 1MB = 1048576 bytes
+                if [[ "$file_size" -gt 1048576 ]]; then
+                    size_mb=$((file_size / 1048576))
+                    if [[ -z "$LARGE_FILES" ]]; then
+                        LARGE_FILES="$file (${size_mb}MB)"
+                    else
+                        LARGE_FILES="$LARGE_FILES, $file (${size_mb}MB)"
+                    fi
+                fi
+            fi
+        done
+    fi
+fi
+
+if [[ -n "$LARGE_FILES" ]]; then
+    WARNINGS+="- WARNING: Large file(s) in commit: ${LARGE_FILES}. Consider using .gitattributes or Git LFS.\n"
+fi
+
+# ── Output ────────────────────────────────────────────────────────────────
+
+if [[ "$CHECKS_FAILED" -gt 0 ]] || [[ -n "$WARNINGS" ]]; then
+    SEVERITY="WARNING"
+    if [[ "$CHECKS_FAILED" -ge 10 ]]; then
+        SEVERITY="BLOCKED"
+    fi
+
+    _MSG="<ATOOL-PRE-COMMIT-CHECK>\n"
+    _MSG+="${SEVERITY}: Pre-commit quality checks found issues:\n\n"
+    _MSG+="$WARNINGS"
+    _MSG+="\n"
+
+    if [[ "$SEVERITY" == "BLOCKED" ]]; then
+        _MSG+="**This commit is BLOCKED.** Fix the critical issues above before proceeding.\n"
+    else
+        _MSG+="Please review the warnings above. You may proceed if they are acceptable, but consider addressing them.\n"
+    fi
+    _MSG+="</ATOOL-PRE-COMMIT-CHECK>"
+
+    if [[ "$HOOK_IDE" == "cursor" ]]; then
+        _ESCAPED=$(escape_for_json "$_MSG")
+        printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "PreToolUse",\n    "additionalContext": "%s"\n  }\n}\n' "$_ESCAPED"
+    else
+        printf '%b' "$_MSG"
+    fi
+fi
+
+exit 0

package/hooks/prompt-guard

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # aTool - hooks/prompt-guard
-# Lightweight UserPromptSubmit hook: reminds AI to clarify before implementing
-# Skips short/trivial prompts, triggers on substantial implementation requests
+# UserPromptSubmit hook: reminds AI to clarify before implementing
+# v2: Tightened skip conditions, structured template injection for Tier 2+
 
 set -euo pipefail
 
@@ -57,45 +57,41 @@ if printf '%s' "$PROMPT" | LC_ALL=C grep -q '[一-龥]' 2>/dev/null; then
     HAS_CJK=true
 fi
 
-# 1. Short messages
-if $HAS_CJK && [[ "$PROMPT_LEN" -lt 8 ]]; then
+# 1. Short messages — TIGHTENED: lower thresholds
+#    Old: CJK < 8, Latin < 20
+#    New: CJK < 6, Latin < 15 (pure short replies like "ok", "好")
+if $HAS_CJK && [[ "$PROMPT_LEN" -lt 6 ]]; then
     exit 0
-elif ! $HAS_CJK && [[ "$PROMPT_LEN" -lt 20 ]]; then
+elif ! $HAS_CJK && [[ "$PROMPT_LEN" -lt 15 ]]; then
     exit 0
 fi
 
-# 2. Follow-up replies (affirmative, no new intent)
-FOLLOW_UP_PATTERNS="^(yes|ok|okay|好的|继续|继续做|go ahead|sure|yep|yeah|pls|please|go on|继续吧|对|嗯|是的|行|可以)$"
-if printf '%s' "$PROMPT_LOWER" | grep -qE "$FOLLOW_UP_PATTERNS" 2>/dev/null; then
+# 2. Pure confirmations only — TIGHTENED: strict single-word matches
+#    Old: included multi-word phrases like "go ahead", "pls", "please"
+#    New: only exact single-word affirmative replies
+PURE_CONFIRMATIONS="^(yes|ok|okay|好的|继续|对|嗯|是的|行|可以|sure|yep|yeah|done|go|next)$"
+if printf '%s' "$PROMPT_LOWER" | grep -qE "$PURE_CONFIRMATIONS" 2>/dev/null; then
     exit 0
 fi
 
-# 3. User asking a question (ends with ? or ？)
-if printf '%s' "$PROMPT" | grep -qE '[?？]$' 2>/dev/null; then
-    exit 0
-fi
-
-# 4. Meta-commands (non-implementation requests)
-# Note: Ambiguous words like "build", "test", "deploy" are NOT listed here
-# because they could be feature requests (e.g., "build a dashboard")
-META_COMMANDS="^(commit|git |run |npm |yarn |pnpm |bun |cargo |go run|python |pytest|jest|vitest|explain|diff |show |list |check |lint |format |log |tail |grep |find |cat |head )"
-if printf '%s' "$PROMPT_LOWER" | grep -qE "$META_COMMANDS" 2>/dev/null; then
-    exit 0
-fi
-
-# 5. Exit signals (user wants to skip clarification)
+# 3. Exit signals (user explicitly wants to skip clarification) — KEPT as-is
 EXIT_SIGNALS="(别问了|不要问|别再问|直接做|直接实现|直接开始|不用确认|跳过提问|不要确认|just do it|stop asking|no questions|don.t ask|skip asking|go ahead and implement)"
 if printf '%s' "$PROMPT_LOWER" | grep -qE "$EXIT_SIGNALS" 2>/dev/null; then
     exit 0
 fi
 
-# ── Trigger conditions ───────────────────────────────────────────────────
+# ── REMOVED: Old skip conditions that were too broad ───────────────────────
+# OLD: "Questions ending with ?" → REMOVED (questions like "能帮我实现一个搜索功能吗？" should trigger)
+# OLD: "Meta-commands (commit, run, npm, explain...)" → REMOVED
+#      ("build a dashboard" starts with "build" but is a feature request)
+#      ("run the migration to add new user fields" is an implementation request)
+
+# ── Classify task complexity ──────────────────────────────────────────────
 
 # Count words: for CJK text (no spaces), count CJK chars as words;
 # for Latin text, count whitespace-separated tokens
 WORD_COUNT=0
 if $HAS_CJK; then
-    # CJK: count CJK characters (use LC_ALL=C for locale safety)
     CJK_COUNT=$(printf '%s' "$PROMPT" | LC_ALL=C grep -o '[一-龥]' 2>/dev/null | wc -l | tr -d '[:space:]')
     WORD_COUNT=$((CJK_COUNT))
 else
@@ -104,25 +100,78 @@ else
     done
 fi
 
-# Trigger: sufficient length + enough words/CJK chars + implementation keyword
-IMPLEMENT_KEYWORDS="(开发|创建|新增|实现|添加|加个|做一个|写一个|build|create|add|implement|make|develop|design|feature|refactor|extract|integrate|support|handle)"
+# Detect implementation intent keywords
+# Extended with common natural language patterns (CJK + English)
+IMPLEMENT_KEYWORDS="(开发|创建|新增|实现|添加|加个|做一个|写一个|重构|优化|修改|调整|修复|集成|迁移|设计|拆分|改造|搭建|编写|扩展|帮我|需要|能不能|可以|请|麻烦|给我|加上|看看|想要|build|create|add|implement|make|develop|design|feature|refactor|extract|integrate|support|handle|fix|migrate|modify|update|change|enhance|improve|help.me|show.me|please|create.a|build.a|write.a|let.me|could.you|can.you)"
+
+HAS_IMPLEMENT=false
 LENGTH_OK=false
-if $HAS_CJK && [[ "$PROMPT_LEN" -ge 8 ]]; then
+
+if $HAS_CJK && [[ "$PROMPT_LEN" -ge 6 ]]; then
     LENGTH_OK=true
-elif ! $HAS_CJK && [[ "$PROMPT_LEN" -ge 20 ]]; then
+elif ! $HAS_CJK && [[ "$PROMPT_LEN" -ge 15 ]]; then
     LENGTH_OK=true
 fi
 
-if $LENGTH_OK && [[ "$WORD_COUNT" -gt 5 ]] && \
-   printf '%s' "$PROMPT_LOWER" | grep -qE "$IMPLEMENT_KEYWORDS" 2>/dev/null; then
-    _REMINDER='<system-reminder>
+if printf '%s' "$PROMPT_LOWER" | grep -qE "$IMPLEMENT_KEYWORDS" 2>/dev/null; then
+    HAS_IMPLEMENT=true
+fi
+
+# ── Determine tier and output ─────────────────────────────────────────────
+
+if $LENGTH_OK && $HAS_IMPLEMENT && [[ "$WORD_COUNT" -gt 3 ]]; then
+    # Determine complexity tier
+    TIER=0
+
+    # Tier 3 indicators: architecture-level, multi-module, system-wide
+    TIER3_KEYWORDS="(架构|系统|整体|全面|重新设计|从零|微服务|拆分|architecture|system.redesign|from scratch|microservice|monolith|break down|overhaul)"
+    # Tier 2 indicators: new feature, multi-step, unclear scope
+    TIER2_KEYWORDS="(功能|模块|页面|组件|接口|服务|支持|feature|module|page|component|endpoint|service|support|workflow|pipeline|dashboard|integration)"
+
+    if printf '%s' "$PROMPT_LOWER" | grep -qE "$TIER3_KEYWORDS" 2>/dev/null; then
+        TIER=3
+    elif printf '%s' "$PROMPT_LOWER" | grep -qE "$TIER2_KEYWORDS" 2>/dev/null; then
+        TIER=2
+    else
+        TIER=1
+    fi
+
+    # Fallback tier escalation: if message has pronouns + concrete request context, bump tier
+    # This catches natural language requests without explicit keywords
+    if [[ "$TIER" -eq 1 ]] && [[ "$PROMPT_LEN" -gt 30 ]]; then
+        if printf '%s' "$PROMPT_LOWER" | grep -qE "(我|my|我们|our|帮|help|想|want|需要|need|能|can|可以|able)" 2>/dev/null; then
+            # Check if there are specific code/file references (suggests implementation request)
+            if printf '%s' "$PROMPT" | grep -qE "(\\.\\w+|/\\w+|\\{\\w+\\}|function|class|method|endpoint)" 2>/dev/null; then
+                TIER=2
+            fi
+        fi
+    fi
+
+    # Build tier-appropriate reminder
+    if [[ "$TIER" -ge 2 ]]; then
+        # Tier 2+: Structured template — require analysis before implementation
+        _REMINDER="<system-reminder>
+**TIER ${TIER} TASK DETECTED** — This is a ${TIER}-level task. Before writing ANY code:
+
+1. **Analyze** — Read relevant source files first (CLAUDE.md, package.json, existing patterns)
+2. **Classify** — Confirm complexity: Tier ${TIER} = $([ "$TIER" -eq 2 ] && echo "3-5 clarification questions" || echo "delegate to /brainstorming")
+3. **Clarify** — Ask context-aware questions about: $([ "$TIER" -eq 2 ] && echo "scope, edge cases, existing patterns, acceptance criteria" || echo "architecture, constraints, trade-offs, migration strategy")
+4. **Plan** — Write implementation plan BEFORE touching code
+
+Do NOT jump to implementation. Read first, ask second, plan third, code last.
+See /clarify-before-build for full methodology.
+</system-reminder>"
+    else
+        # Tier 1: Lightweight reminder
+        _REMINDER='<system-reminder>
 Before implementing, classify task complexity and clarify requirements if needed:
-- Tier 0 (direct): single-value change → just do it
-- Tier 1 (1-2 questions): small change with ambiguity → ask key questions
-- Tier 2 (3-5 questions): new feature → read project files first, then ask context-aware questions
-- Tier 3: architecture-level → delegate to /brainstorming
+- Tier 0 (direct): single-value change, typo, format fix -> just do it
+- Tier 1 (1-2 questions): small change with ambiguity -> ask key questions
+- Tier 2 (3-5 questions): new feature, medium complexity -> structured clarification
+- Tier 3: architecture-level, vague requirements -> delegate to /brainstorming
 See /clarify-before-build for full methodology.
 </system-reminder>'
+    fi
 
     if [[ "$HOOK_IDE" == "cursor" ]]; then
         _ESCAPED=$(escape_for_json "$_REMINDER")

package/hooks/session-start

@@ -245,26 +245,48 @@ if [[ -n "$DOC_SYNC" ]]; then
     INJECTION+=$'\n\n'
 fi
 
-INJECTION+="<ATOOL-CLARIFY-RULE>"
-INJECTION+=$'\n'
-INJECTION+="Before implementing ANY feature, first classify task complexity:"
-INJECTION+=$'\n'
-INJECTION+="Tier 0 (direct): single-value change, typo, format fix -> just do it"
+# Only inject clarify rule if in a code project (detected by presence of common project files)
+if [[ -f "package.json" || -f "pom.xml" || -f "go.mod" || -f "Cargo.toml" || -f "requirements.txt" || -f "build.gradle" || -f ".gradle" || -f "setup.py" || -f "Gemfile" ]]; then
+    INJECTION+="<ATOOL-CLARIFY-RULE>"
+    INJECTION+=$'\n'
+    INJECTION+="Before implementing ANY feature, first classify task complexity:"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 0 (direct): single-value change, typo, format fix -> just do it"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 1 (1-2 questions): small change with ambiguity -> ask key questions"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 2 (3-5 questions): new feature, medium complexity -> structured clarification"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 3: architecture-level, vague requirements -> delegate to /brainstorming"
+    INJECTION+=$'\n'
+    INJECTION+="Rules: Read project files BEFORE asking (CLAUDE.md, package.json, source code). Never assume installed libs or existing patterns. Ask context-aware questions, not obvious ones."
+    INJECTION+=$'\n'
+    INJECTION+="Exit: If user says '别问了'/'直接做'/'just do it'/'stop asking' -> skip all questions, Tier 0."
+    INJECTION+=$'\n'
+    INJECTION+="See /clarify-before-build for full methodology."
+    INJECTION+=$'\n'
+    INJECTION+="</ATOOL-CLARIFY-RULE>"
+    INJECTION+=$'\n'
+fi
+
+# Inject language rule (always, for all projects)
+INJECTION+="<ATOOL-LANGUAGE-RULE>"
 INJECTION+=$'\n'
-INJECTION+="Tier 1 (1-2 questions): small change with ambiguity -> ask key questions"
+INJECTION+="语言要求 (Language Requirement):"
 INJECTION+=$'\n'
-INJECTION+="Tier 2 (3-5 questions): new feature, medium complexity -> structured clarification"
+INJECTION+="- 项目文档 (docs/, README, 架构指南): 必须中文"
 INJECTION+=$'\n'
-INJECTION+="Tier 3: architecture-level, vague requirements -> delegate to /brainstorming"
+INJECTION+="- SKILL.md: 保持英文（AI 指令文件）"
 INJECTION+=$'\n'
-INJECTION+="Rules: Read project files BEFORE asking (CLAUDE.md, package.json, source code). Never assume installed libs or existing patterns. Ask context-aware questions, not obvious ones."
+INJECTION+="- Commit message: 推荐中文"
 INJECTION+=$'\n'
-INJECTION+="Exit: If user says '别问了'/'直接做'/'just do it'/'stop asking' -> skip all questions, Tier 0."
+INJECTION+="- 代码注释: 可中文或英文（跟随代码风格）"
 INJECTION+=$'\n'
-INJECTION+="See /clarify-before-build for full methodology."
+INJECTION+="如果误用英文写项目文档，请用 /doc-coauthoring 重写为中文。"
 INJECTION+=$'\n'
-INJECTION+="</ATOOL-CLARIFY-RULE>"
+INJECTION+="</ATOOL-LANGUAGE-RULE>"
 INJECTION+=$'\n'
+
 INJECTION+="</ATOOL-SESSION>"
 INJECTION+=$'\n'
 INJECTION+="</EXTREMELY_IMPORTANT>"

package/hooks/task-state-tracker

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+# aTool - hooks/task-state-tracker
+# PostToolUse hook: tracks session-level task state for feedback loop
+# Records: modified files, doc staleness, verification status, pending actions
+# State file: .claude/task-state.json (session-scoped, gitignored)
+
+set -euo pipefail
+
+# Escape string for JSON embedding
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+# ── Read tool input ───────────────────────────────────────────────────────
+
+INPUT=""
+if [[ ! -t 0 ]]; then
+    INPUT=$(cat)
+fi
+
+TOOL_NAME=""
+FILE_PATH=""
+if command -v jq &>/dev/null && [[ -n "$INPUT" ]]; then
+    TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null || echo "")
+    FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null || echo "")
+fi
+
+# Only respond to Write/Edit
+if [[ "$TOOL_NAME" != "Write" && "$TOOL_NAME" != "Edit" ]]; then
+    exit 0
+fi
+if [[ -z "$FILE_PATH" ]]; then
+    exit 0
+fi
+
+# ── Source file detection ────────────────────────────────────────────────
+
+FILE_EXT="${FILE_PATH##*.}"
+FILE_BASE=$(basename "$FILE_PATH")
+
+# Skip non-source files (same logic as doc-sync-reminder)
+case "$FILE_EXT" in
+    md|markdown|txt|rst) exit 0 ;;
+    json|yaml|yml|toml|xml) exit 0 ;;
+    css|scss|less|sass|styl) exit 0 ;;
+    lock|map|log) exit 0 ;;
+    svg|png|jpg|jpeg|gif|ico|webp|ttf|woff|woff2|eot) exit 0 ;;
+esac
+case "$FILE_BASE" in
+    .*|*.config.*) exit 0 ;;
+esac
+case "$FILE_EXT" in
+    ts|tsx|js|jsx|vue|svelte|html|rs|py|go|java|kt|kts|swift|dart|ets|sh|bash) ;;
+    *) exit 0 ;;
+esac
+
+# ── State management ──────────────────────────────────────────────────────
+
+# Require jq
+if ! command -v jq &>/dev/null; then
+    exit 0
+fi
+
+NOW=$(date +%s 2>/dev/null || echo "0")
+STATE_FILE=".claude/task-state.json"
+MAX_TRACKED_FILES=50
+
+# Initialize state file if needed
+if [[ ! -f "$STATE_FILE" ]]; then
+    mkdir -p ".claude" 2>/dev/null || true
+    printf '{"session_id":"","modified_files":[],"docs_stale":false,"verification_passed":false,"pending_actions":[],"architecture_violations":0,"created_at":%s,"updated_at":%s}\n' "$NOW" "$NOW" > "$STATE_FILE"
+fi
+
+# Read current state
+STATE=$(cat "$STATE_FILE" 2>/dev/null || echo "{}")
+
+# Update: add file, set docs_stale=true, reset verification, update timestamp
+NEW_STATE=$(printf '%s' "$STATE" | jq \
+    --arg fp "$FILE_PATH" \
+    --argjson now "$NOW" \
+    '
+    # Add file if not already tracked
+    if (.modified_files | map(select(.path == $fp)) | length) == 0 then
+        .modified_files += [{"path": $fp, "modified_at": $now}]
+    else
+        .modified_files = [.modified_files[] | if .path == $fp then .modified_at = $now else . end]
+    end
+    # Cap modified files to 50
+    | .modified_files = (.modified_files | sort_by(-.modified_at) | .[0:50])
+    # Mark docs as stale
+    | .docs_stale = true
+    # Reset verification since we made changes
+    | .verification_passed = false
+    # Ensure pending_actions includes doc update
+    | if (.pending_actions | index("update_docs") | not) then
+        .pending_actions += ["update_docs"]
+      else . end
+    | .updated_at = $now
+    ')
+
+printf '%s' "$NEW_STATE" | jq '.' > "$STATE_FILE" 2>/dev/null || true
+
+# ── Output feedback at milestones ─────────────────────────────────────────
+
+FILE_COUNT=$(jq '.modified_files | length' "$STATE_FILE" 2>/dev/null || echo "0")
+
+_MILESTONE=""
+# Milestone check: for every 5 files >= 10, show progress update
+if (( FILE_COUNT >= 10 && FILE_COUNT % 5 == 0 )); then
+    if (( FILE_COUNT == 10 )); then
+        _MILESTONE="<ATOOL-TASK-PROGRESS>
+Progress check: You have modified ${FILE_COUNT} source files. This is substantial.
+- Consider breaking your work into smaller, verifiable units
+- Docs are STALE and need updating
+- Run /verification-before-completion before claiming done
+</ATOOL-TASK-PROGRESS>"
+    else
+        _MILESTONE="<ATOOL-TASK-PROGRESS>
+Progress check: You have modified ${FILE_COUNT} source files.
+- This is a large refactoring. Consider intermediate commits/verification
+- Docs are STALE and need updating
+- Run /verification-before-completion to validate progress
+</ATOOL-TASK-PROGRESS>"
+    fi
+elif (( FILE_COUNT == 5 )); then
+    _MILESTONE="<ATOOL-TASK-PROGRESS>
+Progress check: You have modified ${FILE_COUNT} source files.
+- Docs are STALE and need updating
+- Verification has NOT been run since last changes
+Remember: Run /verification-before-completion before claiming done.
+</ATOOL-TASK-PROGRESS>"
+fi
+
+if [[ -n "$_MILESTONE" ]]; then
+    _ESCAPED=$(escape_for_json "$_MILESTONE")
+    printf '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":"%s"}}\n' "$_ESCAPED"
+fi
+
+exit 0