@elvis1513/auto-coding-skill 0.1.2 → 0.1.4

package/README.md

@@ -5,6 +5,9 @@ Framework-agnostic engineering workflow skill for:
 - Claude Code
 - Codex CLI
 
+This skill is scoped to Claude/Codex workflows. During development, it should prefer already available MCP servers, installed skills, plugins, and app connectors for design, research, documentation, verification, and external system updates.
+It should also prefer multi-agent execution whenever the work can be split into parallel subtasks safely.
+
 ## Install
 
 ```bash
@@ -22,8 +25,8 @@ npm install -g git+https://github.com/elvis1513/auto-coding-skill.git
 1. Install skill into project:
 
 ```bash
-autocoding init --ai codex
-# or claude / all
+autocoding init --ai all
+# or: --ai codex / --ai claude
 ```
 
 2. Initialize docs and local scripts:
@@ -36,13 +39,13 @@ python3 .claude/skills/auto-coding-skill/scripts/ap.py --repo . install
 
 3. Fill only one file manually:
 
-- `ENGINEERING.md` frontmatter
+- `docs/ENGINEERING.md` frontmatter
 
-This frontmatter is the only manual config source (commands + deployment + docs paths).
+This frontmatter is the only manual config source (commands + local Docker runtime + docs paths).
 
 4. Start AI development by constraints:
 
-- `ENGINEERING.md`
+- `docs/ENGINEERING.md`
 - `docs/tasks/taskbook.md`
 - `docs/design/**`
 - `docs/interfaces/**`
@@ -50,18 +53,88 @@ This frontmatter is the only manual config source (commands + deployment + docs
 - `docs/bugs/bug-list.md`
 - `docs/tasks/summaries/**`
 
+5. Tool selection rule during execution:
+
+- Prefer current MCP/skills/plugins/apps first.
+- Fall back to shell/manual work only when those capabilities are unavailable or insufficient.
+
+6. Collaboration rule during execution:
+
+- Prefer multi-agent mode.
+- Split research, design, implementation, validation, and documentation into parallel subtasks whenever the boundaries are clear.
+- Keep one main agent responsible for integration and final gates.
+
 ## AGENTS.md Constraint Example
 
 ```md
 ## Mandatory Skill
 - Always use `auto-coding-skill` for implementation tasks.
 - Before any code change, read and obey:
-  1) ENGINEERING.md
+  1) docs/ENGINEERING.md
   2) docs/tasks/taskbook.md
 - Execute gates using `python3 scripts/autopipeline/ap.py`.
 - If required docs are missing, create/update docs first, then code.
 ```
 
+## Docs Structure and Recording Rules
+
+### 1) docs/ENGINEERING.md
+- Purpose: single source of project config + engineering gate rules.
+- How to record:
+  - Fill YAML frontmatter once (project/commands/runtime/docs fields).
+  - Keep all local runtime info here only (compose file/service/container/image/health).
+  - Do not duplicate config in other docs.
+
+### 2) docs/deployment/
+- Files:
+  - `docs/deployment/deploy-runbook.md`: local Docker runtime procedure and validation checklist.
+  - `docs/deployment/deploy-records/<TASK_ID>-YYYYMMDD.md`: per-run local verification record.
+- How to record:
+  - In runtime record, write compose file, service, container, image/tag, env file, docker status, smoke/regression evidence.
+
+### 3) docs/design/
+- Files:
+  - `docs/design/<TASK_ID>-<slug>.md` (from DD template).
+- Purpose:
+  - Detailed design before coding (scope,方案、时序图、ER图、接口编排、测试策略、回滚).
+- How to record:
+  - One task/subtask one DD file.
+  - Status changes: Draft -> Reviewed -> Approved.
+
+### 4) docs/interfaces/
+- Files:
+  - `docs/interfaces/api.md`: authoritative API documentation (current contract).
+  - `docs/interfaces/api-change-log.md`: append-only API changes per task.
+- How to record:
+  - API changes must update both files in the same task.
+  - `api.md` records latest endpoint contract.
+  - `api-change-log.md` appends task-level delta (新增/修改/废弃/兼容策略/影响面).
+
+### 5) docs/reviews/
+- Files:
+  - `docs/reviews/<TASK_ID>-<timestamp>.md` (from review template).
+- Purpose:
+  - Gate review evidence: static checks, code quality, test quality, risks.
+- How to record:
+  - Record commands used (lint/typecheck from docs/ENGINEERING.md frontmatter) and conclusion (Pass/Blocked).
+
+### 6) docs/tasks/
+- Files:
+  - `docs/tasks/taskbook.md`: master task ledger (all tasks appended here).
+  - `docs/tasks/summaries/<TASK_ID>.md`: end-of-task summary artifact.
+- How to record:
+  - `taskbook.md` stores task scope/acceptance/subtasks/evidence links.
+  - `summaries/<TASK_ID>.md` stores final objective result, change overview, gate evidence, risks, follow-ups.
+
+### 7) docs/testing/
+- Files:
+  - `docs/testing/regression-matrix.md`
+- Purpose:
+  - Full regression matrix against the local runtime environment; must be 0 FAIL.
+- How to record:
+  - Add/maintain rows by regression ID (R-xxx), area, steps/command, expected, status, evidence.
+  - If any FAIL exists, gate fails.
+
 ## Commands
 
 ```bash
@@ -69,15 +142,24 @@ pip install pyyaml requests
 python3 scripts/autopipeline/ap.py run build
 python3 scripts/autopipeline/ap.py run test
 python3 scripts/autopipeline/ap.py run lint
+python3 scripts/autopipeline/ap.py run smoke
+python3 scripts/autopipeline/ap.py run regression
 python3 scripts/autopipeline/ap.py verify-api-docs
 python3 scripts/autopipeline/ap.py check-matrix
 python3 scripts/autopipeline/ap.py gen-summary T0001-1
 python3 scripts/autopipeline/ap.py commit-push T0001-1 --msg "T0001-1: <summary>" --require-matrix
 ```
 
-## Release New Version
+## Publish (NPM)
+
+1. Sync assets and basic check:
+
+```bash
+npm run sync-assets
+npm test
+```
 
-1. Bump version (cannot republish an existing version):
+2. Bump version (required before every publish):
 
 ```bash
 npm version patch
@@ -85,7 +167,9 @@ npm version patch
 # or: npm version major
 ```
 
-2. Login and pre-check:
+`npm version` will update `package.json` and create a git tag.
+
+3. Login and run release check:
 
 ```bash
 npm login
@@ -93,24 +177,36 @@ npm whoami
 npm run release:check
 ```
 
-3. Publish:
+4. Publish package:
 
 ```bash
+npm publish --access public
+# if your account requires 2FA OTP:
 npm publish --access public --otp <6-digit-otp>
 ```
 
-4. Verify release:
+5. Verify and update clients:
 
 ```bash
 npm view @elvis1513/auto-coding-skill version
-```
-
-5. Update installed clients:
-
-```bash
 npm install -g @elvis1513/auto-coding-skill@latest
 ```
 
+### Common Publish Errors
+
+- `403 You cannot publish over the previously published versions`
+  - Cause: same version already exists.
+  - Fix: run `npm version patch` (or `minor`/`major`) then publish again.
+- `403 Two-factor authentication ... is required to publish`
+  - Cause: publish requires 2FA.
+  - Fix: use `npm publish --access public --otp <6-digit-otp>`.
+- `404 Not Found` when install
+  - Cause: package not published successfully, or scope/name mismatch.
+  - Fix: verify with `npm view @elvis1513/auto-coding-skill version` first.
+- `Access token expired or revoked`
+  - Cause: npm auth token expired.
+  - Fix: run `npm login` again and retry publish/install.
+
 ## License
 
 MIT

package/cli/assets/skill/SKILL.md

@@ -1,15 +1,43 @@
 ---
 name: auto-coding-skill
-description: Use for strict project engineering workflow in Claude/Codex. Initialize docs, fill ENGINEERING.md frontmatter once, then execute design->implement->gates->summary->commit/push.
+description: Use for strict project engineering workflow in Claude/Codex. Initialize docs, fill docs/ENGINEERING.md frontmatter once, then execute design->implement->local-docker-gates->summary->commit/push.
 ---
 
 # Auto Coding Skill (Claude + Codex)
 
+This skill is a Claude/Codex-only engineering workflow. During design, research, implementation, verification, and delivery, prefer already available MCP servers, installed skills, plugins, and app connectors over ad-hoc manual work whenever they can complete the task reliably.
+
+Default to multi-agent execution when the client supports it. Break work into independent design, research, implementation, validation, and documentation subtasks so Claude/Codex can run them in parallel whenever that reduces cycle time without weakening control of the main task.
+
 ## Supported clients
 
 - Claude Code
 - Codex CLI
 
+## Tooling policy
+
+Use available platform capabilities first:
+
+1) Prefer installed MCP servers for design context, documentation lookup, browser automation, issue/docs systems, and deployment/runtime inspection.
+2) Prefer already installed local skills when the task matches them.
+3) Prefer supported plugins/apps/connectors when they provide authoritative project context or can write back records.
+4) Fall back to manual shell/code workflows only when the above are unavailable, insufficient, or slower than direct execution.
+
+Typical examples:
+- Design/UI work: prefer Figma MCP and related design skills.
+- Documentation/library lookup: prefer official docs and MCP-backed doc tools.
+- Project management or knowledge base updates: prefer Linear/Notion connectors if available.
+- Browser/runtime verification: prefer Playwright/browser tools if available.
+
+## Collaboration policy
+
+Prefer multi-agent mode across the workflow:
+
+1) Split independent subtasks early when they can run in parallel.
+2) Keep the main agent on the critical path: task framing, design decisions, integration, and final quality gates.
+3) Use side agents for bounded work such as research, code slices, documentation updates, regression checks, or review passes.
+4) Do not delegate a blocking architectural decision without keeping one agent responsible for final integration and correctness.
+
 ## Entry
 
 1) Install skill files into target repo:
@@ -36,24 +64,25 @@ pip install pyyaml requests
 
 Fill only:
 
-- `ENGINEERING.md` frontmatter
+- `docs/ENGINEERING.md` frontmatter
 
 This contains all manual fields:
 - `commands.*`
-- `deployment.*`
+- `runtime.*`
 - `docs.*`
 
 Do not duplicate config in other md/yaml files.
 
 ## Execution order
 
-1) `ENGINEERING.md`
+1) `docs/ENGINEERING.md`
 2) `docs/tasks/taskbook.md`
 3) `docs/design/**`
 4) implementation
 5) run gates via `python3 scripts/autopipeline/ap.py`
-6) update API docs + regression matrix + bug list + summary
-7) commit/push
+6) start and validate local Docker runtime
+7) update API docs + regression matrix + bug list + summary
+8) commit/push
 
 ## Commands
 

package/cli/assets/skill/data/templates/ENGINEERING.md

@@ -12,19 +12,16 @@ commands:
   smoke: ""
   regression: ""
 
-deployment:
-  host: ""
-  ssh_port: 22
-  username: ""
-  password: ""
-  service_name: ""
-  systemd_dir: "/usr/lib/systemd/system"
-  remote_app_root: ""
-  remote_jar_path: ""
-  remote_config_dir: ""
-  remote_bin_dir: ""
+runtime:
+  docker_compose_file: ""
+  docker_service: ""
+  container_name: ""
+  image: ""
+  app_port: ""
   health_base_url: ""
   health_path: ""
+  env_file: ""
+  startup_timeout_sec: 60
 
 docs:
   taskbook: "docs/tasks/taskbook.md"
@@ -37,12 +34,12 @@ docs:
   summary_dir: "docs/tasks/summaries"
 ---
 
-# ENGINEERING.md — AutoPipeline Gates (Source of Truth)
+# docs/ENGINEERING.md — AutoPipeline Gates (Source of Truth)
 
 目标：把一次任务固化为不可跳过的流水线：  
 读任务 → 写DD → 实现 → 本地测试通过 → 静态分析+Review落盘 → 更新API Markdown+接口变更清单 →  
-部署(systemd/jar) → 重启验证 → 按API Markdown全量回归 + 回归矩阵0fail →  
-记录Bug并新增自动化回归 → 任务总结落盘 → commit → push
+本地 Docker 启动验证 → 健康检查 → 按 API Markdown 对本地环境全量回归 + 回归矩阵 0 fail →  
+记录 Bug 并新增自动化回归 → 任务总结落盘 → commit → push
 
 规则：任一步骤失败或缺产物，禁止进入下一步；未 push 视为任务未完成，禁止开始下一个任务/子任务。
 
@@ -50,14 +47,14 @@ docs:
 
 ## 0. 配置填写（必须）
 
-先填写本文件 frontmatter 中的所有空值（例如 ip/用户名/密码/服务名/路径/命令）。  
+先填写 `docs/ENGINEERING.md` frontmatter 中的所有空值（例如 Docker 文件、服务名、容器名、健康检查地址、命令）。  
 禁止在其他 md/yaml 重复维护这些配置。
 
 ---
 
 ## 1. 权威输入与冲突裁决（优先级）
 
-1) ENGINEERING.md（本文件）  
+1) docs/ENGINEERING.md（本文件）  
 2) docs/tasks/taskbook.md  
 3) docs/design/**  
 4) docs/interfaces/api.md  
@@ -70,6 +67,36 @@ docs:
 
 ---
 
+## 1.5 工具使用策略（Claude / Codex 专属）
+
+优先使用当前环境已安装、已授权、已可访问的工具能力：
+
+1) MCP servers  
+2) 已安装 skills  
+3) plugins / apps / connectors  
+4) shell / 手工实现
+
+规则：
+- 做设计、查资料、看文档、看页面、查知识库、写回外部系统时，优先调用现有 MCP / skills / plugins / apps。
+- 能用权威工具直接完成时，不重复手写中间数据。
+- 工具不可用、无权限、结果不可靠时，才回退到本地命令或手工处理。
+- 选择工具时优先“已安装且当前项目可直接使用”的能力，而不是重新造流程。
+
+---
+
+## 1.6 多 Agent 协作策略（Claude / Codex 专属）
+
+整个流程尽可能使用多 agent 模式并行推进。
+
+规则：
+- 任务开始后，优先拆分为可并行的子任务：设计补充、资料检索、实现分块、测试验证、文档回写、review。
+- 主 agent 负责关键路径：任务定义、方案裁决、代码集成、质量门禁、最终交付。
+- 子 agent 负责边界清晰、可独立推进的工作，完成后回收结果给主 agent 集成。
+- 如果某项工作会直接阻塞主路径且难以独立定义，不要机械拆分；由主 agent 保持控制。
+- 能并行就不要串行；能拆独立 write scope 就不要让多个 agent 写同一块内容。
+
+---
+
 ## 2. Gate 流水线（强制、不可跳过）
 
 Gate-1 读任务：只从 taskbook 取范围与验收；缺信息先补 taskbook  
@@ -78,9 +105,9 @@ Gate-3 实现：严格按DD；接口变更必须同步 API Markdown
 Gate-4 本地CI：必须通过（commands.build / commands.test）  
 Gate-5 静态分析+Review：静态分析通过；docs/reviews/ 生成记录  
 Gate-6 文档：更新 api.md + 追加 api-change-log.md  
-Gate-7 部署：单机 systemd/jar；service目录固定 /usr/lib/systemd/system；失败自动回滚  
-Gate-8 重启+健康：restart后必须健康检查通过  
-Gate-9 全量回归：按 API Markdown 全量回归；回归矩阵全量 PASS（0 fail）；发现问题必须写 bug-list 并新增自动化回归用例  
+Gate-7 本地运行：必须在本地 Docker 环境启动目标服务；失败先修复再继续  
+Gate-8 健康检查：本地容器启动后必须健康检查通过  
+Gate-9 全量回归：按 API Markdown 对本地环境全量回归；回归矩阵全量 PASS（0 fail）；发现问题必须写 bug-list 并新增自动化回归用例  
 Gate-10 任务总结：必须生成 docs/tasks/summaries/<TASK_ID>.md  
 Gate-11 完成：全门禁通过后必须 commit+push
 

package/cli/assets/skill/data/templates/bridges/CLAUDE.md

@@ -1 +1,3 @@
-Follow ENGINEERING.md strictly. Source of truth: ENGINEERING.md.
+Follow docs/ENGINEERING.md strictly. Source of truth: docs/ENGINEERING.md.
+Prefer already available MCP servers, installed skills, plugins, and app connectors during design, research, verification, and documentation workflows.
+Prefer multi-agent mode whenever the task can be split into independent parallel subtasks without weakening integration control.

package/cli/assets/skill/data/templates/bridges/CODEX.md

@@ -1 +1,3 @@
-Follow ENGINEERING.md strictly. Source of truth: ENGINEERING.md.
+Follow docs/ENGINEERING.md strictly. Source of truth: docs/ENGINEERING.md.
+Prefer already available MCP servers, installed skills, plugins, and app connectors during design, research, verification, and documentation workflows.
+Prefer multi-agent mode whenever the task can be split into independent parallel subtasks without weakening integration control.

package/cli/assets/skill/data/templates/docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md

@@ -1,13 +1,14 @@
-# Deploy Record — <Task ID> — YYYY-MM-DD
+# Local Runtime Record — <Task ID> — YYYY-MM-DD
 
-- Target host:
-- Service name:
-- Artifact (local):
-- Remote jar path:
-- Updated items: jar / config / bin / service
-- Backup files (single latest): *.bak / *.tgz.bak
+- Docker compose file:
+- Docker service:
+- Container name:
+- Image/tag:
+- Exposed port:
+- Env file:
 
 ## Evidence
-- systemctl status:
+- docker ps / compose ps:
 - smoke_test:
 - api_regression:
+- health_check:

package/cli/assets/skill/data/templates/docs/deployment/deploy-runbook.md

@@ -1,12 +1,12 @@
-# Deploy Runbook（单机 systemd / jar）
+# Local Runtime Runbook（本地 Docker 验证）
 
-部署参数统一读取：`ENGINEERING.md` frontmatter
-- deployment.host / deployment.ssh_port / deployment.username / deployment.password
-- deployment.service_name / deployment.systemd_dir
-- deployment.remote_app_root / deployment.remote_jar_path / deployment.remote_config_dir / deployment.remote_bin_dir
-- deployment.health_base_url / deployment.health_path
+运行参数统一读取：`docs/ENGINEERING.md` frontmatter
+- runtime.docker_compose_file / runtime.docker_service
+- runtime.container_name / runtime.image / runtime.app_port
+- runtime.health_base_url / runtime.health_path
+- runtime.env_file / runtime.startup_timeout_sec
 
-部署后必须：
+本地 Docker 启动后必须：
 - smoke-test
 - api-regression
 - 回归矩阵全量 PASS（0 fail）

package/cli/assets/skill/data/templates/docs/reviews/_TEMPLATE-REVIEW.md

@@ -1,7 +1,7 @@
 # Review — <Task ID> — YYYY-MM-DD HH:MM
 
 ## 1. 静态分析结果（必须）
-- Command：lint + typecheck（来自 ENGINEERING.md frontmatter）
+- Command：lint + typecheck（来自 docs/ENGINEERING.md frontmatter）
 - Summary：
 - Issues：
 - Resolved/Deferred（deferred 必须给出后续任务）：

package/cli/assets/skill/data/templates/docs/tasks/summaries/_TEMPLATE-TASK-SUMMARY.md

@@ -11,7 +11,7 @@
 - 目标：
 - 验收结论：PASS / FAIL（FAIL 必须说明原因与后续计划）
 
-## 2. 变更概览（代码/配置/部署）
+## 2. 变更概览（代码/配置/本地运行）
 - 关键改动点：
 - 影响模块：
 - 兼容性影响（是否破坏兼容、迁移方案）：
@@ -28,7 +28,7 @@
 - 回滚方式：
 
 ## 5. 质量门禁证据（必须可追溯）
-- 项目配置：`ENGINEERING.md`（frontmatter）
+- 项目配置：`docs/ENGINEERING.md`（frontmatter）
 - 本地CI：`ci-local`
 - 静态分析：`static`
 - Review 文档：`docs/reviews/<TASK_ID>-<timestamp>.md`
@@ -39,9 +39,9 @@
 - 新增/确认的 Bug（写入 `docs/bugs/bug-list.md`）：
 - 新增自动化回归用例（引用回归矩阵ID）：
 
-## 7. 部署记录（如有部署）
-- 部署记录：`docs/deployment/deploy-records/<TASK_ID>-YYYYMMDD.md`
-- systemd/service/config/bin 变更（若有）：
+## 7. 本地运行记录（如有）
+- 本地运行记录：`docs/deployment/deploy-records/<TASK_ID>-YYYYMMDD.md`
+- Docker compose/service/image/env 变更（若有）：
 
 ## 8. 风险与回滚
 - 风险：

package/cli/assets/skill/data/templates/docs/tasks/taskbook.md

@@ -2,13 +2,13 @@
 
 规则：
 1) 所有任务都写在本文件（持续续写，不另起任务文件）
-2) 允许拆子任务：每个子任务也必须走全流程（DD→实现→测试→review→接口文档→部署→回归→总结→commit→push）
+2) 允许拆子任务：每个子任务也必须走全流程（DD→实现→测试→review→接口文档→本地 Docker 验证→回归→总结→commit→push）
 3) 每个任务必须有明确验收与证据（日志/报告/文件路径）
 
 ---
 
 ## Task T0001 — <Title>
-- 状态：Planned | Designing | Implementing | Testing | Reviewing | Deploying | Done
+- 状态：Planned | Designing | Implementing | Testing | Reviewing | Runtime Verifying | Done
 - 范围（In scope）：
 - 非目标（Out of scope）：
 - 验收标准（必须可执行）：
@@ -18,13 +18,13 @@
   - [ ] T0001-2 <subtask>
 
 ### 证据（完成后填写）
-- 项目配置：`ENGINEERING.md`（frontmatter）
+- 项目配置：`docs/ENGINEERING.md`（frontmatter）
 - DD：`docs/design/T0001-<slug>.md`
 - Review：`docs/reviews/T0001-YYYYMMDD-HHMM.md`
 - API 文档：`docs/interfaces/api.md`
 - API Change Log：`docs/interfaces/api-change-log.md`
 - 本地CI：粘贴摘要或给出文件路径
-- 部署记录（如部署）：`docs/deployment/deploy-records/T0001-YYYYMMDD.md`
+- 本地运行记录：`docs/deployment/deploy-records/T0001-YYYYMMDD.md`
 - 回归矩阵：`docs/testing/regression-matrix.md`（全量PASS）
 - Bug清单（如有）：`docs/bugs/bug-list.md`
 - 任务总结（强制）：`docs/tasks/summaries/T0001.md`

package/cli/assets/skill/data/templates/docs/testing/regression-matrix.md

@@ -1,5 +1,5 @@
-# Regression Matrix（回归矩阵：必须全量 PASS，0 fail）
+# Regression Matrix（本地环境回归矩阵：必须全量 PASS，0 fail）
 
 | ID | Area | Endpoint/Feature | Test Type | Steps / Command | Expected | Status(PASS/FAIL) | Evidence |
 |---|---|---|---|---|---|---|---|
-| R-001 | API | GET /health | smoke | commands.smoke | 200 OK | PASS | <paste log path> |
+| R-001 | API | GET /health | smoke | commands.smoke | local 200 OK | PASS | <paste log path> |

package/cli/assets/skill/scripts/ap.py

@@ -21,7 +21,7 @@ def cmd_install(args: argparse.Namespace) -> None:
     templates = _skill_root() / "data" / "templates"
 
     copy_tree(templates / "docs", repo / "docs")
-    copy_tree(templates / "ENGINEERING.md", repo / "ENGINEERING.md")
+    copy_tree(templates / "ENGINEERING.md", repo / "docs" / "ENGINEERING.md")
 
     if args.bridges:
         copy_tree(templates / "bridges", repo)
@@ -32,7 +32,7 @@ def cmd_install(args: argparse.Namespace) -> None:
     copy_tree(Path(__file__).resolve().parent / "core.py", scripts_dir / "core.py")
 
     gi = repo / ".gitignore"
-    secret_line = "ENGINEERING.md"
+    secret_line = "docs/ENGINEERING.md"
     if gi.exists():
         txt = gi.read_text(encoding="utf-8")
         if secret_line not in txt:
@@ -41,7 +41,7 @@ def cmd_install(args: argparse.Namespace) -> None:
         gi.write_text(secret_line + "\n", encoding="utf-8")
 
     print(f"[install] OK: scaffold installed into {repo}")
-    print("[install] Next: edit ENGINEERING.md frontmatter and fill all project/env fields")
+    print("[install] Next: edit docs/ENGINEERING.md frontmatter and fill all project/env fields")
 
 
 def _infer_title(taskbook: Path, task_id: str) -> str:
@@ -92,7 +92,7 @@ def cmd_gen_summary(args: argparse.Namespace) -> None:
 - 目标：TODO
 - 验收结论：PASS / FAIL — TODO
 
-## 2. 变更概览（代码/配置/部署）
+## 2. 变更概览（代码/配置/本地运行）
 ### Git change snapshot
 - Staged files:
 {('- ' + staged.replace('\n','\n- ')) if staged else '- (none)'}
@@ -164,7 +164,7 @@ def cmd_run(args: argparse.Namespace) -> None:
     """
     Run a configured gate command:
       build | test | lint | typecheck | format | smoke | regression
-    Commands are read from ENGINEERING.md frontmatter.
+    Commands are read from docs/ENGINEERING.md frontmatter.
     """
     repo = Path(args.repo).resolve()
     cfg = _load_cfg(repo)
@@ -173,7 +173,7 @@ def cmd_run(args: argparse.Namespace) -> None:
     if name not in commands:
         raise APError(
             f"Command not configured: commands.{name}. "
-            "Edit ENGINEERING.md frontmatter. "
+            "Edit docs/ENGINEERING.md frontmatter. "
             f"Available: {', '.join(commands.keys()) or '(none)'}"
         )
     cmd = str(commands[name])

package/cli/assets/skill/scripts/core.py

@@ -97,14 +97,14 @@ def http_get_status(url: str, timeout_s: int = 5) -> int:
 def find_config(repo: Path) -> Path:
     """Find single source project config file."""
     candidates = [
-        repo / "ENGINEERING.md",
+        repo / "docs" / "ENGINEERING.md",
     ]
     for c in candidates:
         if c.exists():
             return c
     raise APError(
-        "Project config not found. Create ENGINEERING.md "
-        "and put commands + deployment fields in YAML frontmatter."
+        "Project config not found. Create docs/ENGINEERING.md "
+        "and put commands + runtime fields in YAML frontmatter."
     )
 
 

package/cli/src/index.js

@@ -64,7 +64,7 @@ function resolveTargetDir(ai, mode, destOverride){
 
 function ensureGitignore(projectDir){
   const gi = path.join(projectDir, ".gitignore");
-  const line = "ENGINEERING.md";
+  const line = "docs/ENGINEERING.md";
   if (!exists(gi)) {
     fs.writeFileSync(gi, `${line}\n`, "utf-8");
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elvis1513/auto-coding-skill",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI installer for auto-coding-skill (Claude Code + Codex CLI).",
   "type": "module",
   "bin": {
@@ -29,7 +29,8 @@
     "engineering",
     "workflow",
     "ci",
-    "deployment"
+    "docker",
+    "local-testing"
   ],
   "repository": {
     "type": "git",